Openclaw-superpowers openclaw-config-advisor

Diagnoses OpenClaw provider, fallback, channel, MCP, and gateway config issues with read-only scans and stateful summaries.

install

source · Clone the upstream repo

git clone https://github.com/ArchieIndian/openclaw-superpowers

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ArchieIndian/openclaw-superpowers "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/openclaw-native/openclaw-config-advisor" ~/.claude/skills/archieindian-openclaw-superpowers-openclaw-config-advisor && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ArchieIndian/openclaw-superpowers "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/openclaw-native/openclaw-config-advisor" ~/.openclaw/skills/archieindian-openclaw-superpowers-openclaw-config-advisor && rm -rf "$T"

manifest: skills/openclaw-native/openclaw-config-advisor/SKILL.md

source content

OpenClaw Config Advisor

Config problems usually look like model failures, missing tools, or broken channels. Use this skill when OpenClaw behaves inconsistently and you need a read-only diagnosis before changing settings.

When to Invoke

Provider routing or fallback model behavior is wrong
A channel cannot connect or stops receiving messages
MCP tools are missing, stale, or unavailable
The gateway starts but behaves differently than expected
You need a current config summary before editing OpenClaw settings

Checks

Area	What to inspect
Providers	Provider keys, model names, default model hints
Fallback	Fallback or backup model settings
Channels	Telegram, Discord, Slack, WhatsApp, Signal, or Lark entries
MCP	MCP server declarations and command/url hints
Gateway	Host, port, log, and process configuration hints

How to Use

python3 advise.py --scan
python3 advise.py --scan --config-dir ~/.openclaw
python3 advise.py --explain fallback
python3 advise.py --status
python3 advise.py --format json

Procedure

Run
```
python3 advise.py --scan --format json
```
.
Review findings by severity:
```
WARN
```
first, then
```
INFO
```
.
Inspect the named config files before editing anything.
Apply config changes only after the user confirms the intended routing or channel behavior.
Re-run the scan and compare with the prior state summary.

State

Scan summaries are stored in

~/.openclaw/skill-state/openclaw-config-advisor/state.yaml

Fields:

last_scan_at

config_dir

findings

affected_areas

, and

scan_history

Guardrails

This skill is read-only; it does not modify OpenClaw config.
Missing config directories are warnings, not crashes.
Do not print secrets. Report that secret-like values exist without echoing them.