Search X is a real-time Twitter search tool powered by Grok-4 that allows AI agents to find tweets, trends, and discussions with verified citations.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install search-x
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 search-x 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 Search X?
Search X leverages the xAI API and the Grok-4 model to provide agentic search capabilities directly within the Openclaw Skills ecosystem. It enables users to fetch live data from the X platform, including tweet text, user handles, timestamps, and direct URLs for citations. This skill is particularly valuable for developers building agents that need current information or sentiment analysis from social media.
By integrating the x_search tool, Search X goes beyond simple API calls to provide nuanced search results, including image results and structured citations. This makes it an essential addition to any developer's toolkit when using Openclaw Skills to monitor social trends or research specific topics.
Search X Use Cases
- Monitor breaking news and real-time trends on X.
- Research specific user handles or official announcements.
- Conduct sentiment analysis on topics using recent tweet data.
- Filter social discussions by date range or specific user groups.
- Verify information through direct citations and tweet links.
How Search X Works
- The user provides a query or trigger such as "search twitter" or "find tweets."
- The skill invokes the xAI Responses API using the grok-4-1-fast model.
- The x_search tool processes the request to find relevant real-time tweets.
- Results are filtered based on parameters like time (days) or specific handles provided in the command.
- The skill returns a structured response containing tweet content, author info, and verification links.
Search X Setup
To get started with this skill within the Openclaw Skills framework, you need to configure your xAI API key.
openclaw config set skills.entries.search-x.apiKey "xai-YOUR-KEY"
Alternatively, you can set an environment variable:
export XAI_API_KEY="xai-YOUR-KEY"
You can obtain your credentials at the xAI console.
Search X Data Schema & Taxonomy
The skill returns data in a structured format, primarily focusing on the tweet object.
| Field | Description |
|---|---|
| @username | The display name and handle of the tweet author |
| content | The full text of the tweet |
| date/time | Timestamp of when the tweet was posted |
| link | Direct URL to the tweet for citation |
| images | URL for image results returned by Grok-4.20 |
Search X Advanced Features
- Supports time-based filtering using the
--daysflag for historical or trending data. - Advanced user filtering with
--handlesto include or--excludespecific accounts. - Multiple output formats including
--jsonfor raw data and--compactfor readable tweet lists. - Citation-ready responses to ensure AI transparency and factual verification.
- Model override capability via the
SEARCH_X_MODELenvironment variable for specialized tasks.
SKILL.md
Loading
Related Openclaw Skills
Remotion Server
A headless video rendering engine for Linux that uses Remotion v5 and Chrome Headless Shell to generate professional videos from React templates.
Polymarket Prediction Trading
A comprehensive tool for monitoring odds and executing trades on the world's largest prediction market directly from your AI agent.
Manus AI Agent
An autonomous AI agent skill that browses the web, executes complex tools, and delivers complete work products like reports and code.
Granola
A powerful integration to bridge Granola AI meeting notes with automated workflows and AI agents for enhanced context retrieval.
Spotify Web API
A cross-platform skill allowing AI agents to control Spotify playback, search tracks, and analyze listening history via the official Web API.
Supabase
A dedicated skill for querying Supabase project analytics, user signups, and database metadata directly through your AI agent.
METADATA
Featured*
