Automate Reddit with AI Agents

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 ClawHub

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

Post to Reddit in Seconds

Terminal

# Install globally
npm install -g postiz

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

Reddit Posting with OpenClaw

Message OpenClaw from any platform — it reads the Postiz skill, discovers your Reddit 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 Reddit account via Postiz, finds the right flairs, and schedules the post — all while you go about your day.

WhatsApp / Telegram

You: Post to r/programming about our
  new open-source tool, schedule for
  tomorrow at 9am

OpenClaw: Got it! Here's what I'll do:
  1. Check r/programming flair requirements
  2. Create a self post with your content
  3. Schedule for 2025-03-02T09:00:00Z

  Done! Your Reddit 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 monitors for new content and posts it to the right subreddits automatically — no manual trigger needed.

openclaw.json (heartbeat)

{
  "heartbeat": [
    {
      "cron": "0 9 * * 1-5",
      "prompt": "Check ~/content/pending
  for new blog posts. For each one,
  create a Reddit post to r/programming
  and r/webdev. Use the title from the
  frontmatter. Check flair requirements
  for each subreddit. Move posted files
  to ~/content/posted."
    }
  ]
}

Why OpenClaw + Postiz for Reddit

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

✓Message from WhatsApp to post to Reddit — no terminal needed
✓Cron jobs for hands-free daily posting schedules
✓Structured JSON output lets OpenClaw verify each step succeeded
✓Flair discovery and application handled automatically per subreddit
✓Cross-post to Reddit + 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 Reddit
metadata:
  openclaw:
    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