A professional-grade bridge for AI agents to interact with the official X API via Cloudflare Workers and OAuth 1.0a.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install rey-x-api
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 rey-x-api 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 rey-x-api (X/Twitter API Integration)?
The rey-x-api skill provides a robust and secure way for AI agents to post content to X (formerly Twitter) using official API endpoints. Unlike browser automation methods, this skill utilizes a backend architecture where Cloudflare Workers handle OAuth 1.0a signing, ensuring that sensitive credentials remain protected. It is a core component for developers building automated social media workflows within the Openclaw Skills ecosystem.
By prioritizing reliability and official API compliance, this skill enables high-frequency posting, thread creation, and media management. It is designed for business-critical applications where stability is paramount, offering a much lower risk of account suspension compared to unofficial automation methods. Integrating this into your Openclaw Skills setup allows for seamless transition from content generation to social distribution.
rey-x-api (X/Twitter API Integration) Use Cases
- Automating business announcements and news updates directly from an AI agent.
- Generating and publishing multi-tweet threads for long-form technical content.
- Deleting or managing tweets programmatically based on specific triggers.
- Building sophisticated social media bots that respond to mentions or trends using Openclaw Skills.
- Integrating social media output into automated DevOps or analytics pipelines.
How rey-x-api (X/Twitter API Integration) Works
- The AI agent or user initiates a request to the designated Workers API endpoint (e.g., /x/tweet).
- The Cloudflare Worker validates the request using a pre-configured CDP_SECRET.
- The Worker retrieves the X API credentials from its secure environment variables.
- An OAuth 1.1/2.0 signature is generated server-side to authorize the request.
- The Worker communicates with the official X API to execute the post, thread, or deletion.
- A JSON response containing the tweet ID and live URL is returned to the Openclaw Skills interface.
rey-x-api (X/Twitter API Integration) Setup
To deploy this skill, you must configure your environment variables within Cloudflare Workers:
# Set these secrets in your Cloudflare Workers dashboard
X_API_KEY="your_consumer_key"
X_API_SECRET="your_consumer_secret"
X_ACCESS_TOKEN="your_access_token"
X_ACCESS_TOKEN_SECRET="your_access_token_secret"
CDP_SECRET="your_api_authentication_secret"
Ensure your X Developer App has Read and Write permissions enabled for OAuth 1.0a to support posting functionality within Openclaw Skills.
rey-x-api (X/Twitter API Integration) Data Schema & Taxonomy
The skill interacts with the following data structures and endpoints:
| Endpoint | Method | Description |
|---|---|---|
/x/status |
GET | Verifies API connectivity and credentials. |
/x/tweet |
POST | Publishes a single tweet (max 280 characters). |
/x/thread |
POST | Posts a sequence of connected tweets as a thread. |
/x/tweet/:id |
DELETE | Removes a specific tweet by its ID. |
Response Schema (Success):
success: booleandata: Object containing tweetidandtexturl: The direct link to the published post on x.com
rey-x-api (X/Twitter API Integration) Advanced Features
- Official OAuth 1.0a Signature Generation: Handles complex authentication server-side for maximum security.
- Threading Engine: Automatically links multiple tweets using the reply_to parameter to create seamless threads.
- Media Support: Capabilities for uploading and attaching media via the 1.1/media/upload endpoint.
- Integrated Error Handling: Provides specific feedback for rate limits (429), auth errors (401), and permission issues (403).
- Multi-Skill Synergy: Easily pairs with other Openclaw Skills like nano-banana for AI image generation or trend-analyzer for smart posting.
SKILL.md
Loading
Related Openclaw Skills
Web Search (rey-web-search)
A high-performance search skill that enables AI agents to retrieve, rank, and summarize real-time information from the live web in seconds.
Social Scheduler (rey-social-scheduler)
A multi-platform social media management tool for automated scheduling, bulk posting, and engagement analytics across major networks.
Skill Creator for Openclaw
An interactive framework designed to build, validate, and deploy standardized Openclaw Skills according to official best practices.
Screenshot (Autonomous Capture)
An autonomous visual capture tool designed to snapshot websites, dashboards, and terminal outputs for professional documentation and social media content.
Root Cause Tracing
A comprehensive diagnostic skill utilizing 5 Whys, fault tree analysis, and dependency tracing to find the true origin of system issues.
SaaS Builder
A comprehensive framework for planning, developing, and launching Micro-SaaS products focused on niche markets and recurring revenue.
Featured*
