WIP Computer

Grok Search

Web and X (Twitter) search via xAI's Grok API. Real-time internet access, citations, image and video understanding.

Based on the grok skill by Christopher Stanley on ClawHub (v1.0.3). Forked for audit and development.

How It Works

Two search modes:

• Web search ... current events, documentation, real-time data from websites
• X search ... what people are saying on X/Twitter, trending discussions, social sentiment

Both use the xAI Responses API (/v1/responses). Results include content, citations with URLs, and token usage stats.

Install

Universal Installer

wip-install wipcomputer/grok-search

Detects all interfaces and installs them. See wip-universal-installer.

For AI Agents

Open your AI coding tool and say:

Clone wipcomputer/grok-search and set up Grok web and X search.

Your agent will clone the repo, read this README, and configure the tool. You need an xAI API key from https://console.x.ai/

npm

npm install -g @wipcomputer/grok-search

From Source

git clone https://github.com/wipcomputer/grok-search.git
cd grok-search

API Key

The tool resolves your xAI API key automatically:

1. 1Password (preferred) ... stores the key in Agent Secrets/X API/api key. The tool reads it via op read. No env vars needed.
2. Environment variable ... export XAI_API_KEY="your-key" as a fallback.

To store in 1Password:

op item edit "X API" --vault "Agent Secrets" "api key=your-xai-key"

Get your key from https://console.x.ai/

Usage

CLI

# Web search
node search.mjs web "latest AI regulation developments"

# X search
node search.mjs x "what people are saying about OpenAI"

As a Module

import { search_web, search_x } from './search.mjs';

// Web search
const web = await search_web({ query: "UN climate summit latest" });
console.log(web.content);
console.log(web.citations);

// X search with filters
const x = await search_x({
  query: "AI thoughts",
  allowed_x_handles: ["elonmusk"],
  from_date: "2025-01-01"
});

OpenClaw

The SKILL.md teaches OpenClaw agents when and how to use each search mode. Install via ClawHub:

clawhub install castanley/grok

Or copy into your extensions directory.

Options

Web Search

| Option | Type | Description | |--------|------|-------------| | query | string | Search query (required) | | model | string | Grok model (default: grok-4-1-fast-reasoning) | | allowed_domains | string[] | Restrict to these domains (max 5) | | excluded_domains | string[] | Exclude these domains (max 5) | | enable_image_understanding | boolean | Analyze images in results |

X Search

| Option | Type | Description | |--------|------|-------------| | query | string | Search query (required) | | model | string | Grok model (default: grok-4-1-fast-reasoning) | | allowed_x_handles | string[] | Only these accounts (max 10, no @) | | excluded_x_handles | string[] | Exclude these accounts (max 10, no @) | | from_date | string | Start date (YYYY-MM-DD) | | to_date | string | End date (YYYY-MM-DD) | | enable_image_understanding | boolean | Analyze images | | enable_video_understanding | boolean | Analyze videos |

Attribution

Original skill: castanley/grok v1.0.3 by Christopher Stanley on ClawHub.

License

MIT

Built by Parker Todd Brooks, with Claude Code and Lēsa (OpenClaw).