OpenClaw 的 Facebook 粉丝专页管理技能

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

全面的 Facebook 粉丝专页管理能力：发布动态、回复评论、自动回复 Messenger 消息。 包含从零开始获取访问令牌（Access Token）的完整指南。

目录

1. 获取 Page ID 与 Access Token 指南（必读）
2. OpenClaw 配置
3. 发布粉丝专页动态
4. 回复评论
5. 自动回复 Messenger 消息
6. 查看 Insights 数据

→ 请阅读 references/setup-guide.md 查看含截图的详细分步操作指南。 → 请阅读 references/api-reference.md 查看完整的 API 接口列表。

1. 获取 Page ID 与 Access Token 指南

这是最关键步骤 —— 若无有效 token，该技能将无法运行。

→ 完整操作流程详见 references/setup-guide.md

快速摘要：共 4 步

Bước 1: 创建 Meta for Developers 账户  
         → developers.facebook.com → Get Started  

Bước 2: 创建 App  
         → developers.facebook.com/apps → 创建应用  
         → 选择 “Tương tác với khách hàng trên Messenger”（通过 Messenger 与客户互动）  

Bước 3: 获取 Page ID 和短期（Short-lived）Access Token  
         → developers.facebook.com/tools/explorer/  
         → 选择你的 App → 添加所需权限 → Generate Access Token  
         → 查询 "me/accounts" → 获取响应中的 "id"（即 Page ID）和 "access_token"  

Bước 4: 将短期 Token 换为长期（Permanent）Token  
         → 从 App Settings → Basic 中获取 App ID 和 App Secret  
         → 使用 Graph API 调用换 token 接口（详见 setup-guide.md）

2. OpenClaw 配置

在获得 Page ID 和长期 Token 后，请将其配置至 ~/.openclaw/openclaw.json：

{
  "skills": {
    "entries": {
      "facebook-fanpage-manager": {
        "env": {
          "FACEBOOK_PAGE_ID": "123456789012345",
          "FACEBOOK_ACCESS_TOKEN": "EAAG...your_permanent_page_token..."
        }
      }
    }
  }
}

验证连接是否成功：

curl "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID?fields=name,followers_count" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"

若返回粉丝专页名称及关注人数，则表示连接成功。

3. 发布粉丝专页动态

发布纯文字动态

curl -X POST "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/feed" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
  -d "message=动态正文内容"

发布带图片的动态

curl -X POST "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/photos" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
  -F "url=https://example.com/image.jpg" \
  -F "caption=配图说明文字"

发布带链接的动态

curl -X POST "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/feed" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
  -d "message=点击此处查看详情" \
  -d "link=https://example.com"

获取已发布动态列表

curl "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/posts?fields=message,created_time,shares,likes.summary(true),comments.summary(true)&limit=10" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"

4. 回复评论

获取某条动态下的所有评论

curl "https://graph.facebook.com/v21.0/{post_id}/comments?fields=from,message,created_time" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"

回复某条评论

curl -X POST "https://graph.facebook.com/v21.0/{comment_id}/comments" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
  -d "message=感谢您的关注！"

自动回复评论流程（由 AI 生成回复内容）

1. 获取最新发布的动态列表
2. 筛选出尚未回复的评论
3. 使用 AI 分析评论内容语义
4. 生成恰当的回复文本
5. 调用 Facebook Graph API 发送回复

5. 自动回复 Messenger 消息

向用户发送消息

curl -X POST "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/messages" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {"id": "USER_PSID"},
    "message": {"text": "您好！感谢您的留言。"}
  }'

获取会话列表（Conversations）

curl "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/conversations?fields=participants,messages{message,from,created_time}&limit=10" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"

Messenger Webhook（实时自动回复）

如需实时接收新消息，必须配置 Webhook。具体设置方法详见 references/setup-guide.md 中的 “Setup Webhook” 章节。

注意：Webhook 需依赖持续运行的服务端（例如 VPS、ngrok 或 Cloudflare Tunnel）。 若暂无可用服务端，仍可采用轮询（polling）方式定期拉取消息。

轮询方式（无需 Webhook）

# 每 30 秒拉取一次新消息
curl "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/conversations?fields=messages.limit(1){message,from,created_time}&limit=5" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"

轮询处理流程如下：

1. 每隔 30–60 秒，拉取最新的会话列表
2. 检查其中是否存在未回复的消息
3. 调用 AI 生成合适的回复内容
4. 通过 Send API 发送回复

6. 查看 Insights 数据

粉丝专页整体数据统计

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

单条动态数据统计

curl "https://graph.facebook.com/v21.0/{post_id}/insights?metric=post_impressions,post_engaged_users,post_clicks" \
  -H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"

重要注意事项

• 长期 Token 仍可能过期：当发生以下任一情况时，Token 将失效 —— 修改 Facebook 密码、撤销 App 权限、或 App 被禁用。此时需重新生成新 Token。
• 调用频率限制（Rate Limit）：Facebook 默认限制约 200 次请求/小时，请避免高频调用 API。
• 必需权限（Required Permissions）：pages_show_list、pages_messaging、pages_manage_metadata、pages_manage_posts、pages_read_engagement。
• App 运行模式：App 必须处于 Live 模式（而非 Development 模式），才能对其他用户生效。

技能目录结构

facebook-fanpage-manager/
├── SKILL.md                    ← 当前文件
├── references/
│   ├── setup-guide.md          ← 分步图文详解的 Token 获取指南
│   └── api-reference.md        ← 所有可用 API 接口列表
└── scripts/
    └── check-connection.sh     ← 用于验证 Facebook 连接状态的脚本