Search X (Twitter) posts using the xAI API. Use when the user wants to find tweets, search X/Twitter, look up what people are saying on X, or find social media posts about a topic.
Search X (Twitter) posts using the xAI Grok API with real-time access to X content.
export XAI_API_KEY="xai-your-key-here"
skills."x-search".apiKey / skills."x-search".env.XAI_API_KEY in ~/.openclaw/openclaw.jsonpython3 {baseDir}/scripts/search.py "what is trending in AI right now"
Useful flags:
# 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"
x_search tool (Grok performs the search and summarizes results)--handles and --exclude at the same time