fboc

CLI tool to manage Facebook Pages: list, create, read, hide, delete posts; list, create, delete comments; and get page info via the Graph API.

phuongsky@phuongsky

Install

openclaw skills install @phuongsky/facebook-openclaw

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

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

fboc

Install

Facebook Advanced Skill

Installation

Setup

Usage

Main CLI

Available Commands

List Posts

Create Post

Read Post

Hide Post

Delete Post

List Comments

Create Comment

Delete Comment

Page Info

Examples

Cron Jobs (openclaw)

CLI

Environment Variables

Permissions Required

Security Notes

Troubleshooting

"Invalid Access Token"

"Permission Denied"

"Page Not Found"

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

Function error

Related to the other files

API Reference

Related skills