# Openclaw Config Advisor

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

- Skill: `archieindian/openclaw-config-advisor` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add archieindian/openclaw-config-advisor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/archieindian/openclaw-config-advisor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: archieindian (https://skillmd.com/u/archieindian)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/archieindian/openclaw-config-advisor

---


# 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

```bash
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

1. Run `python3 advise.py --scan --format json`.
2. Review findings by severity: `WARN` first, then `INFO`.
3. Inspect the named config files before editing anything.
4. Apply config changes only after the user confirms the intended routing or channel behavior.
5. 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.