OpenClaw 的 Facebook Manager v2

作者：Pham Triet
社区：OpenClaw Việt Nam

一套完整的 Facebook 管理能力 — 支持 两种 Token 模式：

应选择哪种模式？

→ 请参考 references/setup-guide.md 获取分步指南，了解如何获取 Token。

对比：Page Token 与 User Token 的权限差异

OpenClaw 配置

{
  "skills": {
    "entries": {
      "facebook-manager": {
        "env": {
          "FACEBOOK_PAGE_ID": "123456789012345",
          "FACEBOOK_PAGE_TOKEN": "EAAG...page_token_vinh_vien...ZD",
          "FACEBOOK_USER_TOKEN": "EAAG...user_token_60_ngay...ZD"
        }
      }
    }
  }
}

仅需填写实际使用的 Token —— 二者非必需同时配置。

模式 1：Fanpage 管理（Page Token）

发布内容

# 纯文本帖
curl -X POST "https://graph.facebook.com/v22.0/$FACEBOOK_PAGE_ID/feed" 
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN" 
  -d "message=Post content"

# 图片帖
curl -X POST "https://graph.facebook.com/v22.0/$FACEBOOK_PAGE_ID/photos" 
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN" 
  -F "url=https://example.com/image.jpg" 
  -F "caption=Caption with image"

# 链接帖
curl -X POST "https://graph.facebook.com/v22.0/$FACEBOOK_PAGE_ID/feed" 
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN" 
  -d "message=Learn more here" -d "link=https://example.com"

回复评论

# 获取评论列表
curl "https://graph.facebook.com/v22.0/{post_id}/comments?fields=from,message,created_time" 
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN"

# 回复某条评论
curl -X POST "https://graph.facebook.com/v22.0/{comment_id}/comments" 
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN" 
  -d "message=Thank you for your interest!"

通过 Messenger 自动回复

# 发送消息
curl -X POST "https://graph.facebook.com/v22.0/$FACEBOOK_PAGE_ID/messages" 
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"recipient":{"id":"USER_PSID"},"message":{"text":"Hello!"}}'

# 获取会话列表
curl "https://graph.facebook.com/v22.0/$FACEBOOK_PAGE_ID/conversations?
fields=participants,messages{message,from,created_time}&limit=10" 
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN"

查看 Insights 数据

curl "https://graph.facebook.com/v22.0/$FACEBOOK_PAGE_ID/insights?
metric=page_impressions,page_engaged_users,page_fans&period=day" 
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN"

模式 2：搜索与群组操作（User Token）

搜索 Facebook 群组

# 按关键词搜索群组
curl "https://graph.facebook.com/v22.0/search?q=BDS+Da+Lat&type=group&limit=10" 
  -H "Authorization: Bearer $FACEBOOK_USER_TOKEN"

# 列出已加入的群组
curl "https://graph.facebook.com/v22.0/me/groups?fields=name,member_count,privacy&limit=20" 
  -H "Authorization: Bearer $FACEBOOK_USER_TOKEN"

读取群组中的帖子（须为该群组成员）

# 获取某群组的最新帖子
curl "https://graph.facebook.com/v22.0/{group_id}/feed?
fields=message,from,created_time,attachments&limit=20" 
  -H "Authorization: Bearer $FACEBOOK_USER_TOKEN"

发现其他 Pages / Fanpages

# 按关键词搜索 Pages
curl "https://graph.facebook.com/v22.0/search?q=BDS+Da+Lat&type=page&limit=10&
fields=name,fan_count,category,link" 
  -H "Authorization: Bearer $FACEBOOK_USER_TOKEN"

# 获取某 Page 的公开帖子
curl "https://graph.facebook.com/v22.0/{page_id}/posts?
fields=message,created_time,likes.summary(true)&limit=10" 
  -H "Authorization: Bearer $FACEBOOK_USER_TOKEN"

搜索公开帖子

# 按关键词搜索公开帖子（受 Meta 政策限制）
curl "https://graph.facebook.com/v22.0/search?q=cho+thue+phong+Da+Lat&type=post&limit=10" 
  -H "Authorization: Bearer $FACEBOOK_USER_TOKEN"

⚠️ 自 2018 年起，Facebook 已大幅限制 Search API。若遇到错误 (#11) Search is not supported，请改用替代方案：先搜索群组 → 再从这些群组中拉取帖子 → 最后按内容筛选。

实际案例：在 Đà Lạt 寻找出租房源

步骤 1：搜索 Đà Lạt 房地产相关群组  
  → search?q=BDS+cho+thue+Da+Lat&type=group

步骤 2：拉取该群组近期发布的帖子  
  → {group_id}/feed?fields=message,created_time&limit=20

步骤 3：AI 过滤相关帖子（含租赁信息、价格、位置等）  
  → Agent 分析内容并为用户生成摘要

所需权限

Page Token（Fanpage 管理）所需权限

pages_show_list           ← 查看 Pages 列表
pages_messaging           ← 发送/接收 Messenger 消息
pages_manage_metadata     ← 管理 Page 元数据
pages_manage_posts        ← 创建/删除帖子
pages_read_engagement     ← 读取点赞、评论、转发等互动数据
pages_read_user_content   ← 读取 Page 上的用户生成内容
pages_manage_engagement   ← 回复评论、点赞评论

User Token（搜索与群组）所需权限

public_profile            ← 默认权限（始终授予）
user_posts                ← 读取用户自己的帖子
groups_access_member_info ← 读取群组信息及群组内帖子
pages_show_list           ← 发现 Pages

重要说明

个人资料页不支持通过 API 发布内容

Facebook 已于 2018 年移除了 publish_actions 权限。
无法通过 API 向个人时间线（Timeline）发布内容。
仅能向 Fanpages 发布内容（需使用 Page Token）。

User Token 有效期为 60 天

需定期刷新。详见 references/setup-guide.md 中的 “Refresh User Token” 小节。

调用频率限制（Rate Limits）

• Page Token：约 200 次请求/小时
• User Token：约 200 次请求/小时
• 如触发限流：请降低请求频率、使用批量请求（batch requests）、缓存响应结果

应用模式（App Mode）

应用必须处于 Live 模式，才能供管理员和测试人员以外的用户正常使用。
在 Development 模式下，仅管理员与测试人员可访问。

目录结构

facebook-manager/
├── SKILL.md                    ← 本文件
├── references/
│   ├── setup-guide.md          ← 获取两种 Token 的完整指南
│   └── api-reference.md        ← 所有 API 接口的完整清单
└── scripts/
    └── check-connection.sh     ← 连通性检测脚本（支持 Page 和 User Token）