xai-search

What This Skill Does

The xai-search skill integrates the powerful Grok API into your OpenClaw environment, enabling high-performance, agentic search capabilities across both the live web and X (formerly Twitter). By leveraging Grok's native tool-calling features, this skill allows your AI agent to fetch real-time data, current events, and social sentiment with high accuracy. Unlike basic search tools, this skill supports advanced filters such as domain restriction, specific user handle filtering, and date-range constraints. It is designed to be the primary interface for any task requiring up-to-date information, bridging the gap between static LLM knowledge and the ever-changing digital landscape. Whether you are performing market research, tracking social media trends, or looking for verified news, this skill provides a robust architecture to process and synthesize complex, multi-source queries effectively.

Installation

To integrate xai-search into your workflow, ensure you have your XAI_API_KEY configured in your environment variables. Install the required dependencies using pip install xai-sdk. Once configured, you can add this skill to your OpenClaw library by executing: clawhub install openclaw/skills/skills/aydencook03/xai-search. This command pulls the latest stable version and registers the skill within your agent's capability set. You can verify the installation by testing the helper script located in ~/.clawdbot/skills/xai-search/scripts/xai-search.py using the both mode to ensure connectivity to the xAI endpoint.

Use Cases

This skill is ideal for tasks requiring external verification and real-time awareness. Use it for: 1. Real-time News Aggregation: Tracking breaking events as they unfold on X. 2. Sentiment Analysis: Gauging community reactions to product launches or policy changes by filtering for specific X handles. 3. Research Synthesis: Browsing reliable web sources while excluding untrusted domains. 4. Content Verification: Using the enable_image_understanding features to allow the agent to reason about visuals accompanying news or social media posts.

Example Prompts

1. "Perform a web search for the latest updates on the OpenClaw v2 release and summarize the key technical changes."
2. "Search X for the latest discourse regarding AI agent frameworks, filtering for tech influencers, and tell me what the general consensus is."
3. "Find articles published between 2024-01-01 and 2024-12-31 about renewable energy trends, excluding results from blog-aggregator sites."

Tips & Limitations

• For maximum speed, default to grok-3-fast. For deep analysis and reasoning on complex search results, switch to grok-4-1-fast.
• If a search is returning too much noise, utilize the excluded_domains or excluded_x_handles parameters to refine your signal.
• Note that this skill requires an active API connection; ensure your network permits traffic to the xAI v1 endpoint.