facebook-publish - SKILL.md Agent Skill

name: facebook-publish description: Publish posts, videos, and reels to Facebook via Meta Graph API v23.0. Supports feed posts, video posts, photo posts, reels, and stories. Requires Meta OAuth2 page access token. metadata: openclaw: emoji: 📘 requires: bins: - python3

Facebook 发布（facebook-publish）

通过 Meta Graph API v23.0 发布内容到 Facebook，支持帖子、视频、Reels 和 Stories。使用 Meta OAuth2 Page Access Token 认证。

前置条件

Meta Developer Portal 创建应用，获取 App ID / App Secret
申请 pages_manage_posts 和 pages_read_engagement 权限
获取长效 Page Access Token

配置

保存到 ~/.openclaw/credentials/facebook_config.json：

{
  "app_id": "your_app_id",
  "app_secret": "your_app_secret",
  "page_access_token": "your_long_lived_page_token",
  "page_id": "your_page_id"
}

使用方式

文字帖子：

python3 ./skills/facebook-publish/scripts/publish_facebook.py \
  --message "帖子内容" \
  --mode feed

视频/Reel：

python3 ./skills/facebook-publish/scripts/publish_facebook.py \
  --message "描述" \
  --video video.mp4 \
  --mode reel

图片帖子：

python3 ./skills/facebook-publish/scripts/publish_facebook.py \
  --message "描述" \
  --images img1.jpg img2.jpg \
  --mode feed

参数说明

参数	必填	说明
`--message`	是	帖子内容
`--mode`	是	`feed`/`video`/`reel`/`story`
`--video`	视频模式必填	视频文件路径
`--images`	图片模式必填	图片路径列表
`--title`	否	视频标题（video 模式）

Agent 工作流

检查 Facebook 配置是否存在
准备内容 + 媒体文件
运行 publish_facebook.py 脚本
检查 stdout JSON 输出：
- {"ok": true, "post_id": "xxx", "url": "https://facebook.com/xxx"} → 成功
- {"ok": false, "error": "AUTH_REQUIRED"} → 更新 Page Token
- {"ok": false, "error": "..."} → 其他错误

错误处理

错误	原因	处理
AUTH_REQUIRED	Token 失效	更新 Page Access Token
UPLOAD_FAILED	上传失败	检查文件格式，重试
MEDIA_PROCESSING	视频处理中	轮询状态等待完成
RATE_LIMIT	频率限制	等待后重试

发布记录（强制）

发布成功后，必须立即调用 published-track 技能记录发布信息：

./skills/published-track/scripts/record.sh \
  --platform facebook \
  --title "标题" \
  --content-type post \
  --source-folder "<原始文件夹路径>" \
  --publish-url "<发布URL>" \
  --publish-date "$(date +%Y-%m-%d)"

--source-folder 为原始内容所在的相对路径（如 output_articles/xxx 或 output_videos/xxx）。 --publish-url 为发布后获得的 URL，若发布失败则留空并在 --notes 中注明原因。

执行 ./skills/published-track/scripts/init-db.sh（幂等，重复执行无副作用）。