Automate X with nanoclaw

Schedule tweets, control reply permissions, post threads, and publish to X Communities — all from the command line or through your AI agent.

Setup Guide GitHub

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

Post to X 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 X integration
postiz integrations:list

# Schedule a post on X
postiz posts:create \
  -c "Hello world! #buildinpublic" \
  -s "2025-01-15T09:00:00Z" \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "your-x-integration-id"

# Post a thread (multiple -c flags)
postiz posts:create \
  -c "Thread time! Here's what I learned this week..." \
  -c "1/ First, always ship small increments." \
  -c "2/ Second, get feedback early and often." \
  -c "3/ Third, automate everything you can." \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "your-x-integration-id"

X-Specific Features

🗣

Reply Controls

Control who can reply to your posts: everyone, people you follow, mentioned users, subscribers, or verified accounts only.

🧵

Thread Support

Create multi-tweet threads by passing multiple -c flags. Each flag becomes a separate tweet in the thread, posted in order.

🏘

Community Posting

Post directly to X Communities by providing a community URL. Reach targeted audiences with relevant content.

✍

Simple Text Posts

Quickly publish text-only tweets with hashtags, mentions, and links. No media upload required for basic posts.

📸

Media Attachments

Attach images or videos to your posts. Upload media through Postiz and include it seamlessly in your scheduled tweets.

📅

Scheduled Posting

Schedule posts with precise timestamps. Queue up a week of content in minutes and let Postiz handle the publishing.

How It Works

Find Your X Integration

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

Discovery

# List all integrations
postiz integrations:list

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

# Get X settings schema
postiz integrations:settings <x-id>

Compose Your Content

Write your tweet or thread. Use multiple -c flags to create threads. Add media with the -m flag after uploading through Postiz.

Compose

# Simple tweet
postiz posts:create \
  -c "Just shipped a new feature!" \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "x-id"

# Thread with multiple tweets
postiz posts:create \
  -c "Big announcement incoming..." \
  -c "We just hit 10k users!" \
  -c "Here's what we learned along the way." \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "x-id"

Schedule & Publish

Schedule your post for a specific time or publish immediately. Set reply controls and optionally target an X Community.

Post Creation

postiz posts:create \
  -c "Check out our latest blog post!" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "who_can_reply_post": "everyone",
    "community": "https://x.com/i/communities/123"
  }' \
  -i "x-id"

X Settings Reference

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

Field	Type	Required	Description
`__type`	string	Yes	Must be "x"
`who_can_reply_post`	string	Yes	Who can reply: everyone, following, mentionedUsers, subscribers, verified
`community`	string	No	X Community URL to post into

Common Configurations

Copy-paste these settings for common X posting scenarios.

Public Post — Everyone Can Reply

settings.json

{
  "who_can_reply_post": "everyone"
}

Followers Only Replies

settings.json

{
  "who_can_reply_post": "following"
}

Community Post with Verified Replies

settings.json

{
  "who_can_reply_post": "verified",
  "community": "https://x.com/i/communities/1234567890"
}

Mentioned Users Only

settings.json

{
  "who_can_reply_post": "mentionedUsers"
}

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

nanoclaw remembers your preferences and past interactions. It learns your posting style and content strategy over 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

X Posting with nanoclaw

Message nanoclaw from WhatsApp, Telegram, or Slack — it discovers your integrations via Postiz, composes your content, and handles the entire posting workflow from within its container.

🐳

From Any Chat App

Message nanoclaw from WhatsApp, Telegram...

Message nanoclaw from WhatsApp, Telegram, or Slack — it discovers your integrations via Postiz, composes your content, and handles the entire posting workflow from within its container.

nanoclaw

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

nanoclaw: On it! Here's my plan:
  1. Found your X 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 scheduled jobs out of the box. Set up cron-based automation that drafts and publishes content on a recurring schedule.

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 X for today
  at noon. Move posted files
  to ~/content/published."
    }
  ]
}

Why nanoclaw + Postiz for X

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

✓Message from WhatsApp or Telegram to post to X — 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 X + 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 X
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>

# X Settings
who_can_reply_post, community

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 X integration, composes your tweet or thread, applies reply settings, and schedules the post.

Claude Code

> Post a thread about our product launch
  on X, schedule for tomorrow, everyone
  can reply

Claude will automatically run:
  postiz integrations:list
  postiz posts:create \
    -c "Big news! We just launched..." \
    -c "Here's what makes it special..." \
    -c "Try it out today at..." \
    -s "2025-03-02T09:00:00Z" \
    --settings '{"who_can_reply_post":
      "everyone"}' \
    -i "x-id"

X + Other Platforms

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

Terminal

# Post to X and LinkedIn simultaneously
postiz posts:create \
  -c "Excited to announce our new feature! #buildinpublic" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "x-id,linkedin-id"

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