openclaw-config — Claude Code skill: what it does, how to install
Diagnoses OpenClaw bot runtime issues, inspects channel configs, and troubleshoots gateway or messaging errors.
npx skills add adisinghstudent/ara.so --skill openclaw-config -a claude-codeWhat openclaw-config does
The skill provides an operations runbook for OpenClaw bot setups. It includes bash health check commands to test the gateway process and validate ~/.openclaw/openclaw.json syntax using Python. It also checks session keys for WhatsApp and bot tokens for Telegram.
It maps the ~/.openclaw/ directory layout, including agent workspace files, SQLite vector memory, and gateway logs. A troubleshooting guide addresses WhatsApp failures, covering status 408 disconnects, cross-context messaging denials between providers, and the 600-second agent timeout.
When dmPolicy is set to allowlist, unlisted senders get dropped silently, making channel configuration the first place to inspect during delivery failures.
What it helps with
- diagnose gateway errors and crashed OpenClaw processes
- troubleshoot WhatsApp disconnects and message drops
- validate ~/.openclaw/openclaw.json syntax and channel policies
- inspect SQLite vector memory chunks and cron job states
Example prompts for the agent
- Run a health check on my OpenClaw gateway and credentials
- Why is the OpenClaw bot not replying to WhatsApp messages?
- Check ~/.openclaw/logs/gateway.err.log for timeout errors
How to install openclaw-config
1Skills CLI (Vercel)
npx skills add adisinghstudent/ara.so --skill openclaw-config -a claude-code2Manually: put the files in place
~/.claude/skills/openclaw-config/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/openclaw-config/
1Skills CLI (Vercel)
npx skills add adisinghstudent/ara.so --skill openclaw-config -a codex2Manually: put the files in place
.agents/skills/openclaw-config/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add adisinghstudent/ara.so --skill openclaw-config -a cursor2Manually: put the files in place
.cursor/skills/openclaw-config/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install adisinghstudent/ara.so openclaw-config2Manually: put the files in place
.github/skills/openclaw-config/SKILL.md1Skills CLI (Vercel)
npx skills add adisinghstudent/ara.so --skill openclaw-config -a gemini-cli2Platform CLI
gemini skills install https://github.com/adisinghstudent/ara.so --path skills/openclaw-configManually: put the files in place
.devin/skills/openclaw-config/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add adisinghstudent/ara.so --skill openclaw-config -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about openclaw-config
How to install openclaw-config in Claude Code?
Run npx skills add adisinghstudent/ara.so --skill openclaw-config -a claude-code.
What does openclaw-config do?
It serves as a diagnostic runbook for OpenClaw bot instances, helping troubleshoot channel issues, configuration files, and gateway logs.
Why does WhatsApp fail with cross-context errors?
OpenClaw rejects messages when an agent bound to one provider session (like Signal) attempts to dispatch an action to WhatsApp.
