Automate Warpcast with nanoclaw

Publish casts to the Farcaster protocol, target specific channels, and engage with the decentralized social ecosystem — all from the command line or through your AI agent.

Setup Guide GitHub

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

Cast to Warpcast in Seconds

Terminal

# Install the skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Find your Warpcast integration
postiz integrations:list

# Post a cast to Warpcast
postiz posts:create \
  -c "Hello Farcaster! Excited to be here." \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"subreddit":[{"value":{"id":"channel-id"}}]}' \
  -i "your-warpcast-integration-id"

Warpcast-Specific Features

📡

Farcaster Protocol

Post directly to the Farcaster decentralized social protocol. Your casts are stored on-chain and accessible across all Farcaster clients.

📢

Channel Targeting

Target specific Farcaster channels to reach the right audience. Post to niche communities and topic-focused channels.

🌐

Decentralized Social

Own your social graph. Warpcast posts live on the Farcaster protocol, giving you portability and censorship resistance.

💬

Cast Composition

Compose casts with text content and optional channel targeting. Keep your messaging concise and impactful for the Farcaster audience.

🔍

Channel Discovery

Browse and target from thousands of Farcaster channels. Reach communities focused on crypto, tech, art, and more.

📅

Scheduled Casting

Schedule casts with precise timestamps. Plan your Farcaster engagement ahead of time and cast at peak activity hours.

How It Works

Find Your Warpcast Integration

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

Discovery

# List all integrations
postiz integrations:list

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

# Get Warpcast settings schema
postiz integrations:settings <warpcast-id>

Choose Your Channel

Optionally target a specific Farcaster channel for your cast. If no channel is specified, the cast will be posted to your main feed.

Channel Targeting

# Cast without a channel (main feed)
postiz posts:create \
  -c "Hello Farcaster!" \
  -i "warpcast-id"

# Cast to a specific channel
postiz posts:create \
  -c "Thoughts on decentralized social" \
  --settings '{"subreddit":[
    {"value":{"id":"decentralized"}}
  ]}' \
  -i "warpcast-id"

Create Your Cast

Schedule a Warpcast post with your content and optional channel targeting. Casts are published to the Farcaster protocol for decentralized distribution.

Cast Creation

postiz posts:create \
  -c "Just shipped a new feature! 🚀" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "subreddit": [
      {
        "value": {
          "id": "dev"
        }
      }
    ]
  }' \
  -i "warpcast-id"

Warpcast Settings Reference

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

Field	Type	Required	Description
`__type`	string	Yes	Must be "warpcast"
`subreddit`	array	No	Array of channel objects: [{value: {id}}]
`subreddit[].value.id`	string	Yes	Farcaster channel ID to target

Common Configurations

Copy-paste these settings for common Warpcast posting scenarios.

Simple Cast (No Channel)

settings.json

{}

Cast to a Specific Channel

settings.json

{
  "subreddit": [
    {
      "value": {
        "id": "dev"
      }
    }
  ]
}

Cast to Crypto Channel

settings.json

{
  "subreddit": [
    {
      "value": {
        "id": "crypto"
      }
    }
  ]
}

Cast to Design Channel

settings.json

{
  "subreddit": [
    {
      "value": {
        "id": "design"
      }
    }
  ]
}

What is nanoclaw?

nanoclaw is a lightweight, container-based alternative to nanoclaw by Qwibit AI. It connects to WhatsApp, Telegram, Slack, Discord, and Gmail, features memory and scheduled jobs, and runs on Anthropic's Agents SDK.

📦

Container-Based

nanoclaw runs in containers for easy deployment and isolation. Spin up your social media automation agent in seconds with Docker.

💬

Multi-Platform Chat

Connect to WhatsApp, Telegram, Slack, Discord, and Gmail. Message nanoclaw from wherever you already communicate.

🧠

Memory & Context

Schedule recurring tasks with cron jobs. nanoclaw can publish your casts on a schedule without you having to ask each time.

How Postiz Works with nanoclaw

