Search X

--- name: search-x version: "1.1.0" description: Real-time X/Twitter search powered by Grok-4. Find tweets, trends, and discussions with citations. Grok-4.20 also returns image results alongside tweet citations. author: mvanhorn license: MIT repository: https://github.com/mvanhorn/clawdbot-skill-search-x homepage: https://docs.x.ai triggers: - search x - search twitter - find tweets - what's on x about - x search - twitter search metadata: openclaw: emoji: "🔍" requires: env: - XAI_API_KEY primaryEnv: XAI_API_KEY tags: - x - twitter - search - grok - real-time --- # Search X Real-time X/Twitter search powered by Grok's x_search tool. Get actual tweets with citations. ## Setup Set your xAI API key: ```bash openclaw config set skills.entries.search-x.apiKey "xai-YOUR-KEY" ``` Or use environment variable: ```bash export XAI_API_KEY="xai-YOUR-KEY" ``` Get your API key at: https://console.x.ai ## Commands ### Basic Search ```bash node {baseDir}/scripts/search.js "AI video editing" ``` ### Filter by Time ```bash node {baseDir}/scripts/search.js --days 7 "breaking news" node {baseDir}/scripts/search.js --days 1 "trending today" ``` ### Filter by Handles ```bash node {baseDir}/scripts/search.js --handles @elonmusk,@OpenAI "AI announcements" node {baseDir}/scripts/search.js --exclude @bots "real discussions" ``` ### Output Options ```bash node {baseDir}/scripts/search.js --json "topic" # Full JSON response node {baseDir}/scripts/search.js --compact "topic" # Just tweets, no fluff node {baseDir}/scripts/search.js --links-only "topic" # Just X links ``` ## Example Usage in Chat **User:** "Search X for what people are saying about Claude Code" **Action:** Run search with query "Claude Code" **User:** "Find tweets from @remotion_dev in the last week" **Action:** Run search with --handles @remotion_dev --days 7 **User:** "What's trending about AI on Twitter today?" **Action:** Run search with --days 1 "AI trending" **User:** "Search X for Remotion best practices, last 30 days" **Action:** Run search with --days 30 "Remotion best practices" ## How It Works Uses xAI's Responses API (`/v1/responses`) with the `x_search` tool: - Model: `grok-4-1-fast` (optimized for agentic search) - Returns real tweets with URLs - Includes citations for verification - Supports date and handle filtering ## Response Format Each result includes: - **@username** (display name) - Tweet content - Date/time - Direct link to tweet ## Environment Variables - `XAI_API_KEY` - Your xAI API key (required) - `SEARCH_X_MODEL` - Model override (default: grok-4-1-fast) - `SEARCH_X_DAYS` - Default days to search (default: 30)

存档时间线

版本索引永久保留；内容副本只保留最近 2 版，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本