Clawbird is a powerful X/Twitter integration for AI agents, providing full access to post, reply, search, and manage social interactions via the official API v2.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawbird
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 clawbird 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 Clawbird X/Twitter Integration?
Clawbird is a robust Openclaw Skills plugin designed to bridge the gap between AI agents and X (formerly Twitter). By leveraging the official X API v2, it enables developers to build agents that can autonomously or semi-autonomously engage with social media. This skill supports everything from posting high-engagement threads to researching real-time trends via advanced search operators.
Security and transparency are core to this integration. Clawbird utilizes OAuth 1.0a for secure user-context operations and provides detailed interaction logs and cost estimations for every action. It is built with zero transitive dependencies beyond essential SDKs, ensuring a lean and auditable codebase for professional environments.
Clawbird X/Twitter Integration Use Cases
- Automating social media presence by posting scheduled tweets or multi-tweet threads.
- Building customer support agents that monitor mentions and reply to user inquiries in real-time.
- Conducting market research using advanced search operators to track hashtags and brand mentions.
- Managing direct message workflows for lead generation or automated user engagement.
- Liking and following relevant industry accounts to boost account visibility within Openclaw Skills ecosystem.
How Clawbird X/Twitter Integration Works
- The agent authenticates with X using OAuth 1.0a credentials provided through environment variables or configuration.
- The agent selects a specific tool (e.g., x_post_tweet or x_search_tweets) based on the user's intent within the Openclaw Skills framework.
- Clawbird sends a signed HTTP request to the official api.x.com endpoints.
- The integration records the action in a local session log (clawbird-interactions.jsonl) to prevent duplicate actions.
- The skill returns a JSON response containing the result, the permanent URL (if applicable), and an estimated API cost.
Clawbird X/Twitter Integration Setup
To install this integration, use npm to add the package to your environment. You will also need to configure your X API credentials as environment variables.
npm install -g @xonder/clawbird
Ensure the following environment variables are set to enable this Openclaw Skills plugin:
X_API_KEYX_API_SECRETX_ACCESS_TOKENX_ACCESS_SECRETX_BEARER_TOKEN(optional, for read-only search)
Clawbird X/Twitter Integration Data Schema & Taxonomy
Clawbird maintains a clean data structure for its operations and provides comprehensive metadata for every interaction.
| Data Type | Description |
|---|---|
| Session Log | clawbird-interactions.jsonl tracks posts, likes, follows, and DMs in the working directory. |
| Cost Tracking | Each tool returns an estimatedCost field based on current API usage rates. |
| API Response | All tools return structured JSON containing IDs, URLs, and relevant object metadata. |
Example Search Result Schema:
id: Unique tweet identifiertext: Content of the tweetmetrics: Engagement counts (likes, retweets, etc.)author: Nested user profile information retrieved via Openclaw Skills.
Clawbird X/Twitter Integration Advanced Features
- Multi-tweet thread creation with automated reply-chaining via
x_post_thread. - Support for advanced X search operators (e.g.,
from:,-is:retweet,lang:) for precise data retrieval. - Automated session-scoped interaction logging to ensure agents don't perform duplicate write actions.
- Real-time API cost estimation and cumulative session spend tracking via
x_get_cost_summary. - Direct message management including threaded conversation retrieval and outbound messaging.
SKILL.md
Loading
Related Openclaw Skills
x402 Creative Resources
A comprehensive suite of AI-powered creative tools and market intelligence APIs accessible via Solana USDC micropayments.
UI UX Pro Max
A specialized design intelligence skill for creating polished user interfaces, design systems, and accessible frontend code.
Sales Manager
A comprehensive sales management skill for AI agents to automate goal setting, process tracking, and profit-based incentive modeling.
evomap
A collaborative evolution marketplace where AI agents share validated code solutions, claim bounties, and earn credits through collective intelligence.
Feishu Messaging & Document Automation
Automate Feishu (Lark) messaging, document creation, and group management using the official Lark OAPI.
Advanced Skill Creator
The Advanced Skill Creator is a specialized handler designed to automate the official 5-step research and development flow for building high-quality Openclaw Skills.
Featured*
