A comprehensive X/Twitter CLI toolkit for AI agents that enables full platform interaction via cookie-based authentication without requiring official API keys.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install x-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install x-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is x-cli?
x-cli is a high-performance, developer-focused toolkit designed to empower AI agents with full X (formerly Twitter) capabilities. Built on the twikit library, it allows for seamless platform interaction by utilizing cookie-based authentication, effectively bypassing the complexities and costs associated with official API access. This makes it a premier choice for developers looking to expand their Openclaw Skills library with social media intelligence.
The skill provides a modular suite of scripts that cover the entire X ecosystem. From reading complex threads and monitoring timelines to posting rich-media tweets and managing direct messages, x-cli ensures that your agent can act as a fully autonomous participant on the platform while maintaining a low technical barrier to entry.
x-cli Use Cases
- Automating social media engagement and community management.
- Building real-time news aggregators and trend monitoring bots.
- Researching user highlights and thread analysis for data extraction.
- Managing brand presence through scheduled posts and automated replies.
- Curating and managing X Lists and followers for targeted networking.
How x-cli Works
- Authentication Setup: The user configures a config.json file with account cookies or login credentials.
- Session Validation: The x_auth.py script validates the session to ensure the agent is authenticated without needing a developer portal account.
- Command Routing: The agent invokes specific Python scripts (e.g., x_read.py, x_post.py) based on the desired interaction.
- Data Processing: The toolkit fetches raw data from X and converts it into either human-readable text or structured JSON.
- Action Execution: Commands are executed on the platform, including likes, retweets, and DMs, with optional dry-run safety checks for posting.
x-cli Setup
To get started with this skill, follow these installation steps:
# Install required Python dependencies
pip install -r scripts/requirements.txt
# Set up configuration
cp config.example.json config.json
# Configure your cookies or credentials in config.json and login
python scripts/x_auth.py login
x-cli Data Schema & Taxonomy
The x-cli skill organizes data for optimal compatibility within the Openclaw Skills ecosystem. Output can be toggled between plain text and structured JSON.
| Component | Output Details |
|---|---|
| Tweets | Includes text, media IDs, reply context, and author metadata |
| User Info | Metadata including follower counts, bios, and highlight status |
| Timelines | Supports Home, For You, and User-specific timelines |
| Search | Query-based results with support for advanced search operators |
| Trends | Category-specific trending topics and volume |
x-cli Advanced Features
- No-API-Key Architecture: Uses cookie-based auth for unrestricted access.
- Media Support: Upload and attach images or videos to tweets and replies.
- Proxy Integration: Built-in support for HTTP proxies via the configuration file.
- Thread Management: Capability to read and reconstruct entire tweet threads.
- Interactive Polls: Create and manage polls with customizable durations.
- Structured JSON Output: Ideal for passing data between multiple agents in the Openclaw Skills framework.
SKILL.md
Loading
Related Openclaw Skills
Alexa Remote Control
A command-line interface skill for controlling Amazon Echo devices and smart home integrations using shell scripts.
SwiftUI Empty App Init
A lightweight skill to bootstrap a single-target SwiftUI iOS application using XcodeGen for version-control-friendly project management.
Image OCR Reader
A robust OCR utility that extracts Chinese and English text from images using the Tesseract engine for AI-driven workflows.
tRPC Integration
Openclaw Skills for tRPC provide expert guidance for building end-to-end typesafe APIs without the need for schemas or code generation.
Dexter
Dexter is an autonomous agent designed to plan and execute complex financial data analysis for stocks, crypto, and company fundamentals.
Context Builder
An agentic CLI tool that converts entire directories into structured, relevance-sorted markdown files optimized for LLM ingestion and token efficiency.
Featured*
