Skills fb-page-poster

Name: fb-page-poster
Author: openclaw

Publish posts to a Facebook Page via the Meta Graph API. Use when the user says "post to Facebook", "FB post", "粉專發文", "社群貼文", "幫我發文", "schedule post", "排程發文", or provides content and says "post this" or "publish this". Supports text-only, image, link-in-comment, scheduled posts, and multilingual translation (ZH↔EN) with a review step before publishing.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/aaazzzr/fb-page-manager" ~/.claude/skills/openclaw-skills-fb-page-poster && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/aaazzzr/fb-page-manager" ~/.openclaw/skills/openclaw-skills-fb-page-poster && rm -rf "$T"

manifest: skills/aaazzzr/fb-page-manager/SKILL.md

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