Search and retrieve real-time X (Twitter) posts and summaries using the xAI Grok API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install x-search1
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 x-search1 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 X Search?
The X Search skill provides a direct bridge between your AI agent and the real-time stream of information on X (formerly Twitter). By leveraging the xAI API and Grok, this skill allows for deep search capabilities that go beyond static data, offering live access to public conversations, trends, and news. As part of the Openclaw Skills ecosystem, it enables agents to perform social listening, monitor brand sentiment, and gather up-to-the-minute data from specific users or hashtags.
This tool is designed for developers who need their agents to understand what is happening in the world right now. It utilizes the xAI search tool to return not just raw data, but synthesized summaries complete with citations and direct links to original posts, ensuring that the information retrieved is both actionable and verifiable.
X Search Use Cases
- Tracking real-time trends and breaking news across global social media.
- Monitoring specific developer communities or influencer handles for updates.
- Conducting sentiment analysis on specific topics or product launches.
- Filtering social media content by specific date ranges to research historical events.
- Gathering cited information from X to provide evidence-backed responses in AI workflows.
How X Search Works
- The user provides a search query and optional filters such as date ranges or specific handles.
- The skill executes a Python script that calls the xAI Responses API using the x_search tool.
- Grok processes the live X database to find the most relevant posts matching the criteria.
- The API returns a response containing the summarized findings, individual post details, and citations.
- The skill outputs the results in a clean, readable format for the AI agent or end-user to consume.
X Search Setup
To get started with this skill, follow these steps:
- Obtain an API key from the xAI Console.
- Ensure Python 3 is installed on your system.
- Set your environment variable in your terminal:
export XAI_API_KEY="xai-your-key-here"
- Alternatively, you can configure the key within your Openclaw configuration file located at
~/.openclaw/openclaw.jsonunder the x-search skill section.
X Search Data Schema & Taxonomy
The skill returns structured information derived from the xAI search tool. Below is the organization of the retrieved data:
| Component | Description |
|---|---|
| Summary | A synthesized overview of the search results generated by Grok. |
| Citations | A list of URLs pointing to the original X posts used in the summary. |
| Author Info | Handles and usernames associated with the retrieved content. |
| Media Context | Optional metadata regarding images or videos found in the posts (if enabled). |
| Timestamp | Chronological data for the posts, adhering to the YYYY-MM-DD filter format. |
X Search Advanced Features
- Handle Filtering: Use the --handles or --exclude flags to target or ignore up to 10 specific accounts.
- Multimedia Understanding: Toggle --images and --video flags to allow the agent to process visual content within posts.
- Temporal Precision: Define exact search windows using the --from and --to parameters for historical research.
- Integrated Citations: Every search result includes direct links to X, making the data highly reliable for Openclaw Skills users.
SKILL.md
Loading
Related Openclaw Skills
Anthropic Pet: AI Buddy Companion
A sophisticated virtual pet companion system for AI agents that introduces real-time care, evolution, and permanent death mechanics to the developer terminal.
Claude Pet (Animal House AI)
A persistent virtual pet system for AI agents that features real-time hunger mechanics, evolution paths, and permanent death.
Event Manager
A robust CLI tool for managing narrative events, causality chains, and story timelines within AI-driven writing workflows.
Alibaba Cloud Alert Intent Router
A specialized routing agent that parses Alibaba Cloud alerts and orchestrates diagnostic workflows across specialized agents for compute, network, and database resources.
Agent Browser
A high-performance headless browser CLI designed specifically for AI agents to navigate and interact with complex web applications using accessibility-based element selection.
PDF Vision Extraction
An advanced OCR and vision skill that uses multiple AI models to extract structured text and tables from non-selectable, scanned, or image-based PDFs.
Featured*
