search-openclaw-docs
MANDATORY before any openclaw.json changes. Prevents config breakage via embedded anti-patterns and correct patterns. Use when configuring OpenClaw (bindings, channels, sessions, cron, heartbeat) or troubleshooting config issues.
Why use this skill?
Safely manage and troubleshoot your openclaw.json configuration with expert patterns and full documentation search for the OpenClaw agent ecosystem.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/karmanverma/search-openclaw-docsWhat This Skill Does
The search-openclaw-docs skill serves as the primary safeguard for developers and operators working with the OpenClaw agent architecture. Its core function is to provide structured access to validated configuration patterns and troubleshooting logic for the openclaw.json file. By acting as a gatekeeper between the user and the system configuration, it prevents common, silent failure modes caused by invalid bindings, incorrect heartbeat settings, or deprecated session parameters. The skill operates through two distinct channels: a set of curated reference files for instant, high-confidence guidance and a comprehensive search engine powered by an indexed documentation repository.
Installation
You can integrate this utility into your development workflow by executing the installation command directly in your terminal: clawhub install openclaw/skills/skills/karmanverma/search-openclaw-docs. Once installed, ensure you review the AGENTS.md file found in the skill directory. This file defines the mandatory workflow for configuration changes, providing a critical decision tree that maps specific system tasks to their corresponding documentation files. It is best practice to run the documentation indexer rebuild command immediately after updating the OpenClaw core to ensure search results remain accurate to your current version.
Use Cases
This skill is indispensable for platform engineers and OpenClaw agents managing complex configurations. It is the mandatory first step before any edit to openclaw.json. Specific use cases include: migrating configurations between versions (specifically the 2026.2.9 release), debugging silent configuration failures that occur after service restarts, setting up complex cron job schedules without risking syntax errors, and verifying agent routing logic for multi-agent setups. It should also be used as a training resource for new team members to learn the 'correct pattern' vs 'anti-pattern' approach to OpenClaw system management.
Example Prompts
- "I am planning to add a new Discord agent binding to my configuration. Please guide me through the correct pattern to avoid service breakage."
- "My session resets are occurring too frequently. Which reference file should I check to tune these parameters correctly?"
- "I'm seeing a connection error after the latest patch. Search the docs for 'troubleshooting webhook connection' to find the relevant fix."
Tips & Limitations
Always prioritize the 'Embedded References' over the general search fallback. The references are curated to prevent specific, high-frequency errors. If you find that the search index returns stale information, use the docs-index.js rebuild command to refresh your local documentation store. Note that this skill is strictly for system configuration and architecture; it should not be used as a replacement for general memory or unrelated technical stacks like Supabase or Next.js.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-karmanverma-search-openclaw-docs": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, code-execution