showname

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 med...

Security Scan

The skill's code, runtime instructions, and required credential (XAI_API_KEY) are coherent with a tool that queries the xAI (Grok) x_search API to find X/Twitter posts.

Purpose & Capability

Name/description match the actual implementation: the Python scripts build a tool config and POST to https://api.x.ai/v1/responses using the x_search tool. Required binary (python3) and env var (XAI_API_KEY) are appropriate for the stated purpose.

Instruction Scope

SKILL.md instructs only to set XAI_API_KEY and run the included Python script with query and flags. The runtime code only reads the declared env var, validates CLI args, and sends requests to the documented x.ai endpoint; it does not read other system files or transmit data to unexpected endpoints.

Install Mechanism

Install spec only offers installing Python via Homebrew (formula: python) to provide python3. This is proportionate and standard for a Python-based skill; there are no downloads from arbitrary URLs or archive extraction.

Credentials

Only XAI_API_KEY is required and used. The scripts do not request or access other credentials, secrets, or unrelated environment variables. The SKILL.md's note about optional openclaw config storage is a reasonable UX hint, not additional credential exposure.

Persistence & Privilege

Skill does not request always:true and does not modify other skills or system-wide settings. It runs as a normal user-space script and requires only transient network access to the x.ai API.

Assessment

This skill appears to do exactly what it says: it uses your XAI_API_KEY to call the x.ai Responses API (x_search) and returns summarized results with citations. Before installing, verify you trust the XAI_API_KEY you provide and that the key's permissions are appropriate. Review the included scripts locally if you want to confirm behavior (they're small, well-tested, and validate inputs). Note: the skill will make network calls to api.x.ai when used; do not provide a high-privilege API key if you only need read-only search functionality. Autonomous invocation is allowed by default on the platform (not set to always:true here), so consider whether you want the agent to call this skill without prompting.

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