Facebook Advanced Skill

A comprehensive CLI tool for managing Facebook Pages and posts via the Graph API.

Installation

This skill is installed as an npm package. After cloning or installing:

# Set your Facebook Page Access Token
$env:FB_PAGE_ACCESS_TOKEN = "your_page_access_token_here"

# Make the script executable (if needed)
# On Windows, PowerShell scripts may need execution policy adjustment
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Setup

1. Get a Page Access Token:
   • Go to Facebook Developers
   • Create an app or use an existing one
   • Use Graph API Explorer to generate a token with pages_manage_posts, pages_read_engagement, and pages_show_list permissions
   • Or use your existing Page Access Token

Option A: Using facebook-config.json (Recommended)

Edit facebook-config.json in this directory:

{
  "FB_PAGE_ACCESS_TOKEN": "FB_PAGE_ACCESS_TOKEN",
  "FB_APP_ID": "(OPTIONAL) YOUR_APP_ID_HERE",
  "FB_APP_SECRET": "(OPTIONAL) YOUR_APP_SECRET_HERE",
  "description": "Replace the placeholder values with your actual Facebook credentials. Never commit this file with real secrets to version control."
}

Option B: Using environment variable

Set the environment variable:

$env:FB_PAGE_ACCESS_TOKEN = "your_token_here"

Usage

Main CLI

facebook-advanced

Available Commands

List Posts

facebook-advanced fb-post-list \x3Cpage_id> [--fields fields] [--limit N]

• --fields: Comma-separated list of fields (default: message,created_time,id,permalink_url,full_picture,likes.summary(true),comments.summary(true))
• --limit: Number of posts to retrieve (default: 25)

Create Post

facebook-advanced fb-post-create \x3Cpage_id> --message "Your message" [--link "https://example.com"]

Read Post

facebook-advanced fb-post-read \x3Cpost_id>

Hide Post

facebook-advanced fb-post-hide \x3Cpost_id>

Note: Hiding is recommended over deletion as it's reversible.

Delete Post

facebook-advanced fb-post-delete \x3Cpost_id> [--force]

Warning: This permanently deletes the post. Use --force to skip confirmation.

List Comments

facebook-advanced fb-comment-list \x3Cpost_id> [--limit N]

Create Comment

facebook-advanced fb-comment-create \x3Cpost_id> --message "Your comment"

Delete Comment

facebook-advanced fb-comment-delete \x3Ccomment_id> [--force]

Page Info

facebook-advanced fb-page-info \x3Cpage_id>

Examples

# Set token
$env:FB_PAGE_ACCESS_TOKEN = "EAABwzLixnjYBO..."

# List recent posts
facebook-advanced fb-post-list 123456789 --limit 10

# Create a new post
facebook-advanced fb-post-create 123456789 --message "Hello from OpenClaw!"

# Create a post with a link
facebook-advanced fb-post-create 123456789 --message "Check this out!" --link "https://example.com"

# Read a specific post
facebook-advanced fb-post-read 123456789_987654321

# Hide a post
facebook-advanced fb-post-hide 123456789_987654321

# List comments on a post
facebook-advanced fb-comment-list 123456789_987654321 --limit 50

# Reply to a post
facebook-advanced fb-comment-create 123456789_987654321 --message "Thanks for the feedback!"

# Get page information
facebook-advanced fb-page-info 123456789

Cron Jobs (openclaw)

# Cron Jobs UI
- New Job
`Assistant task prompt *` 
Example:

facebook-advanced fb-post-list 123456789 --limit 10

- Add job

# Terminal
```powershell

openclaw cron add
--name "Tên job"
--cron "biểu thức cron"
--tz "Asia/Ho_Chi_Minh" \ # Múi giờ Việt Nam --session isolated \ # Nên dùng isolated để tránh làm bẩn context chính --message "facebook-advanced fb-post-list 123456789 --limit 10"
--announce # (tùy chọn) Gửi thông báo khi chạy xong

CLI

openclaw cron add --name "Reminder" --at "2m" --session main --system-event "Reminder: Xem lại tài liệu" --wake now --delete-after-run

openclaw cron add --name "Morning Briefing" --cron "0 9 * * *" --tz "Asia/Ho_Chi_Minh" --session isolated --message "facebook-advanced fb-post-list 123456789 --limit 10" --deliver

• FB_PAGE_ACCESS_TOKEN: Required. Your Facebook Page Access Token with appropriate permissions.

Environment Variables

• FB_PAGE_ACCESS_TOKEN: Required. Your Facebook Page Access Token with appropriate permissions.

Permissions Required

• pages_manage_posts: Create, edit, hide, delete posts
• pages_read_engagement: Read posts and comments
• pages_show_list: Access page information

Security Notes

• Never commit your access token to version control
• Use environment variables or a secure secrets manager
• Tokens may expire; regenerate as needed
• Use the principle of least privilege for token permissions

Troubleshooting

"Invalid Access Token"

• Token may have expired
• Check that the token has the required permissions
• Regenerate the token from Graph API Explorer

"Permission Denied"

• Ensure your token has the required permissions
• Verify you're an admin/editor of the page

"Page Not Found"

• Verify the page ID is correct
• Ensure your token has access to that page

API Reference

• Facebook Graph API Documentation
• Pages API
• Posts API
• Comments API