← Back to Skills Marketplace
notabhay

grok-search

by notabhay · GitHub ↗ · v0.2.1
cross-platform ✓ Security Clean
6153
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 prompts, search queries, filters, and any explicitly provided images to xAI using your XAI_API_KEY. Avoid using it with secrets, private documents, or sensitive images unless that third-party API use is acceptable, and consider narrowing triggers if accidental invocation would be a problem.
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
ℹ Credentials
The scripts read XAI_API_KEY from the environment or disclosed Clawdbot config locations and send user queries, prompts, optional images, and API authorization to api.x.ai, which is proportionate for an xAI integration but should be understood by users.
✓ Install Mechanism
No package installer, dependency fetch, post-install hook, or remote code execution path was found; the skill ships local Node scripts and declares node plus XAI_API_KEY as requirements.
ℹ Instruction Scope
The triggers include broad phrases such as grok, xai, search x, and find tweets, which could cause over-invocation, but the runtime commands require explicit user-provided prompts, modes, or image paths.
✓ Persistence & Privilege
No file writes, scheduled tasks, service installation, memory modification, privilege escalation, or durable background behavior were found.
ℹ Purpose & Capability
The search purpose matches the main script and manifest, while the documentation also discloses broader chat, image, and model-listing commands; that breadth is visible rather than hidden.
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 6153 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