openclaw/fb-page-poster

Facebook Page Poster

Publish content to a Facebook Page through the Meta Graph API.

Environment Variables

| Variable | Purpose | |---|---| | LONG_META_page_TOKEN | Long-lived Page Access Token with pages_manage_posts and pages_read_engagement permissions | | META_PAGE_ID | Numeric Page ID | | META_APP_SECRET | Meta App Secret for appsecret_proof |

If any are missing, walk the user through {baseDir}/references/token-setup-guide.md.

Workflow

1. Parse the request

Extract from the user message:

• Content: the text to post
• Language direction: ZH→EN, EN→ZH, ZH→ZH, or EN→EN
• Post type: text | image | link-in-comment | scheduled (combinable)
• Tone: infer automatically — marketing/social (upbeat, CTA) for promotions and events; formal/professional for announcements and corporate. Ask if ambiguous.
• Image: local file path or URL (if applicable)
• Schedule: ISO 8601 timestamp (if applicable)
• Link: URL for the first comment (if applicable)

2. Draft and translate — always preview first

Never publish without user confirmation.

If source language differs from target, translate with these rules:

• Preserve meaning, intent, hashtags
• Adapt idioms naturally, do not translate literally
• Keep brand names and proper nouns in original form
• Maintain emoji usage unless unnatural in target language

Present preview:

📋 Post Preview
─────────────────
[Post text here]

🔗 First comment: [URL or N/A]
🖼️ Image: [filename/URL or N/A]
⏰ Schedule: [time or "Publish immediately"]
─────────────────
Confirm? (yes / edit / cancel)

3. Publish

Run the script at {baseDir}/scripts/fb-post.js:

# Text-only
node {baseDir}/scripts/fb-post.js --type text --message "content"

# Image (file)
node {baseDir}/scripts/fb-post.js --type image --message "content" --image-file /path/to/img.jpg

# Image (URL)
node {baseDir}/scripts/fb-post.js --type image --message "content" --image-url "https://..."

# Link in first comment
node {baseDir}/scripts/fb-post.js --type text --message "content" --comment-link "https://..."

# Scheduled (append to any above)
node {baseDir}/scripts/fb-post.js --type text --message "content" --schedule "2025-12-25T10:00:00+0800"

Flags are combinable. Example — image + comment link + scheduled:

node {baseDir}/scripts/fb-post.js --type image --message "content" --image-url "https://..." --comment-link "https://..." --schedule "2025-12-25T10:00:00+0800"

4. Report result

• Show the post ID
• Confirm comment was posted (if link-in-comment)
• Confirm scheduled time (if scheduled)
• On error, show the message and suggest a fix

Error reference

| Error | Likely cause | Fix | |---|---|---| | OAuthException / Invalid token | Token expired | Refresh via {baseDir}/references/token-setup-guide.md | | Permission denied | Missing pages_manage_posts | Re-authorize token with correct scopes | | Scheduled time in past | Must be ≥10 min in the future | Adjust the timestamp | | Image too large | >10 MB | Compress or resize | | Rate limit | Too many requests | Wait a few minutes, retry |