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:

bash

# 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:

json

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

powershell

$env:FB_PAGE_ACCESS_TOKEN = "your_token_here"

Usage#

Main CLI#

powershell

facebook-advanced

Available Commands#

List Posts

powershell

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

powershell

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

Read Post

powershell

facebook-advanced fb-post-read <post_id>

Hide Post

powershell

facebook-advanced fb-post-hide <post_id>

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

Delete Post

powershell

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

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

List Comments

powershell

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

Create Comment

powershell

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

Delete Comment

powershell

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

Page Info

powershell

facebook-advanced fb-page-info <page_id>

Examples#

powershell

# 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

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

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

text

- Add job

# Terminal
```powershell

openclaw cron add

--name "Job Name"

--cron "cron expression"

--tz "America/New_York" \ # US timezone (Eastern Time) --session isolated \ # Recommended to use isolated to avoid polluting main context --message "facebook-advanced fb-post-list 123456789 --limit 10"

--announce

CLI#

powershell

openclaw cron add --name "Reminder" --at "2m" --session main --system-event "Reminder: Review documents" --wake now --delete-after-run

openclaw cron add --name "Morning Briefing" --cron "0 9 * * *" --tz "America/New_York" --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

bin#

Create setup.ps1 in fboc directory (folder C:\Users\OS.openclaw\workspace\skills\fboc\bin)#

Setup script for facebook-advanced CLI on Windows#

Make the bin file executable#

powershell

$binPath = Join-Path $PSScriptRoot "facebook-advanced"

# Ensure the file exists
if (Test-Path $binPath) {
    # On Windows, we don't need to chmod, but we can verify the file is readable
    Write-Host "facebook-advanced CLI is ready."
} else {
    Write-Error "facebook-advanced binary not found at $binPath"
    exit 1
}

Function error#

PS C:\Users\OS.openclaw\workspace\skills\fboc> facebook-advanced --help node:internal/modules/cjs/loader:1368 throw err; ^

Error: Cannot find module 'commander' Require stack:

• C:\Users\OS.openclaw\workspace\skills\fboc\bin\facebook-advanced at Function._resolveFilename (node:internal/modules/cjs/loader:1365:15) at defaultResolveImpl (node:internal/modules/cjs/loader:1021:19) at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1026:22) at Function._load (node:internal/modules/cjs/loader:1175:37) at TracingChannel.traceSync (node:diagnostics_channel:322:14) at wrapModuleLoad (node:internal/modules/cjs/loader:235:24) at Module.require (node:internal/modules/cjs/loader:1445:12) at require (node:internal/modules/helpers:135:16) at Object. (C:\Users\OS.openclaw\workspace\skills\fboc\bin\facebook-advanced:3:21) at Module._compile (node:internal/modules/cjs/loader:1688:14) { code: 'MODULE_NOT_FOUND', requireStack: [ 'C:\Users\OS\.openclaw\workspace\skills\fboc\bin\facebook-advanced' ] }

=> throw them into openclaw chat, the errors will be fixed automatically

Related to the other files#

• exec-approvals.json: Approval list for executing commands
• allowlist.json: Permission list for executing fb commands
• facebook-config.json: Access page information
• setup.ps1: Setup script for facebook-advanced CLI on Windows

API Reference#

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