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ầuChế độTokenQuản lý Fanpage (đăng bài, reply, Messenger, insights)PagePage Access Token (vĩnh viễn)Tìm nhóm, đọc bài nhóm, tìm trang khác, search bài viếtUserUser Access Token (~60 ngày)Cả haiCả haiCấ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ăngPage TokenUser 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ạnVĩnh viễn~60 ngày

---

Cấu hình OpenClaw#

json

{
  "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"
        }
      }
    }
  }
}

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#

bash

# Đăng bài text
curl -X POST "https://graph.facebook.com/v22.0/$FACEBOOK_PAGE_ID/feed" \
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN" \
  -d "message=Nội dung bài đăng"

# Đăng bài có ảnh
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=Nội dung kèm ảnh"

# Đăng bài có link
curl -X POST "https://graph.facebook.com/v22.0/$FACEBOOK_PAGE_ID/feed" \
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN" \
  -d "message=Xem thêm tại đây" -d "link=https://example.com"

Reply comment#

bash

# Lấy comments
curl "https://graph.facebook.com/v22.0/{post_id}/comments?fields=from,message,created_time" \
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN"

# Reply
curl -X POST "https://graph.facebook.com/v22.0/{comment_id}/comments" \
  -H "Authorization: Bearer $FACEBOOK_PAGE_TOKEN" \
  -d "message=Cảm ơn bạn đã quan tâm!"

Auto-reply Messenger#

bash

# Gửi tin nhắn
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":"Xin chào!"}}'

# Lấy conversations
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"

Xem Insights#

bash

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"

---

CHẾ ĐỘ 2: TÌM KIẾM & NHÓM (User Token)#

Tìm nhóm Facebook#

bash

# Tìm nhóm theo từ khóa
curl "https://graph.facebook.com/v22.0/search?q=BDS+Da+Lat&type=group&limit=10" \
  -H "Authorization: Bearer $FACEBOOK_USER_TOKEN"

# Lấy danh sách nhóm đã tham gia
curl "https://graph.facebook.com/v22.0/me/groups?fields=name,member_count,privacy&limit=20" \
  -H "Authorization: Bearer $FACEBOOK_USER_TOKEN"

Đọc bài trong nhóm (phải là thành viên)#

bash

# Lấy bài viết trong nhóm
curl "https://graph.facebook.com/v22.0/{group_id}/feed?\
fields=message,from,created_time,attachments&limit=20" \
  -H "Authorization: Bearer $FACEBOOK_USER_TOKEN"

Tìm trang/Fanpage khác#

bash

# Tìm trang theo từ khóa
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"

# Lấy bài viết của trang công khai
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"

Tìm kiếm bài viết công khai#

bash

# Tìm bài viết công khai theo từ khóa (hạn chế theo chính sách 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"

⚠️ 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#

text

Bước 1: Tìm nhóm BĐS Đà Lạt
  → search?q=BDS+cho+thue+Da+Lat&type=group

Bước 2: Lấy bài mới trong nhóm
  → {group_id}/feed?fields=message,created_time&limit=20

Bước 3: AI lọc bài liên quan (cho thuê, giá, khu vực)
  → Agent phân tích nội dung, tóm tắt cho user

---

Quyền cần thiết#

Cho Page Token (quản lý Fanpage)#

text

pages_show_list           ← Xem danh sách fanpage
pages_messaging           ← Gửi/nhận tin nhắn Messenger
pages_manage_metadata     ← Quản lý metadata fanpage
pages_manage_posts        ← Đăng bài, xóa bài
pages_read_engagement     ← Đọc likes, comments, shares
pages_read_user_content   ← Đọc nội dung user post trên page
pages_manage_engagement   ← Reply comment, like comment

Cho User Token (tìm kiếm, nhóm)#

text

public_profile            ← Mặc định (luôn có)
user_posts                ← Đọc bài viết cá nhân
groups_access_member_info ← Đọc thông tin nhóm + bài trong nhóm
pages_show_list           ← Tìm trang

---

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#

text

facebook-manager/
├── SKILL.md                    ← File này
├── references/
│   ├── setup-guide.md          ← Hướng dẫn lấy cả 2 loại token
│   └── api-reference.md        ← Danh sách API endpoints đầy đủ
└── scripts/
    └── check-connection.sh     ← Kiểm tra kết nối (cả Page + User)