About openclaw-grok-search
A project-local skill for running Grok-backed web research and returning structured JSON with content and sources. It is intended for agents that need current information, documentation links, or evidence for troubleshooting.
Key features
- 01Cross-platform web research
- 02Structured JSON output
- 03Configurable CLI and environment settings
- 04Retry after a failed search
Use cases
- 01Checking recent releases or compatibility
- 02Finding official documentation and source URLs
- 03Researching evidence for error analysis
MCP support
The skill directs agents to use GrokSearch tools or CLI rather than built-in WebSearch or WebFetch.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ stemmaker/ openclaw-grok-search --skill openclaw-grok-searchAfter installing, type/openclaw-grok-searchin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
README.mdconfig.example.jsonscripts/grok_search.pyconfigure.pyDetails
From the project READMEOpenclaw Grok Search
Run cross-platform web research and return structured JSON output with content and sources.
This skill is project-local and should run directly from the downloaded project directory.
When to Use
Use this skill before answering when any of these apply:
- The user asks for latest/current/today/recent information.
- The answer depends on versions, releases, changelogs, or compatibility.
- The task needs official docs, API references, or source URLs.
- The user reports an error and root-cause analysis needs web evidence.
- You are uncertain and need external confirmation before final output.
Quick Start
- Write config interactively (first run only).
python scripts/configure.py
- Run a query.
python scripts/grok_search.py --query "What changed in Python recently?"
Config Priority
- CLI args such as
--base-urland--api-key - Environment vars
GROK_* - Config files
Default config lookup order:
config.jsonconfig.local.json
Cross-Platform Rules
- Prefer
python ...commands, do not require PowerShell-only syntax. - Keep config in the project folder, do not install or copy into
~/.codex. - Support
GROK_CONFIG_PATHonly when you explicitly want a custom path.
Output Shape
Always print JSON with:
okcontentsourcesraw
Anti-Patterns
| Prohibited | Correct |
|---|---|
| No source citation | Include Source [<sup>1</sup>](URL) |
| Give up after one failure | Retry at least once |
| Use built-in WebSearch/WebFetch | Use GrokSearch tools/CLI |