Post to X (Twitter) from Paperclip

Paperclip agents can publish and schedule X (Twitter) posts through Postiz. Install the Postiz skill in the agent's environment, connect your X account in Postiz, and any agent in your Paperclip org can write tweets, split long content into threads, set who can reply, and post into X Communities on a schedule.

Setup Guide Paperclip

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

Last updated: September 2026

Post to X in Seconds

Setup, then just ask

# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask Paperclip:
> Post a thread about our launch on X,
  schedule it for tomorrow at 9am

Paperclip: Done! Your X post is scheduled.

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

Ask for a thread and Paperclip splits it into separate tweets, 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 does Paperclip post to X (Twitter)?

You describe what you want in plain language and Paperclip handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your X Integration

Ask Paperclip whether your X account is connected. It also checks which options the platform supports.

Example conversation

> Is my X account connected to Postiz?

Paperclip: Yes — your X account is connected
  and ready. Want me to post something?

Compose Your Content

Describe your tweet or thread. Ask for a thread and Paperclip splits it into separate tweets; mention an image or video and it uploads it for you.

Example conversation

> Draft an X post about our new
  feature launch

Paperclip: Here's a draft for X:
  "We just shipped something big..."
  Want me to add media and schedule it?

Schedule & Publish

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

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

Paperclip: Done! Scheduled on X for
  tomorrow at 9:00 AM.

X Settings Reference

Mention any of these in plain language and Paperclip sets them for you. These are the X options it can apply to any post.

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

Ask Paperclip for any of these common X scenarios and it applies the matching settings.

Public Post — Everyone Can Reply

Just ask

> Post it with: Public Post — Everyone Can Reply

Paperclip: Got it. Applying:
  who_can_reply_post: everyone

Followers Only Replies

Just ask

> Post it with: Followers Only Replies

Paperclip: Got it. Applying:
  who_can_reply_post: following

Community Post with Verified Replies

Just ask

> Post it with: Community Post with Verified Replies

Paperclip: Got it. Applying:
  who_can_reply_post: verified
  community: https://x.com/i/communities/1234567890

Mentioned Users Only

Just ask

> Post it with: Mentioned Users Only

Paperclip: Got it. Applying:
  who_can_reply_post: mentionedUsers

What is Paperclip?

Paperclip is an open-source orchestration framework for building “zero-human companies” by hiring and managing teams of AI agents. It handles content, social media distribution, marketing, dev, QA, and more from a single dashboard.

👥

Agent Teams

Paperclip manages teams of AI agents that work together. Assign a content agent, a scheduling agent, and a review agent to your social media workflow.

📊

Single Dashboard

Monitor all your AI agents and their social media tasks from one unified dashboard. Track posts, schedules, and performance in real time.

⚙

Orchestration

Paperclip orchestrates complex multi-agent workflows. Chain content creation, review, approval, and publishing into automated pipelines.

How Postiz Works with Paperclip

Paperclip integrates Postiz as a tool in its agent orchestration framework. Agents in your Paperclip team can call Postiz commands to manage social media workflows end-to-end.

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz commands to specialized agents in your team
✓Orchestrate multi-step workflows with approval chains
✓Monitor everything from the Paperclip dashboard

Install Postiz

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

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Paperclip discovers Postiz through
# its tool integration system
# and assigns it to agent teams

X Posting with Paperclip

Paperclip assigns specialized agents to each step of your social media workflow — content creation, review, scheduling, and publishing — all orchestrated through Postiz.

📎

From Any Chat App

Paperclip assigns specialized agents to ...

Paperclip assigns specialized agents to each step of your social media workflow — content creation, review, scheduling, and publishing — all orchestrated through Postiz.

Paperclip

Content Agent: Drafted a post about
  the feature launch for X.

Review Agent: Approved with minor
  edits. Ready to publish.

Scheduling Agent: Found X
  integration via Postiz.
  Scheduled for tomorrow 9:00 AM.

  Post ID: abc-123
  Status: Scheduled

📎

Scheduled & Proactive

Paperclip orchestrates recurring co...

Paperclip orchestrates recurring content pipelines. Set up agent teams that automatically create, review, and publish content on a schedule.

paperclip.yaml (pipeline)

