Facebook Manager v2 cho OpenClaw
Author: Pham Triet
Cộng đồng: OpenClaw Việt Nam
Skill quản lý Facebook toàn diện — hỗ trợ 2 chế độ token:
Chọn chế độ nào?
| Nhu cầu | Chế độ | Token |
|---|
| Quản lý Fanpage (đăng bài, reply, Messenger, insights) | Page | Page Access Token (vĩnh viễn) |
| Tìm nhóm, đọc bài nhóm, tìm trang khác, search bài viết |
User | User Access Token (~60 ngày) |
| Cả hai |
Cả hai | Cấu hình 2 token riêng |
→ Đọc references/setup-guide.md để lấy token từng bước.
So sánh quyền Page Token vs User Token
| Tính năng | Page Token | User Token |
|---|
| Đăng bài Fanpage | ✅ | ✅ (nếu là admin) |
| Reply comment trên Fanpage |
✅ | ✅ |
| Gửi tin nhắn Messenger | ✅ | ❌ |
| Xem Insights Fanpage | ✅ | ❌ |
| Tìm nhóm Facebook | ❌ | ✅ |
| Đọc bài trong nhóm (là thành viên) | ❌ | ✅ |
| Tìm trang/Fanpage khác | ❌ | ✅ |
| Tìm kiếm bài viết công khai | ❌ | ✅ (hạn chế) |
| Đọc thông tin cá nhân | ❌ | ✅ |
| Hết hạn | Vĩnh viễn | ~60 ngày |
Cấu hình OpenClaw
CODEBLOCK0
Chỉ cần token nào bạn dùng — không bắt buộc cả hai.
CHẾ ĐỘ 1: QUẢN LÝ FANPAGE (Page Token)
Đăng bài
CODEBLOCK1
Reply comment
CODEBLOCK2
Auto-reply Messenger
CODEBLOCK3
Xem Insights
CODEBLOCK4
CHẾ ĐỘ 2: TÌM KIẾM & NHÓM (User Token)
Tìm nhóm Facebook
CODEBLOCK5
Đọc bài trong nhóm (phải là thành viên)
CODEBLOCK6
Tìm trang/Fanpage khác
CODEBLOCK7
Tìm kiếm bài viết công khai
CODEBLOCK8
⚠️ Facebook hạn chế search API rất nhiều từ 2018. Nếu bị lỗi (#11) Search is not supported,
dùng cách khác: tìm nhóm → đọc bài trong nhóm → lọc theo nội dung.
Ví dụ thực tế: Tìm BĐS cho thuê Đà Lạt
CODEBLOCK9
Quyền cần thiết
Cho Page Token (quản lý Fanpage)
CODEBLOCK10
Cho User Token (tìm kiếm, nhóm)
CODEBLOCK11
Lưu ý quan trọng
Facebook cá nhân KHÔNG có API đăng bài
Facebook đã xóa quyền
publish_actions từ 2018.
KHÔNG thể đăng bài lên tường cá nhân qua API.
Chỉ có thể đăng bài lên
Fanpage (qua Page Token).
User Token hết hạn 60 ngày
Cần refresh định kỳ. Xem
references/setup-guide.md phần "Refresh User Token".
Rate limit
- - Page Token: ~200 requests/giờ
- User Token: ~200 requests/giờ
- Nếu bị rate limit: giảm tần suất, dùng batch requests, cache kết quả
App Mode
App phải ở chế độ
Live để hoạt động với người dùng khác.
App ở chế độ
Development chỉ admin/tester mới dùng được.
Cấu trúc thư mục
CODEBLOCK12
Facebook Manager v2 cho OpenClaw
作者: Pham Triet
社区: OpenClaw Việt Nam
全面的Facebook管理技能 — 支持2种Token模式:
选择哪种模式?
| 需求 | 模式 | Token |
|---|
| 管理粉丝页(发帖、回复、Messenger、数据洞察) | Page | Page Access Token(永久) |
| 查找群组、阅读群组帖子、查找其他页面、搜索帖子 |
User | User Access Token(约60天) |
| 两者都需要 |
两者 | 分别配置2个Token |
→ 阅读 references/setup-guide.md 获取逐步获取Token的指南。
Page Token vs User Token 权限对比
| 功能 | Page Token | User Token |
|---|
| 在粉丝页发帖 | ✅ | ✅(如果是管理员) |
| 回复粉丝页评论 |
✅ | ✅ |
| 发送Messenger消息 | ✅ | ❌ |
| 查看粉丝页数据洞察 | ✅ | ❌ |
| 查找Facebook群组 | ❌ | ✅ |
| 阅读群组内帖子(作为成员) | ❌ | ✅ |
| 查找其他页面/粉丝页 | ❌ | ✅ |
| 搜索公开帖子 | ❌ | ✅(有限制) |
| 读取个人信息 | ❌ | ✅ |
| 过期时间 | 永久 | 约60天 |
OpenClaw配置
json
{
skills: {
entries: {
facebook-manager: {
env: {
FACEBOOKPAGEID: 123456789012345,
FACEBOOKPAGETOKEN: EAAG...pagetokenvinh_vien...ZD,
FACEBOOKUSERTOKEN: EAAG...usertoken60_ngay...ZD
}
}
}
}
}
只需使用你需要的Token — 不强制要求两者都配置。
模式1: 管理粉丝页(Page Token)
发帖
bash
发布文字帖
curl -X POST https://graph.facebook.com/v22.0/$FACEBOOK
PAGEID/feed \
-H Authorization: Bearer $FACEBOOK
PAGETOKEN \
-d message=帖子内容
发布带图片的帖子
curl -X POST https://graph.facebook.com/v22.0/$FACEBOOK
PAGEID/photos \
-H Authorization: Bearer $FACEBOOK
PAGETOKEN \
-F url=https://example.com/image.jpg \
-F caption=图片说明内容
发布带链接的帖子
curl -X POST https://graph.facebook.com/v22.0/$FACEBOOK
PAGEID/feed \
-H Authorization: Bearer $FACEBOOK
PAGETOKEN \
-d message=更多信息请点击这里 -d link=https://example.com
回复评论
bash
获取评论
curl https://graph.facebook.com/v22.0/{post
id}/comments?fields=from,message,createdtime \
-H Authorization: Bearer $FACEBOOK
PAGETOKEN
回复评论
curl -X POST https://graph.facebook.com/v22.0/{comment_id}/comments \
-H Authorization: Bearer $FACEBOOK
PAGETOKEN \
-d message=感谢您的关注!
自动回复Messenger
bash
发送消息
curl -X POST https://graph.facebook.com/v22.0/$FACEBOOK
PAGEID/messages \
-H Authorization: Bearer $FACEBOOK
PAGETOKEN \
-H Content-Type: application/json \
-d {recipient:{id:USER_PSID},message:{text:您好!}}
获取对话列表
curl https://graph.facebook.com/v22.0/$FACEBOOK
PAGEID/conversations?\
fields=participants,messages{message,from,created_time}&limit=10 \
-H Authorization: Bearer $FACEBOOK
PAGETOKEN
查看数据洞察
bash
curl https://graph.facebook.com/v22.0/$FACEBOOKPAGEID/insights?\
metric=pageimpressions,pageengagedusers,pagefans&period=day \
-H Authorization: Bearer $FACEBOOKPAGETOKEN
模式2: 搜索与群组(User Token)
查找Facebook群组
bash
按关键词搜索群组
curl https://graph.facebook.com/v22.0/search?q=BDS+Da+Lat&type=group&limit=10 \
-H Authorization: Bearer $FACEBOOK
USERTOKEN
获取已加入的群组列表
curl https://graph.facebook.com/v22.0/me/groups?fields=name,member_count,privacy&limit=20 \
-H Authorization: Bearer $FACEBOOK
USERTOKEN
阅读群组内帖子(必须是成员)
bash
获取群组内的帖子
curl https://graph.facebook.com/v22.0/{group_id}/feed?\
fields=message,from,created_time,attachments&limit=20 \
-H Authorization: Bearer $FACEBOOK
USERTOKEN
查找其他页面/粉丝页
bash
按关键词搜索页面
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
USERTOKEN
获取公开页面的帖子
curl https://graph.facebook.com/v22.0/{page_id}/posts?\
fields=message,created_time,likes.summary(true)&limit=10 \
-H Authorization: Bearer $FACEBOOK
USERTOKEN
搜索公开帖子
bash
按关键词搜索公开帖子(受Meta政策限制)
curl https://graph.facebook.com/v22.0/search?q=cho+thue+phong+Da+Lat&type=post&limit=10 \
-H Authorization: Bearer $FACEBOOK
USERTOKEN
⚠️ Facebook自2018年起对搜索API限制非常严格。如果遇到 (#11) Search is not supported 错误,
请使用其他方法:查找群组 → 阅读群组内帖子 → 按内容筛选。
实际示例:查找大叻出租房产
步骤1: 查找大叻房产群组
→ search?q=BDS+cho+thue+Da+Lat&type=group
步骤2: 获取群组内最新帖子
→ {groupid}/feed?fields=message,createdtime&limit=20
步骤3: AI筛选相关帖子(出租、价格、区域)
→ Agent分析内容,为用户生成摘要
所需权限
Page Token所需权限(管理粉丝页)
pagesshowlist ← 查看粉丝页列表
pages_messaging ← 发送/接收Messenger消息
pagesmanagemetadata ← 管理粉丝页元数据
pagesmanageposts ← 发布帖子、删除帖子
pagesreadengagement ← 阅读点赞、评论、分享
pagesreaduser_content ← 阅读用户在粉丝页发布的内容
pagesmanageengagement ← 回复评论、点赞评论
User Token所需权限(搜索、群组)
public_profile ← 默认(始终拥有)
user_posts ← 阅读个人帖子
groupsaccessmember_info ← 阅读群组信息 + 群组内帖子
pagesshowlist ← 查找页面
重要注意事项
个人Facebook账号没有发帖API
Facebook自2018年起已移除 publish_actions 权限。
无法通过API在个人主页发帖。
只能通过
粉丝页(使用Page Token)发帖。
User Token 60天过期
需要定期刷新。请查看 references/setup-guide.md 中的刷新User Token部分。
速率限制
- - Page Token: 约200次请求/小时
- User Token: 约200次请求/小时
- 如果被限制速率:降低频率、使用批量请求、缓存结果
应用模式
应用必须处于
Live 模式才能与其他用户正常使用。
处于
Development 模式的应用仅管理员/测试人员可用。
目录结构
facebook-manager/
├── SKILL.md ← 本文件
├── references/
│ ├── setup-guide.md ← 获取两种Token的指南
│ └── api-reference.md ← 完整API端点列表
└── scripts/
└── check-connection.sh ← 检查连接(