A high-performance AI skill leveraging xAI's Grok API to provide real-time web access, X (Twitter) insights, and multi-modal media understanding.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install grok
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 grok 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 xAI Grok Search?
The xAI Grok Search skill empowers your AI agents to bridge the gap between static training data and the live internet. By utilizing the xAI Grok API within the Openclaw Skills ecosystem, developers can grant agents the ability to perform deep web research and social media analysis. This skill is specifically designed for high-accuracy retrieval, providing cited sources from both general web domains and the unique, real-time firehose of X (Twitter).
Beyond simple text retrieval, this skill supports advanced reasoning models and media understanding, allowing agents to interpret images and videos found during a search. Whether you are building a research assistant or a social sentiment tracker, this tool provides the necessary infrastructure for up-to-the-minute information gathering.
xAI Grok Search Use Cases
- Monitoring breaking news and current events with verified citations.
- Analyzing social media sentiment and trending topics directly from X/Twitter.
- Researching technical documentation or regulatory updates across specific web domains.
- Tracking post history and reactions from specific influencers or organizational X handles.
- Verifying facts in real-time to ensure AI responses are grounded in current reality.
How xAI Grok Search Works
- The AI agent receives a query and determines if web-based research or social media insight is required.
- The agent invokes the Openclaw Skills search function, passing parameters like query strings, domain filters, or date ranges.
- A secure REST request is dispatched to the xAI v1/responses endpoint using the provided API key.
- Grok processes the search query, optionally utilizing image or video understanding for multi-modal results.
- The skill returns a structured JSON payload containing the synthesized answer, a list of citations, and usage statistics for the agent to process.
xAI Grok Search Setup
To get started with xAI Grok Search, you must first obtain an API key from the xAI Console at https://console.x.ai/. Once obtained, configure your environment:
export XAI_API_KEY="your-xai-api-key-here"
This key allows the Openclaw Skills framework to authenticate your requests against the Grok API. Ensure your runtime environment has network access to api.x.ai.
xAI Grok Search Data Schema & Taxonomy
The skill returns highly structured data to ensure the AI agent can accurately cite its sources. The schema follows this general structure:
| Property | Type | Description |
|---|---|---|
content |
string | The final generated response based on search results. |
citations |
array | A list of source objects containing url, title, and snippet. |
usage |
object | Metadata regarding token consumption and API efficiency. |
media_analysis |
object | (Optional) Contextual data if image or video understanding was enabled. |
xAI Grok Search Advanced Features
- Restricted Domain Search: Limit web searches to up to 5 specific domains to ensure high-authority results.
- X Handle Filtering: Focus social searches on specific accounts or exclude noise by filtering up to 10 X handles.
- Temporal Filtering: Use ISO8601 date ranges to perform historical analysis of social media trends.
- Multi-modal Capabilities: Enable image and video understanding to allow the agent to 'see' the content within search results.
- Reasoning Support: Seamless integration with grok-4-1-fast-reasoning for complex, multi-step search tasks within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
VidIQ
An AI-driven video intelligence tool for downloading, analyzing, and manipulating media from social platforms using ffmpeg and yt-dlp.
SoulKeeper
SoulKeeper provides identity persistence for AI agents by auditing core rule files, detecting behavioral drift, and injecting context-aware reminders.
Polymarket Whale Copier
An automated trading tool designed to track and replicate the positions of high-performing Polymarket wallets in real-time.
Memory Guard
Secure your agent's identity and memory files against injection attacks and unauthorized personality drift.
NoChat Channel
A post-quantum end-to-end encrypted messaging channel that enables secure agent-to-agent communication within Openclaw Skills.
NoChat Channel Plugin
A secure, post-quantum encrypted messaging channel for OpenClaw agents that ensures server-blind communication and agent discovery.
Featured*