pipelines:
  daily_social:
    schedule: "0 9 * * 1-5"
    agents:
      - role: content_creator
        task: "Draft an X post
          about trending industry topics"
      - role: reviewer
        task: "Review and polish the
          draft for engagement"
      - role: publisher
        task: "Schedule via Postiz
          for today at noon"

Why Paperclip + Postiz for X

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

✓Multi-agent teams for quality X content — draft, review, publish
✓Single dashboard to monitor all social media automation
✓Orchestrated pipelines from content creation to publishing
✓Scheduled pipelines for hands-free daily posting
✓Cross-post to X + other platforms in a single pipeline
✓Open-source — fully customizable agent workflows

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including X
metadata:
  paperclip:
    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 works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do, 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: Done! Scheduled on X for
  tomorrow at 9:00 AM.

X + Other Platforms

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

Example

> Post "Excited to announce our new feature!" to
  X and LinkedIn tomorrow at 9am, then schedule
  a daily tip on X every weekday at 10am

Paperclip: Done! Scheduled:
  - X + LinkedIn: tomorrow 9:00 AM
  - Daily tips on X: Mon-Fri 10:00 AM

Reply Options

Everyone

everyone

Following

following

Mentioned Users

mentionedUsers

Subscribers

subscribers

Verified

verified

What can you ask Paperclip to do on X (Twitter)?

You assign a task in plain language and the agent translates it into Postiz calls with the right X (Twitter) settings. These are prompts people actually give a Paperclip agent for X (Twitter).

Thread with reply controls

Ask Paperclip

> Turn docs/changelog.md into a 5-tweet thread
  for X, only people I follow can reply,
  schedule it for Tuesday at 10am

Paperclip: Thread drafted (5 posts), reply setting:
  following. Scheduled on X for Tue 10:00 AM.

Community post

Ask Paperclip

> Post our launch announcement to the
  Indie Hackers X Community with launch.png

Paperclip: Uploaded launch.png and posted to the
  community URL you set. Everyone can reply.

Recurring content

Ask Paperclip

> Every weekday at 9am, post one tip from
  tips.md to X and skip tips already used

Paperclip: Added a daily X tip to the schedule,
  Mon-Fri 9:00 AM, tracking used tips.

What X (Twitter) rules should the agent follow?

X (Twitter) rejects posts that break its limits, so the agent needs these constraints up front. Put them in the task or in your Paperclip agent's instructions.

✓Standard X accounts are limited to 280 characters per post. Ask Paperclip for a thread when your content is longer and Postiz publishes it as linked posts.
✓who_can_reply_post is required on every X post: everyone, following, mentionedUsers, subscribers, or verified.
✓To post into an X Community, give Paperclip the community URL (the community setting). Your account must already be a member.
✓Attach up to four images per post. Videos are uploaded through Postiz first, then attached to the scheduled post.

Paperclip and X (Twitter): frequently asked questions

Short answers to the questions teams ask before letting a Paperclip agent post to X (Twitter) through Postiz.

How do I post to X from Paperclip?

Install the Postiz skill (npx skills add gitroomhq/postiz-agent) in the environment your Paperclip agent runs in, set POSTIZ_API_KEY, and connect your X account inside Postiz. Then assign the agent a task such as "post this thread to X tomorrow at 9am" and it calls the Postiz CLI to schedule it.

Can a Paperclip agent post threads to X?

Yes. Ask for a thread, or hand the agent a long document, and it splits the content into ordered posts that Postiz publishes as a native X thread. Each post in the thread can carry its own image or video, and the same reply setting applies to the whole thread.

How does Paperclip control who can reply to my tweets?

Every X post created through Postiz carries a who_can_reply_post value. Say "only followers can reply" or "verified accounts only" in the task and the agent maps it to following or verified. If you say nothing, the agent should ask or default to everyone, so be explicit in the task.

Can Paperclip post to X on a schedule without me?

Yes, with a human in the loop. Paperclip wakes agents on heartbeats and Postiz schedules posts for exact times, so a daily X routine runs unattended. Use Paperclip's approval workflows so a reviewer agent or a person signs off before anything is published under your brand.

Does Paperclip need X API keys to post?

No. You connect X to Postiz once with OAuth in the Postiz dashboard. Your Paperclip agents only need a Postiz API key (Settings, Developers, Public API) or a CLI login via postiz auth:login. X credentials never live in the agent's environment.