---
license: mit
tags:
  - openclaw
  - sidecar
  - meta
  - fastapi
---

# OpenClaw Meta Bridge

FastAPI sidecar for Meta Page and Messenger workflows. It normalizes Meta webhooks, stores inbound events and drafts, exposes approval-gated tools, and keeps public sends behind explicit human approval.

## Features

- Meta webhook verification and signature validation.
- Configurable Page contexts through environment variables.
- Draft creation for Messenger, comments, Page posts, and Reels.
- Validation-only lanes for Page posts and Reels.
- Read-only Page operations endpoints for posts, media, insights, settings, conversations, and comment threads.
- SQLite-backed audit log and draft lifecycle.

## Configuration

Copy `.env.example` to `.env` and fill in real values. Keep `.env` private.

Page contexts are configured with `META_PAGE_CONTEXTS`, then per-page env vars:

```bash
META_PAGE_CONTEXTS=healthcare,civic
META_PAGE_ID_HEALTHCARE=...
META_PAGE_TOKEN_HEALTHCARE=...
META_PAGE_NAME_HEALTHCARE="Example Health Services"
```

The public repo intentionally uses generic sample contexts. Rename contexts and risk rules for your own deployment.

## Local Development

```bash
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
pytest
uvicorn app.main:app --reload --port 8090
```

## Safety Notes

- Do not commit `.env`, database files, webhook payload archives, logs, Page tokens, Page IDs from private deployments, or screenshots containing private conversations.
- Publishing endpoints require `approved_by`; validation-only mode is available for dry runs.
- Unknown Page IDs fail closed.