bird

What This Skill Does

The bird skill is a powerful command-line interface (CLI) for OpenClaw that serves as a direct gateway to X (formerly Twitter). It provides comprehensive capabilities for reading public posts, searching global trends and topics, and interacting with the platform via threads, replies, and new tweets. Unlike standard web scraping tools, bird is designed for agentic workflows, allowing your AI assistant to perform deep social research or manage personal accounts. It supports dual authentication pathways: leveraging your existing local browser cookies for seamless access or utilizing the Sweetistics API for robust, scalable interactions. By abstracting the complex X API protocols into simple commands, bird transforms your terminal into a social intelligence hub.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/soanai/xbio

Once installed, ensure your authentication is configured by running bird check. If you intend to use the Sweetistics engine, export your API key in your environment variables using export SWEETISTICS_API_KEY='your_key_here' or specify --engine sweetistics during execution.

Use Cases

• Social Listening: Automatically search for mentions of your project or brand and summarize the sentiment.
• Content Curation: Read complex threads and extract key insights or action items for your research notes.
• Account Management: Schedule or draft tweets and engage with community replies directly from your automated workflow.
• Research Aggregation: Use the -n flag to pull multiple search results and perform batch data analysis on trending topics.

Example Prompts

• "bird search 'OpenClaw AI' -n 10 and give me a summary of what people are saying."
• "bird read https://x.com/username/status/123456789 and extract the main points into a list."
• "bird tweet 'I just automated my social presence using OpenClaw!'"

Tips & Limitations

When using bird, always verify your authentication status first to prevent errors. Note that when posting or replying, the skill will prompt for confirmation; treat these actions with care. For high-volume usage, the Sweetistics API is highly recommended over local browser cookies to avoid potential platform rate-limiting or security challenges. Remember that public data availability can change based on platform policy updates, so always check the source repository for recent patches.