x-search

# X Search Search X (Twitter) posts using the xAI Grok API with real-time access to X content. ## Setup 1. Get your API key: https://console.x.ai 2. Set environment variable: ```bash export XAI_API_KEY="xai-your-key-here" ``` 3. Or set `skills."x-search".apiKey` / `skills."x-search".env.XAI_API_KEY` in `~/.openclaw/openclaw.json` ## Usage ```bash python3 {baseDir}/scripts/search.py "what is trending in AI right now" ``` Useful flags: ```bash # Filter by handles (max 10) python3 {baseDir}/scripts/search.py --handles jaaneek,OpenClaw "latest posts" # Exclude handles (max 10) python3 {baseDir}/scripts/search.py --exclude spambot,crypto_shill "trending AI" # Date range (YYYY-MM-DD) python3 {baseDir}/scripts/search.py --from 2026-03-01 --to 2026-03-20 "xAI grok updates" # Enable image/video understanding in posts python3 {baseDir}/scripts/search.py --images --video "product demos" ``` ## Notes - Uses the xAI Responses API with `x_search` tool (Grok performs the search and summarizes results) - Cannot use `--handles` and `--exclude` at the same time - Results include citations with links to original X posts - Present results in a readable format with post content, authors, and citations