Automate Facebook with AI Agents

Schedule Facebook posts, attach link previews, manage media content, and grow your page presence — all from the command line or through your AI agent.

Setup Guide ClawHub

Please make sure there is always a human in the loop.

Post to Facebook in Seconds

Terminal

# Install globally
npm install -g postiz

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Find your Facebook integration
postiz integrations:list

# Schedule a Facebook post with a link preview
postiz posts:create \
  -c "Check this out — our latest blog post on automation!" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"url":"https://example.com/blog/automation"}' \
  -i "your-facebook-integration-id"

Facebook-Specific Features

✍

Text Posts

Publish engaging text posts with emojis, hashtags, and mentions. Perfect for quick updates, announcements, and community engagement.

🔗

Link Previews

Attach URLs to generate rich link previews with title, description, and thumbnail. Drive traffic to your website or blog.

📸

Media Attachments

Upload and attach images or videos to your posts. Share visual content that drives higher engagement on Facebook.

🏢

Page Management

Post as your Facebook Page to maintain your brand voice. Schedule content for your business page effortlessly.

📊

Analytics Tracking

Track post performance with Postiz analytics. Monitor reach, engagement, and clicks across your Facebook content.

📅

Scheduled Posting

Schedule posts with precise timestamps. Plan your Facebook content calendar and let Postiz handle the publishing.

How It Works

Find Your Facebook Integration

List your connected accounts and grab your Facebook integration ID. You can also fetch available settings to see what options are supported.

Discovery

# List all integrations
postiz integrations:list

# Filter for Facebook
postiz integrations:list | jq \
  '.[] | select(.identifier=="facebook")'

# Get Facebook settings schema
postiz integrations:settings <facebook-id>

Prepare Your Content

Write your post content and optionally upload media. For link posts, just include the URL in settings — Facebook generates the preview automatically.

Prepare

# Upload an image (optional)
RESULT=$(postiz upload photo.jpg)
IMAGE_URL=$(echo "$RESULT" | jq -r '.path')

echo $IMAGE_URL
# https://uploads.postiz.com/photo.jpg

# Or just use a link URL in settings
# for rich link previews

Create Your Post

Schedule a Facebook post with your content, optional media, and platform-specific settings like link URL for rich previews.

Post Creation

postiz posts:create \
  -c "We just launched our new feature!" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "url": "https://example.com/launch"
  }' \
  -i "facebook-id"

Facebook Settings Reference

Every Facebook post accepts these platform-specific settings via the --settings flag.

Field	Type	Required	Description
`__type`	string	Yes	Must be "facebook"
`url`	string	No	Link URL to attach for rich link previews

Common Configurations

Copy-paste these settings for common Facebook posting scenarios.

Simple Text Post

settings.json

{}

Post with Link Preview

settings.json

{
  "url": "https://example.com/blog/my-article"
}

Product Launch Announcement

settings.json

{
  "url": "https://myproduct.com/launch"
}

What is OpenClaw?

OpenClaw is the open-source personal AI agent with 145k+ GitHub stars. It runs locally on your machine, connects through apps you already use, and takes real actions on your behalf.

💬

Works Where You Are

Message OpenClaw from WhatsApp, Telegram, Slack, Discord, Signal, iMessage, or 10+ other platforms. No new app to learn.

🧩

Skill-Based Architecture

OpenClaw extends its abilities through Skills — lightweight plugins defined in Markdown files. Postiz is available as a skill on ClawHub.

⏰

Proactive Automation

Schedule recurring tasks with cron jobs. OpenClaw can post your Facebook content on a schedule without you having to ask each time.

How Postiz Becomes an OpenClaw Skill

When you install Postiz Agent globally, OpenClaw automatically discovers it by reading the bundled SKILL.md file. This file tells OpenClaw what commands are available, what environment variables are needed, and how to compose Facebook posts with the right settings.

