Setup & Installation

clawhub install x-search-bwm

Or with OpenClaw CLI:

openclaw skills install x-search-bwm

What This Skill Does

X Search Bwm is a social-media skill that 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..

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:
    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

python3 {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"

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

Version History

Latest version: 1.0.0

First published: Apr 16, 2026. Last updated: Apr 16, 2026.

1 version released.

Frequently Asked Questions

Is X Search Bwm free to use?
Yes. X Search Bwm is a free, open-source skill available on the OpenClaw Skills Registry.
What platforms does X Search Bwm support?
It runs on any platform that supports OpenClaw, including macOS, Linux, and Windows.