X Search 1.0.0

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, declared requirements, and install steps match its stated purpose (searching X/Twitter via the xAI Responses API); only minor documentation/metadata inconsistencies were found.

Purpose & Capability

Name/description match the implemented behavior: the Python script uses the xAI Responses API (x_search tool) to search X content. Required binary (python3) and primaryEnv (XAI_API_KEY) are appropriate and necessary for this functionality.

Instruction Scope

SKILL.md instructs the user to set XAI_API_KEY and run the included script, which is accurate. One minor inconsistency: SKILL.md also suggests storing the key in ~/.openclaw/openclaw.json (skills."x-search".apiKey), but the shipped script only reads XAI_API_KEY from the environment and does not read that config file. Otherwise the runtime instructions are scoped to the stated purpose and do not request access to unrelated files or credentials.

Install Mechanism

Install spec is a single Homebrew formula to install Python (formula: python) which is a well-known package source and proportionate to a Python-based skill. There are no downloads from arbitrary URLs or archive extraction steps.

Credentials

Only a single environment variable is required: XAI_API_KEY (declared as primary credential). That aligns with the skill's need to authenticate to the xAI API. The script does not access other environment variables or unrelated credentials.

Persistence & Privilege

The skill is not marked always:true and does not request system-wide configuration changes. It runs as an on-demand Python script and does not modify other skills or system settings.

Assessment

This skill appears to do what it claims: it sends your search query to the x.ai Responses API using the XAI_API_KEY you provide and prints a JSON summary of results and citations. Things to consider before installing: - Provide only an XAI API key with appropriate scope/limits and treat it like any other secret; revoke it if you later suspect misuse. The script sends that key to api.x.ai as the Authorization header. - SKILL.md mentions storing the key in ~/.openclaw/openclaw.json, but the script only reads the XAI_API_KEY environment variable — if you prefer the config file workflow, the code would need modification. - The included code is small and readable; if you are comfortable reading it, you can verify there are no hidden network endpoints or obfuscated logic. - The package ownerId in _meta.json differs from the registry owner ID in the provided metadata; this mismatch is not inherently dangerous but worth noting (it may indicate the package was republished or edited). If any of the above concerns matter for your use case, review or run the script locally with a limited-scope key before adding it to an agent's skillset.

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