A real-time bridge that polls your Facebook Page inbox and forwards new messages directly to your OpenClaw channels.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install fb-inbox-forward
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install fb-inbox-forward using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Facebook Inbox Forwarder (fb-inbox-forward)?
The fb-inbox-forward skill is a specialized background listener designed to bridge the gap between Meta's messaging ecosystem and your terminal-based workflows. By leveraging the Openclaw Skills framework, this tool allows developers and business owners to monitor Facebook Page inquiries without leaving their primary development environment. It focuses on security and efficiency, ensuring that all interactions with the Facebook Graph API are handled via encrypted tokens stored locally.
This skill operates by running a lightweight PowerShell worker that periodically checks for new inbound conversations. It is part of the broader suite of Openclaw Skills that prioritize user-controlled automation, meaning the listener only runs when explicitly activated. It integrates seamlessly with existing credential configurations, making it a powerful addition to any automated customer support or community management stack.
Facebook Inbox Forwarder (fb-inbox-forward) Use Cases
- Centralizing customer support by routing Facebook messages into a unified team communication channel.
- Reducing response times for high-priority Facebook Page inquiries through real-time notifications.
- Monitoring social media engagement levels directly within your Openclaw Skills dashboard.
- Archiving inbound lead metadata while maintaining strict privacy by only logging conversation IDs.
How Facebook Inbox Forwarder (fb-inbox-forward) Works
- The skill retrieves necessary Facebook Page tokens and IDs from the local fb-page skill configuration.
- Upon activation, the agent generates a worker.ps1 script tailored to the user's environment.
- The worker script initiates a polling loop that queries the graph.facebook.com endpoint every 15 seconds.
- The system identifies new messages by comparing the latest conversation timestamps against a local listener-state.json file.
- Valid new messages are formatted and transmitted to the specified target using the Openclaw Skills messaging CLI.
Facebook Inbox Forwarder (fb-inbox-forward) Setup
First, ensure you have the fb-page skill configured with valid credentials. Then, initialize the forwarder configuration:
# Step 1: Verify your Facebook credentials are set
# This skill reads from ~/.config/fb-page/credentials.json
# Step 2: Configure the notification target
# Run the setup block to select your channel and target ID
To start the real-time listener, use the start command provided in the skill logic which initializes the background process using Start-Process in PowerShell or pwsh.
Facebook Inbox Forwarder (fb-inbox-forward) Data Schema & Taxonomy
The skill manages its data within ~/.config/fb-inbox-forward/ using the following structure:
| File | Purpose | Security Protocol |
|---|---|---|
config.json |
Stores the target channel and polling interval. | Restricted permissions (600) |
worker.ps1 |
The logic for the background polling process. | Restricted permissions (600) |
listener-state.json |
A JSON map of conversation IDs and last-seen timestamps. | Metadata only; no message text |
listener.log |
Operational logs showing forwarder activity and errors. | Content-free; logs names and IDs only |
Facebook Inbox Forwarder (fb-inbox-forward) Advanced Features
- Smart Rate Limiting: Automatically detects Facebook API error 368 and suggests increasing the polling interval to avoid temporary blocks.
- Multi-Platform Support: Dynamically detects the operating system to utilize either native Windows PowerShell or cross-platform pwsh.
- Granular State Management: Uses a persistent state file to ensure no messages are duplicated even if the listener is restarted.
- Zero-Persistence Privacy: Message content is transmitted directly to your channel and is never cached or stored on the local disk within the Openclaw Skills file structure.
SKILL.md
Loading
Related Openclaw Skills
ClawHub Skill Creator
A developer utility for scaffolding, validating, and publishing standards-compliant Openclaw Skills to the ClawHub registry.
Yoinkit
Yoinkit is a comprehensive social media intelligence tool that allows AI agents to search, analyze, and transcribe content across 13 major platforms.
HiveFence
HiveFence is a distributed security layer that provides collective immunity against prompt injection attacks for AI agents.
Selective Pollution Test
A specialized research skill that conditionally modifies search keywords for authorized security testing and information flow analysis.
tiktok-page
A comprehensive PowerShell-based skill for managing TikTok video uploads, account statistics, and comment interaction via the official API.
X/Twitter Manager Skill
A robust PowerShell-based skill for managing X/Twitter interactions, analytics, and content posting through an AI agent.
METADATA
Featured*
