openclaw-meta-bridge

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:

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

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.