Automate Reddit with nanoclaw

Post to multiple subreddits, target specific communities with flairs, choose post types, and cross-post content — 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 Reddit 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 Reddit integration
postiz integrations:list

# Discover available flairs for a subreddit
postiz integrations:trigger <id> getFlairs -d '{"subreddit":"programming"}'

# Create a Reddit post
postiz posts:create \
  -c "Check this out! A great new tool for developers." \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"Cool tool for automating social media","type":"self","is_flair_required":false}}]}' \
  -i "your-reddit-integration-id"

Reddit-Specific Features

🎯

Subreddit Targeting

Post to one or multiple subreddits simultaneously. Target the exact communities where your content belongs.

📝

Post Types

Create self posts, link posts, image posts, or video posts. Each type is optimized for Reddit's native rendering.

🏷

Flair Support

Automatically discover and apply required flairs for each subreddit. Never have a post rejected for missing flair again.

🔄

Cross-Posting

Share content across multiple subreddits in a single command. Each subreddit gets its own title and flair configuration.

🔗

Link & Media Posts

Share URLs, images, or videos directly. Link posts drive traffic while media posts maximize engagement within Reddit.

📅

Scheduled Posting

Schedule Reddit posts for peak activity times. Hit the front page by posting when your target subreddits are most active.

How It Works

Find Your Reddit Integration

List your connected accounts and grab your Reddit integration ID. You can also discover available flairs for any subreddit before posting.

Discovery

# List all integrations
postiz integrations:list

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

# Get Reddit settings schema
postiz integrations:settings <reddit-id>

# Discover flairs for a subreddit
postiz integrations:trigger <reddit-id> \
  getFlairs -d '{"subreddit":"programming"}'

Choose Your Post Type

Reddit supports multiple post types. Self posts contain text, link posts share URLs, and image/video posts upload media directly. Pick the right type for your content.

Post Types

# Self post (text only)
"type": "self"

# Link post (shares a URL)
"type": "link"
"url": "https://example.com/article"

# Image post
"type": "image"
# Use -m flag with image URL

# Video post
"type": "video"
# Use -m flag with video URL

Create Your Post

Schedule a Reddit post with your content, target subreddit, post type, and flair. You can post to multiple subreddits at once by adding more items to the subreddit array.

Post Creation

postiz posts:create \
  -c "Check this out" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "subreddit": [
      {
        "value": {
          "subreddit": "programming",
          "title": "Cool tool for developers",
          "type": "self",
          "is_flair_required": false
        }
      }
    ]
  }' \
  -i "reddit-id"

Reddit Settings Reference

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

Field	Type	Required	Description
`__type`	string	Yes	Must be "reddit"
`subreddit`	array	Yes	Array of subreddit targets: [{value: {subreddit, title, type, url?, is_flair_required, flair?}}]
`subreddit[].value.subreddit`	string	Yes	Name of the subreddit to post to (without r/ prefix)
`subreddit[].value.title`	string	Yes	Title of the Reddit post
`subreddit[].value.type`	string	Yes	Post type: "self", "link", "image", or "video"
`subreddit[].value.url`	string	No	URL for link-type posts
`subreddit[].value.is_flair_required`	boolean	Yes	Whether the subreddit requires a flair
`subreddit[].value.flair`	object	No	Flair object with id and name (required if is_flair_required is true)
`subreddit[].value.flair.id`	string	No	Flair template ID from the subreddit
`subreddit[].value.flair.name`	string	No	Display name of the flair

Common Configurations

Copy-paste these settings for common Reddit posting scenarios.

Simple Self Post

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "programming",
        "title": "Check out this new open-source tool",
        "type": "self",
        "is_flair_required": false
      }
    }
  ]
}

Link Post with Flair

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "webdev",
        "title": "How we built our scheduling engine",
        "type": "link",
        "url": "https://example.com/blog/scheduling-engine",
        "is_flair_required": true,
        "flair": {
          "id": "abc123",
          "name": "Article"
        }
      }
    }
  ]
}

Cross-Post to Multiple Subreddits

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "programming",
        "title": "New open-source social media tool",
        "type": "self",
        "is_flair_required": false
      }
    },
    {
      "value": {
        "subreddit": "opensource",
        "title": "We just open-sourced our social media scheduler",
        "type": "link",
        "url": "https://github.com/example/project",
        "is_flair_required": false
      }
    }
  ]
}

Image Post

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "dataisbeautiful",
        "title": "Social media engagement trends 2025",
        "type": "image",
        "is_flair_required": true,
        "flair": {
          "id": "def456",
          "name": "OC"
        }
      }
    }
  ]
}

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

Reddit 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...

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 Reddit account via Postiz, finds the right flairs, and schedules the post — all while you go about your day.

nanoclaw

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

nanoclaw: On it! Here's my plan:
  1. Found your Reddit 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 monitors for new content and posts it to the right subreddits 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 Reddit for today
  at noon. Move posted files
  to ~/content/published."
    }
  ]
}

Why nanoclaw + Postiz for Reddit

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

✓Message from WhatsApp or Telegram to post to Reddit — 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 Reddit + 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 Reddit
metadata:
  nanoclaw:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz integrations:trigger <id>
    getFlairs -d '{"subreddit":"..."}'
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Reddit Settings
subreddit (array of targets),
type (self/link/image/video),
title, url, flair, is_flair_required

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 Reddit integration, checks flair requirements, and schedules posts to the right subreddits.

Claude Code

> Post to r/programming and r/webdev
  about our new feature, schedule for
  tomorrow morning

Claude will automatically run:
  postiz integrations:list
  postiz integrations:trigger <id> \
    getFlairs -d '{"subreddit":"programming"}'
  postiz posts:create \
    -c "Details about the feature..." \
    -s "2025-03-02T09:00:00Z" \
    --settings '{"subreddit":[
      {"value":{"subreddit":"programming",
        "title":"New feature release",
        "type":"self",
        "is_flair_required":false}},
      {"value":{"subreddit":"webdev",
        "title":"New feature release",
        "type":"self",
        "is_flair_required":false}}
    ]}' \
    -i "reddit-id"

Reddit + Other Platforms

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

Terminal

# Post to Reddit and Twitter simultaneously
postiz posts:create \
  -c "We just launched something awesome! Check it out." \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "subreddit": [
      {
        "value": {
          "subreddit": "programming",
          "title": "We just launched our new tool",
          "type": "link",
          "url": "https://example.com",
          "is_flair_required": false
        }
      }
    ]
  }' \
  -i "reddit-id,twitter-id"

# Batch schedule a week of Reddit content
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Day $day insights from our dev team" \
    -s "2025-03-0${day}T10:00:00Z" \
    --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"Dev insight day '$day'","type":"self","is_flair_required":false}}]}' \
    -i "reddit-id"
done

Start posting to Reddit

Install Postiz Agent and automate your Reddit content strategy 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 ❤️