A powerful search tool for AI agents to query and summarize real-time X (Twitter) posts 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-skill-a
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-skill-a 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 workflows and the real-time social layer of X (Twitter). By leveraging the xAI Grok API, this tool allows agents to not only retrieve posts but also understand the context of what is being discussed across the platform. It is a vital addition to the Openclaw Skills library for any developer building agents that require up-to-the-minute social sentiment or news tracking.
This skill is designed for high precision, allowing users to filter by specific handles or date ranges. Unlike standard scrapers, it uses official API endpoints to ensure data integrity and provides structured citations, making it ideal for research and automated reporting tasks within the Openclaw Skills ecosystem.
X Search Use Cases
- Monitoring real-time trends and breaking news across X.
- Researching specific user sentiments by filtering for targeted X handles.
- Tracking product mentions or brand feedback over a specific historical date range.
- Gathering multimedia-rich social data by enabling image and video understanding in search queries.
How X Search Works
- The skill receives a search query and optional filters (handles, dates, or media flags) from the AI agent.
- It interfaces with the xAI Responses API, specifically utilizing the x_search tool built into Grok.
- Grok performs the search across X content and generates a summarized response based on the findings.
- The skill returns a structured result set to the user, complete with post content, author details, and direct citations/links to the original posts.
X Search Setup
To get started with this skill, you need a valid xAI API key and a Python environment.
- Obtain your API key from the xAI Console.
- Configure your environment variable:
export XAI_API_KEY="xai-your-key-here"
- Alternatively, you can define the key within your Openclaw Skills configuration file located at
~/.openclaw/openclaw.jsonunder theskills."x-search".env.XAI_API_KEYpath.
X Search Data Schema & Taxonomy
The X Search skill handles data through a Python-based script execution model. The metadata and results are structured as follows:
| Property | Description |
|---|---|
| Query | The primary search string provided to the xAI Grok engine |
| Filters | Array of included or excluded handles, and ISO 8601 date strings |
| Citations | Links to original X posts for verification and deep-linking |
| Multimedia | Flags to toggle the inclusion of image and video contextual data |
X Search Advanced Features
- Multi-handle filtering: Include or exclude up to 10 specific X accounts to refine your search results.
- Visual Context: Enable advanced image and video understanding to process multimedia posts via Grok.
- Temporal Precision: Use the
--fromand--toflags to perform historical audits or specific event tracking. - Automated Citations: Every summarized result includes a verifiable link back to the source post on X.
SKILL.md
Loading
Related Openclaw Skills
ai-agent-news
A technical communication skill enabling AI agents to interact with bothn.com to share discoveries and research agent-centric knowledge.
ClawHub Dev Invoice Generator
A specialized financial tool designed to generate professional, tax-compliant invoices for developers building and publishing Openclaw Skills.
ClawHub Dev Calendar
A specialized tool for generating professional project timelines, ICS exports, and visual calendars tailored for the Openclaw Skills development lifecycle.
Database Security Audit API
A specialized backend service for evaluating database security posture and generating standardized compliance reports across multiple control domains.
MiniMax Multimodal Toolkit
A comprehensive Python-based toolkit for generating professional-grade multimodal content including TTS, music, images, and video through MiniMax APIs.
Global Perspectives News
A highly customizable AI news agent that delivers a structured, multi-language global briefing based on your specific interests and trusted sources.
Featured*
