search-x

What This Skill Does

The search-x skill provides OpenClaw agents with powerful, real-time access to the X (formerly Twitter) platform. It functions as a bridge between your AI agent and the pulse of public discourse, allowing the agent to fetch tweets, identify trending topics, and explore community sentiment on specific subjects. The skill supports two distinct operational modes: the default xAI Grok mode, which leverages advanced AI-driven search for deeper analysis and up to 30 days of historical coverage, and the native X API mode, which provides raw, structured data access up to 7 days for users requiring direct programmatic integration.

Installation

To integrate this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/blueberrywoodsym/x-twitter-search

Ensure your environment is configured for your chosen search mode. For xAI mode, set your XAI_API_KEY obtained from the xAI console. For direct X API usage, export your X_BEARER_TOKEN. These configurations allow the skill to authenticate requests and interact seamlessly with the platform APIs.

Use Cases

This skill is highly versatile for developers and content creators alike. It is excellent for social media monitoring, allowing agents to alert you about breaking news or competitor updates. Researchers can use it to aggregate discussions on technical topics, such as AI breakthroughs or software library releases. Furthermore, it serves as a powerful research assistant that can synthesize disparate opinions into concise reports or actionable summaries, saving hours of manual scrolling and filtering.

Example Prompts

1. "Check what the developer community is saying about the latest Claude Code release on X this week."
2. "Find and summarize the most engagement-heavy tweets from @OpenAI regarding their new model updates from the last 3 days."
3. "What are the top trending conversations around autonomous agents today? Give me a quick summary and include links to the original posts."

Tips & Limitations

To maximize efficiency, leverage the filtering options provided. Use --days to narrow your time window, which helps in managing token usage and result relevance. The --compact or --links-only flags are particularly useful if your agent needs to process large volumes of data without cluttering the context window. Keep in mind that X API mode is subject to pay-per-use billing, whereas Grok mode provides broader, AI-curated intelligence. Always review the output of agentic searches to ensure accuracy in data interpretation, especially when dealing with nuanced social media discussions.