nanoclaw discovers Postiz through its skill system, similar to nanoclaw. Install the Postiz skill and nanoclaw reads the SKILL.md to learn all available commands.

✓Install Postiz skill with npx skills add gitroomhq/postiz-agent
✓nanoclaw reads the SKILL.md and learns all Postiz commands
✓POSTIZ_API_KEY must be set in environment
✓Skills are loaded on-demand, keeping the agent context clean
✓Runs on Anthropic's Agents SDK for reliable execution

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# nanoclaw discovers Postiz through
# its skill system
nanoclaw skills list

Warpcast Posting with nanoclaw

Message nanoclaw from any platform — it reads the Postiz skill, discovers your Warpcast integration, and handles the entire casting workflow autonomously.

🐳

From Any Chat App

Message nanoclaw from WhatsApp, Telegram...

Send a message to nanoclaw from your favorite chat app. It runs as a persistent daemon on your machine, so it picks up your message, discovers your Warpcast account via Postiz, composes the cast, and publishes it to the Farcaster protocol.

nanoclaw

You: Post to Warpcast about our new
  feature launch, schedule for tomorrow
  at 9am

nanoclaw: On it! Here's my plan:
  1. Found your Warpcast integration
  2. Composing your post
  3. Scheduling for tomorrow 9:00 AM

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

🐳

Scheduled & Proactive

nanoclaw supports scheduled jobs ou...

nanoclaw supports cron-based heartbeat tasks. Set up a recurring job that composes and publishes casts to Farcaster automatically — no manual trigger needed.

nanoclaw.json (scheduled job)

{
  "scheduled_jobs": [
    {
      "cron": "0 9 * * 1-5",
      "prompt": "Check ~/content/posts
  for new .txt files. For each one,
  read the content and schedule a
  post to Warpcast for today
  at noon. Move posted files
  to ~/content/published."
    }
  ]
}

Why nanoclaw + Postiz for Warpcast

nanoclaw makes Postiz a natural fit for your Warpcast workflow. The agent discovers all available commands and autonomously chains them together.

✓Message from WhatsApp or Telegram to post to Warpcast — no terminal needed
✓Container-based — easy to deploy, isolate, and scale
✓Built-in memory remembers your content preferences
✓Scheduled jobs for hands-free daily posting
✓Cross-post to Warpcast + other platforms in a single conversation
✓Runs on Anthropic's Agents SDK — reliable and extensible

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Warpcast
metadata:
  nanoclaw:
    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>

# Warpcast Settings
subreddit (optional array of channels),
each with: id (channel ID)

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 Warpcast integration, composes your cast with optional channel targeting, and publishes it to Farcaster.

Claude Code

> Cast about our product launch to the
  dev and crypto channels on Farcaster

Claude will automatically run:
  postiz integrations:list
  postiz posts:create \
    -c "We just launched! Check it out" \
    -s "2025-03-02T09:00:00Z" \
    --settings '{"subreddit":[
      {"value":{"id":"dev"}}
    ]}' \
    -i "warpcast-id"

  postiz posts:create \
    -c "New crypto tool just dropped" \
    --settings '{"subreddit":[
      {"value":{"id":"crypto"}}
    ]}' \
    -i "warpcast-id"

Warpcast + Other Platforms

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

Terminal

# Post to Warpcast and Twitter simultaneously
postiz posts:create \
  -c "Just shipped something new! Check it out." \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "subreddit": [
      {
        "value": {
          "id": "dev"
        }
      }
    ]
  }' \
  -i "warpcast-id,twitter-id"

# Batch schedule a week of Farcaster casts
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Day $day building in public! #buildinpublic" \
    -s "2025-03-0${day}T10:00:00Z" \
    --settings '{"subreddit":[{"value":{"id":"dev"}}]}' \
    -i "warpcast-id"
done

Start casting on Warpcast

Install Postiz Agent and automate your Farcaster presence with AI-powered scheduling and publishing.

Get Started

Ready to get started?

Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.

Start for $0

Open-source social media scheduling tool

Proudly open-source ❤️