✓Install from ClawHub with one command: clawhub install nevo-david/postiz
✓OpenClaw reads the SKILL.md and learns all Postiz commands
✓Eligibility is checked automatically — POSTIZ_API_KEY must be set
✓Skills are loaded on-demand, keeping the agent context clean
✓Works with any LLM backend: Claude, GPT, Gemini, Llama, and more

Install from ClawHub

# Install the Postiz skill
clawhub install nevo-david/postiz

# Or install the CLI globally
npm install -g postiz

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Verify OpenClaw sees it
openclaw skills list --eligible

# Output:
# - postiz: Social media automation
#   CLI for scheduling posts
#   across 30+ platforms

Facebook Posting with OpenClaw

Message OpenClaw from any platform — it reads the Postiz skill, discovers your Facebook integration, and handles the entire posting workflow autonomously.

🦀

From Any Chat App

WhatsApp, Telegram, Slack, Discord...

Send a message to OpenClaw from your favorite chat app. It runs as a persistent daemon on your machine, so it picks up your message, discovers your Facebook page via Postiz, composes the post, and schedules it — all while you go about your day.

WhatsApp / Telegram

You: Share our latest blog post on
  Facebook with a link preview,
  schedule for tomorrow at 10am

OpenClaw: Got it! Here's what I'll do:
  1. Create post with blog link
  2. Schedule for 2025-03-02T10:00:00Z
  3. Settings: link preview enabled

  Done! Your Facebook post is scheduled.
  Post ID: abc-123

🦀

Scheduled & Proactive

Cron jobs for recurring content

OpenClaw supports cron-based heartbeat tasks. Set up a recurring job that checks for new blog posts and shares them on Facebook automatically — no manual trigger needed.

openclaw.json (heartbeat)

{
  "heartbeat": [
    {
      "cron": "0 10 * * 1-5",
      "prompt": "Check ~/content/facebook
  for new .txt files. For each one,
  read the content and schedule a
  Facebook post for today at noon.
  If the file contains a URL, include
  it as a link preview. Move posted
  files to ~/content/posted."
    }
  ]
}

Why OpenClaw + Postiz for Facebook

OpenClaw's skill system makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Facebook workflows.

✓Message from WhatsApp to post on Facebook — no terminal needed
✓Cron jobs for hands-free daily posting schedules
✓Structured JSON output lets OpenClaw verify each step succeeded
✓Link previews generated automatically when a URL is provided
✓Cross-post to Facebook + other platforms in a single conversation
✓Model-agnostic — works with Claude, GPT, Gemini, or open-source LLMs

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Facebook
metadata:
  openclaw:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Facebook Settings
__type, url

Also Works with Claude Code

Postiz Agent works as a CLI tool with any AI agent that can execute shell commands — including Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the SKILL.md file to learn all available Postiz commands, then autonomously discovers your Facebook integration, composes your post with a link preview if needed, and schedules the post.

Claude Code

> Share our new blog post on Facebook
  with a link preview, schedule for
  tomorrow morning

Claude will automatically run:
  postiz integrations:list
  postiz posts:create \
    -c "New on our blog: How to..." \
    -s "2025-03-02T09:00:00Z" \
    --settings '{"url":
      "https://example.com/blog/
      how-to-automate"}' \
    -i "facebook-id"

Facebook + Other Platforms

Schedule the same content to Facebook and other platforms in a single command. Each platform gets its own settings.

Terminal

# Post to Facebook and Instagram simultaneously
postiz posts:create \
  -c "Big announcement! Check out our latest update." \
  -m "$IMAGE_URL" \
  -s "2025-03-01T10:00:00Z" \
  --settings '{"url":"https://example.com/update"}' \
  -i "facebook-id,instagram-id"

# Batch schedule a week of Facebook content
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Day $day tip for growing your business!" \
    -s "2025-03-0${day}T10:00:00Z" \
    --settings '{}' \
    -i "facebook-id"
done