Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Search X/Twitter and the web, chat with Grok models (text + vision), and analyze X content using xAI's API. Use when: searching X posts/threads, web research via Grok, chatting with Grok, analyzing voice patterns, researching trends, or checking post quality. Triggers: grok, xai, search x, search twitter, x search, ask grok, grok chat, analyze voice, x trends.
Search X/Twitter and the web, chat with Grok models (text + vision), and analyze X content using xAI's API. Use when: searching X posts/threads, web research via Grok, chatting with Grok, analyzing voice patterns, researching trends, or checking post quality. Triggers: grok, xai, search x, search twitter, x search, ask grok, grok chat, analyze voice, x trends.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Search X (Twitter), search the web, chat with Grok models (including vision), and analyze X content patterns using xAI's API.
X Search: Search posts, threads, and accounts with date/handle filters Web Search: Search the web via Grok's web_search tool Chat: Text and vision (image analysis) with Grok models Analysis: Voice patterns, trend research, post safety checks Models: List available xAI models
Get your xAI API key from console.x.ai. # Via clawdbot config (recommended) clawdbot config set skills.entries.xai-plus.apiKey "xai-YOUR-KEY" # Or environment variable export XAI_API_KEY="xai-YOUR-KEY" The scripts check these locations in order: XAI_API_KEY env var ~/.clawdbot/clawdbot.json โ env.XAI_API_KEY ~/.clawdbot/clawdbot.json โ skills.entries.xai-plus.apiKey ~/.clawdbot/clawdbot.json โ skills.entries["grok-search"].apiKey (fallback)
Override the default model (grok-4-1-fast): # Via config clawdbot config set skills.entries.xai-plus.model "grok-3" # Or environment variable export XAI_MODEL="grok-3" Model priority: Command-line --model flag (highest priority) XAI_MODEL env var ~/.clawdbot/clawdbot.json โ env.XAI_MODEL ~/.clawdbot/clawdbot.json โ skills.entries.xai-plus.model Default: grok-4-1-fast
Search X posts and threads with optional filters. Basic search: node {baseDir}/scripts/grok_search.mjs "query" --x With date filter: # Last 7 days node {baseDir}/scripts/grok_search.mjs "Claude AI" --x --days 7 # Specific date range node {baseDir}/scripts/grok_search.mjs "AI agents" --x --from 2026-01-01 --to 2026-01-31 Filter by handles: # Only from specific accounts node {baseDir}/scripts/grok_search.mjs "AI news" --x --handles @AnthropicAI,@OpenAI # Exclude accounts node {baseDir}/scripts/grok_search.mjs "GPT" --x --exclude @spam1,@spam2 Output formats: # JSON (default, agent-friendly) node {baseDir}/scripts/grok_search.mjs "query" --x # Links only node {baseDir}/scripts/grok_search.mjs "query" --x --links-only # Human-readable text node {baseDir}/scripts/grok_search.mjs "query" --x --text JSON output schema: { "query": "search query", "mode": "x", "results": [ { "title": "@handle", "url": "https://x.com/handle/status/123", "snippet": "Post text...", "author": "@handle", "posted_at": "2026-01-15T10:30:00Z" } ], "citations": ["https://x.com/..."] }
Search the web via Grok. node {baseDir}/scripts/grok_search.mjs "TypeScript best practices 2026" --web JSON output schema: { "query": "search query", "mode": "web", "results": [ { "title": "Page title", "url": "https://example.com/page", "snippet": "Description...", "author": null, "posted_at": null } ], "citations": ["https://example.com/..."] }
FlagDescriptionExample--xSearch X/TwitterRequired for X search--webSearch the webRequired for web search--days NLast N days (X only)--days 7--from YYYY-MM-DDStart date (X only)--from 2026-01-01--to YYYY-MM-DDEnd date (X only)--to 2026-01-31--handles a,bOnly these accounts (X only)--handles @user1,@user2--exclude a,bExclude accounts (X only)--exclude @spam--max NMax results--max 20--model IDOverride model--model grok-3--jsonJSON output (default)---links-onlyJust URLs---textHuman-readable---rawInclude debug output- See references/search-patterns.md for advanced query patterns and optimization tips.
Ask Grok anything. node {baseDir}/scripts/chat.mjs "What is quantum computing?" With model override: node {baseDir}/scripts/chat.mjs --model grok-3 "Explain transformers in ML" JSON output: node {baseDir}/scripts/chat.mjs --json "What is TypeScript?" JSON schema: { "model": "grok-4-1-fast", "prompt": "What is TypeScript?", "text": "TypeScript is...", "citations": ["https://..."] }
Analyze images with Grok. node {baseDir}/scripts/chat.mjs --image ./screenshot.png "What's in this image?" Multiple images: node {baseDir}/scripts/chat.mjs --image ./pic1.jpg --image ./pic2.jpg "Compare these" Supported formats: JPG, PNG, WebP, GIF
FlagDescriptionExample--model IDModel to use--model grok-2-vision-1212--image PATHAttach image (can repeat)--image ./pic.jpg--jsonJSON output---rawInclude debug output- See references/models.md for model comparison and capabilities.
Analyze X content for voice patterns, trends, and post quality.
Analyze an account's voice and writing patterns. node {baseDir}/scripts/analyze.mjs voice @username Custom date range: # Last 60 days node {baseDir}/scripts/analyze.mjs voice @username --days 60 JSON output schema: { "handle": "@username", "analyzed_posts": 150, "voice": { "tone": "casual, technical", "personality": ["curious", "direct", "helpful"], "perspective": "practitioner sharing lessons", "energy_level": "medium" }, "patterns": { "sentence_structure": ["short declarative", "occasional fragments"], "vocabulary": ["technical", "accessible"], "formatting_quirks": ["line breaks for emphasis", "minimal punctuation"], "recurring_phrases": ["here's the thing", "turns out"] }, "topics": ["AI", "software engineering", "startups"], "best_posts": [ { "url": "https://x.com/username/status/123", "text": "Post text...", "why": "Authentic voice, specific example" } ], "anti_patterns": ["never uses em-dashes", "avoids numbered lists"] }
Research trends and discussions about a topic. node {baseDir}/scripts/analyze.mjs trends "AI agents" JSON output schema: { "topic": "AI agents", "trends": [ { "pattern": "Shift from chatbots to autonomous agents", "description": "Discussion focuses on...", "example_posts": ["https://x.com/..."] } ], "perspectives": [ { "viewpoint": "Agents will replace most SaaS", "supporters": ["@user1", "@user2"] } ], "hashtags": ["#AIAgents", "#AutonomousAI"], "key_accounts": ["@researcher1", "@founder2"], "posting_angles": [ { "angle": "Practical implementation challenges", "hook": "Everyone talks about AI agents. Nobody talks about...", "target_audience": "Engineers building with AI" } ] }
Check a draft post or existing post for AI signals and platform flag patterns. Check draft text: node {baseDir}/scripts/analyze.mjs post "Your draft post text here" Check existing post: node {baseDir}/scripts/analyze.mjs post --url "https://x.com/user/status/123" JSON output schema: { "post_text": "Your post...", "ai_detection_score": 3, "ai_signals": [ "Contains em-dash", "Ends with engagement bait question" ], "platform_flag_score": 2, "platform_risks": [ "Generic question could trigger spam filter" ], "quality_score": 7, "suggestions": [ "Replace em-dash with period or comma", "Remove 'What do you think?' closer", "Add specific personal detail" ] } Scoring: AI Detection: 0-10 (10 = definitely AI) Platform Flag Risk: 0-10 (10 = high spam risk) Quality: 0-10 (10 = excellent)
FlagDescriptionExample--days NDate range for analysis--days 60--url URLAnalyze existing post--url https://x.com/...--model IDOverride model--model grok-3--jsonJSON output---rawInclude debug output- See references/analysis-prompts.md for detailed prompt structures and scoring criteria.
List available xAI models. node {baseDir}/scripts/models.mjs Output: grok-2-vision-1212 grok-3 grok-4-1-fast grok-4-fast JSON output: node {baseDir}/scripts/models.mjs --json Quick model comparison: ModelSpeedQualityVisionBest Forgrok-4-1-fastFastGoodNoDefault (search, chat, analysis)grok-4-fastFastGoodNoAlternative fast modelgrok-3SlowerBestNoComplex reasoning, detailed analysisgrok-2-vision-1212MediumGoodYesImage analysis See references/models.md for detailed model capabilities and use cases.
For X searches, the tool automatically deduplicates tweet URLs, preferring canonical /@handle/status/id over /i/status/id format.
Override the default model for any operation: # Search with grok-3 for better quality node {baseDir}/scripts/grok_search.mjs "complex query" --x --model grok-3 # Chat with vision model node {baseDir}/scripts/chat.mjs --model grok-2-vision-1212 --image pic.jpg "Describe" # Analysis with grok-3 for deeper insights node {baseDir}/scripts/analyze.mjs voice @username --model grok-3
Add --raw to any command to see the full API response: node {baseDir}/scripts/grok_search.mjs "query" --x --raw
API Reference - xAI API endpoints and parameters Search Patterns - Query patterns, filters, optimization tips Models - Model comparison and capabilities Analysis Prompts - Structured prompts and scoring criteria X Algorithm - Ranking, engagement weights, spam detection
# Find recent discussions node {baseDir}/scripts/grok_search.mjs "Claude Sonnet 4.5" --x --days 3 # Get trend analysis node {baseDir}/scripts/analyze.mjs trends "Claude Sonnet 4.5"
# Study the target account node {baseDir}/scripts/analyze.mjs voice @target_account --days 30 # Check your draft node {baseDir}/scripts/analyze.mjs post "Your draft here"
# Search web for context node {baseDir}/scripts/grok_search.mjs "TypeScript 5.7 features" --web # Ask follow-up node {baseDir}/scripts/chat.mjs "What are the key TypeScript 5.7 improvements?" # Analyze screenshot node {baseDir}/scripts/chat.mjs --image ./code.png "Review this code"
Common errors and solutions: Missing API key: Missing XAI_API_KEY โ Set XAI_API_KEY environment variable or add to ~/.clawdbot/clawdbot.json Invalid mode: Must specify --web or --x โ Add --web or --x flag to search command Image format error: Unsupported image type โ Use JPG, PNG, WebP, or GIF format API error: xAI API error: 401 Unauthorized โ Check API key is valid and active
Default model (grok-4-1-fast) is fast and good for most tasks Use grok-3 for complex analysis or when quality matters more than speed X searches are limited by recency (xAI x_search tool constraints) Web searches work best with specific, current queries Voice analysis needs sufficient post history (30+ posts recommended) Post safety checks are advisory; use judgment for final decisions JSON output is best for agent/script consumption Text output is better for terminal/human reading
No results from X search: Try broader query or longer date range Check if handles exist and are public Remove overly restrictive filters Voice analysis incomplete: Increase --days to get more post history Check if account is public and active Verify handle is correct (with or without @) API rate limits: xAI enforces rate limits per API key Spread requests over time if hitting limits Consider upgrading xAI plan for higher limits
Use the analysis tools to improve your X content: # Research before writing node {baseDir}/scripts/analyze.mjs trends "your topic" node {baseDir}/scripts/grok_search.mjs "your topic" --x --days 7 # Study voice patterns node {baseDir}/scripts/analyze.mjs voice @target_account # Check draft before posting node {baseDir}/scripts/analyze.mjs post "$(cat draft.txt)" Use the JSON output to: Research current discussions and posting angles Learn from successful voices in your niche Catch AI signals and platform flags before publishing
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.