| --- |
| 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. |
|
|
