fboc（fboc 命令行）

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 <page_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 <page_id> --message "Your message" [--link "https://example.com"]

Read Post

facebook-advanced fb-post-read <post_id>

Hide Post

facebook-advanced fb-post-hide <post_id>

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

Delete Post

facebook-advanced fb-post-delete <post_id> [--force]

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

List Comments

facebook-advanced fb-comment-list <post_id> [--limit N]

Create Comment

facebook-advanced fb-comment-create <post_id> --message "Your comment"

Delete Comment

facebook-advanced fb-comment-delete <comment_id> [--force]

Page Info

facebook-advanced fb-page-info <page_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

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](https://developers.facebook.com/docs/graph-api)
- [Pages API](https://developers.facebook.com/docs/graph-api/reference/page)
- [Posts API](https://developers.facebook.com/docs/graph-api/reference/page/posts)
- [Comments API](https://developers.facebook.com/docs/graph-api/reference/post/comments)