ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified social Safety 4/5

X-Publisher

Publish tweets to X (Twitter) using the official Tweepy library. Supports text-only tweets, tweets with images or videos, and returns detailed publish results including tweet ID and URL. Requires X API credentials (API Key, API Secret, Access Token, Access Token Secret).

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/alphafactor/x-publisher
Or

What This Skill Does

The X-Publisher skill is a specialized OpenClaw agent tool designed to streamline social media management by integrating directly with the official X (formerly Twitter) API via the Tweepy library. It allows your agent to perform authenticated posting, enabling seamless automation of text, image, and video content publication. This skill handles the complexities of media uploading, authentication protocols, and error management, returning structured JSON results that verify post success, provide unique tweet URLs, and confirm precise timestamps.

Installation

To integrate this skill into your environment, use the OpenClaw hub CLI by executing: clawhub install openclaw/skills/skills/alphafactor/x-publisher. After installation, ensure you have the Tweepy library installed (pip3 install tweepy). You must then provision your X API credentials (API Key, Secret, Access Token, and Secret) and export them as environment variables in your terminal profile (e.g., ~/.zshrc or ~/.bashrc) to ensure the agent can securely authenticate against the platform.

Use Cases

This skill is perfect for automated social media marketing, content syndication, and real-time monitoring alerts. Use it to automatically tweet updates from internal dashboards, announce newly generated AI research or project results, or keep followers updated with consistent media-rich content without manual intervention. It serves as an essential bridge between your local data processing workflows and your public digital identity.

Example Prompts

  1. "X-Publisher, post a new update saying 'We just launched the new version of OpenClaw!' and attach the graph image from /results/final_plot.png."
  2. "Check if my X account is still authorized using the verify tool, then publish this short video from /videos/demo.mp4 with the caption 'Check out our new UI'."
  3. "Summarize the recent project analysis and post it to my Twitter account as a text-only update."

Tips & Limitations

When using X-Publisher, be mindful of platform constraints: you are limited to a maximum of 4 images or 1 video per post. Media files must adhere to file size limits—5MB for images and 512MB for video. Additionally, be aware of X’s rate limits; the API typically restricts users to 300 posts every 15 minutes. Always test your configuration with the verify command before scheduling automated posts to ensure your credentials have sufficient permissions and have not expired. Keep your environment variables secure and never hardcode keys directly into your scripts.

Metadata

Stars3992
Views3
Updated2026-04-10
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-alphafactor-x-publisher": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#twitter#automation#social-media#tweepy#marketing
Safety Score: 4/5

Flags: external-api, file-read