Automate X with Grok Bot

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

Setup Guide Marketplace

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

Post to X in Seconds

Grok Bot

# In any Bot chat, add the Postiz plugin
/add-plugin postiz

# Store POSTIZ_API_KEY as a Bot secret when prompted.
# Your Bot can now run Postiz on its cloud computer:

# 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 Grok Bot?

Grok Bot is the always-on AI teammate product from xAI and Cursor. You create named Bots, give each one a job, and they work 24/7 on their own persistent cloud computer — with a browser, a filesystem, and a terminal — pinging you only when they need approval.

Grok Bot is not the Grok chatbot. Grok is the assistant you chat with on X and grok.com. Grok Bot is a separate app for delegating real, multi-step work — like running your X presence with Postiz.

💻

Own Cloud Computer

Every Bot gets a persistent cloud machine with a terminal. Postiz runs there, so your X posts go out even when your laptop is closed.

🔁

Routines

Turn any task into a routine that runs on a schedule. Your Bot drafts, schedules, and reports on X content without being asked twice.

🛡️

Approvals Built In

Bots ask before changing external systems. Review the X posts your Bot prepared in Postiz, approve, and it publishes.

How Postiz Works with Grok Bot

Postiz is listed on the Grok Bot plugin marketplace. Add it to a Bot and the Postiz skill, CLI, and command reference are installed on its cloud computer — the Bot can then manage your X workflow on its own.

✓Type /add-plugin postiz in a Bot chat, or add it from the Plugins sidebar
✓Store your POSTIZ_API_KEY as a Bot secret when prompted
✓The Bot reads the bundled SKILL.md and learns every Postiz command
✓Works in every Bot on your shared workspace, on desktop and iPhone
✓Approvals keep a human in the loop before anything is published

Grok Bot

# 1. Add the plugin to your Bot
/add-plugin postiz

# 2. Store your Postiz API key
#    as a secret when prompted

# 3. Ask your Bot to verify
You: Find my X channel in Postiz

Bot: Running postiz integrations:list
  Found your X integration.
  All Postiz commands are ready.

X Posting with Grok Bot

Your Bot reads the Postiz skill, discovers your X integration, and handles the entire posting workflow — from content creation to scheduling — on its own cloud computer.

🧠

Message Your Bot

Desktop, iPhone, or a group chat

Send a message to your Bot from the desktop app or your iPhone. It runs on its own cloud computer, so it picks up your message, discovers your X account via Postiz, uploads your media, and schedules the post — then asks you to approve before it goes live.

Grok Bot

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

Bot: Got it! Here's the plan:
  1. Find your X integration
  2. Compose your post content
  3. Schedule for tomorrow 9:00 AM

  Done! Post scheduled successfully.
  Post ID: abc-123

🧠

Routines

Recurring work on a schedule

Save the task as a routine. Your Bot runs it on a schedule from the cloud, checks for new content, and posts it to X automatically — no manual trigger needed.

Grok Bot routine

Routine: daily-x-posts
Schedule: Weekdays at 9:00 AM

Instructions:
  Check ~/content/posts on your cloud
  computer for new .txt files. For
  each one, read the content and
  schedule a post to X for
  today at noon via Postiz. Move
  posted files to ~/content/published
  and send me a summary.

Why Grok Bot + Postiz for X

Grok Bot makes Postiz a natural fit for your X workflow. The Bot reads the plugin's skill, chains the right commands together, and keeps running from the cloud.

✓Official plugin — one command install from the marketplace
✓Always on — posts to X from the cloud while you are away
✓Terminal access runs Postiz commands directly on the Bot's computer
✓Routines for hands-free daily posting
✓Cross-post to X + other platforms in a single conversation
✓Approvals keep a human in the loop before publishing

SKILL.md (bundled in the plugin)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including X
metadata:
  grok-bot:
    plugin: postiz
    secrets:
      - 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