← Back to Skills Marketplace
notabhay

grok-search

by notabhay · GitHub ↗ · v0.2.1
cross-platform ✓ Security Clean
6013
Downloads
7
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install grok-search
Description
Search the web or X/Twitter using xAI Grok server-side tools (web_search, x_search) via the xAI Responses API. Use when you need tweets/threads/users from X, want Grok as an alternative to Brave, or you need structured JSON + citations.
Usage Guidance
Install only if you are comfortable sending your search queries, prompts, and any explicitly provided images to xAI under your XAI_API_KEY. Avoid using it for secrets or private images unless you intend to transmit that content to xAI.
Capability Analysis
Type: OpenClaw Skill Name: grok-search Version: 0.2.1 The OpenClaw AgentSkills skill bundle for 'grok-search' is benign. The scripts (`chat.mjs`, `grok_search.mjs`, `models.mjs`) legitimately access the `XAI_API_KEY` from environment variables or `~/.clawdbot/clawdbot.json` to authenticate with the official xAI API (api.x.ai). File system access is limited to reading this configuration and user-specified image files for vision chat, which is directly aligned with the skill's stated purpose. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution of arbitrary commands, persistence mechanisms, or prompt injection attempts against the OpenClaw agent in `SKILL.md`.
Capability Assessment
Purpose & Capability
The stated purpose is xAI/Grok search over web and X/Twitter, and the documented scripts use the xAI Responses API for search, chat, vision chat, and model listing.
Instruction Scope
The name and short description emphasize search, while the body also documents chat and image-based vision chat; this is a scope note but not hidden behavior.
Install Mechanism
The metadata only requires Node and XAI_API_KEY; no package install, shell persistence, or privileged setup is described.
Credentials
Queries, prompts, and user-specified image files are sent to xAI, which is expected for this integration and is partly disclosed by the xAI API documentation and commands.
Persistence & Privilege
No persistence, background worker, privilege escalation, destructive action, or broad local indexing is evident; credential lookup from ~/.clawdbot/clawdbot.json is documented and limited to xAI-related keys.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install grok-search
  3. After installation, invoke the skill by name or use /grok-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.1
Fix: better citations (dedupe by tweet id, prioritize result URLs, cap size) + keep JSON stable.
v0.2.0
Upgrade: key lookup via skills.entries; X filters (days/from/to/handles/exclude); output modes (links-only/text/raw); citations merged from annotations; added chat + models scripts.
v0.1.0
Initial release: xAI Grok web_search + x_search wrapper (scripts/grok_search.mjs)
Metadata
Slug grok-search
Version 0.2.1
License
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is grok-search?

Search the web or X/Twitter using xAI Grok server-side tools (web_search, x_search) via the xAI Responses API. Use when you need tweets/threads/users from X, want Grok as an alternative to Brave, or you need structured JSON + citations. It is an AI Agent Skill for Claude Code / OpenClaw, with 6013 downloads so far.

How do I install grok-search?

Run "/install grok-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is grok-search free?

Yes, grok-search is completely free (open-source). You can download, install and use it at no cost.

Which platforms does grok-search support?

grok-search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created grok-search?

It is built and maintained by notabhay (@notabhay); the current version is v0.2.1.

💬 Comments