Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

OpenClaw Model Switch

Safely switch or repair an OpenClaw instance's model configuration, with diagnostics for 401, no-available-channel and thinking-level errors.

UtilitiesAdvanced★ 1,323⑂ 212AI score 7/10Last updated: Aug 8, 2026

What it does

  • Discovers which openclaw.json the gateway actually reads (three candidate paths plus mirrors) and edits all of them consistently.
  • Probes the endpoint and model with a real curl completion request before touching any config.
  • Runs scripts/switch-model.py to back up configs, add model definitions, set agents.defaults.model.primary, sync mirrors and restart the gateway.
  • Enforces end-to-end verification with one real agent turn: result: success and fallbackUsed: false.
  • Ships a trap catalog for common failures: KIMI_API_KEY env hijacking the provider wire key, plugins hardcoding binary thinking levels, 503 No available channel, and edits to the wrong mirror file.

Who it's for

  • Operators self-hosting OpenClaw / Kimi Claw bots who need to upgrade or roll back models (k2p6 → k3).
  • Users of new-api style relays hitting 401 or channel-availability errors.
  • Anyone whose manual config edit "saved fine" but changed nothing.

Examples

  1. "Switch OpenClaw to k3" → config discovery, curl probe, script run, ping verification.
  2. "The bot says Invalid token but curl works" → guided diagnosis of trap #1 (env key hijack).
  3. "Thinking level 'max' is not supported" → check plugin restrictions, then use a custom provider or params.canonicalModelId.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the openclaw-model-switch folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/openclaw-model-switch/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/daymade/claude-code-skills.git && cp -r claude-code-skills/openclaw-model-switch ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal.
  2. Clone the skills repo: git clone https://github.com/daymade/claude-code-skills.git
  3. Copy the skill into place: mkdir -p ~/.claude/skills && cp -r claude-code-skills/openclaw-model-switch ~/.claude/skills/
  4. Confirm scripts/switch-model.py came along and that python3 --version works.
  5. Restart Claude Code and ask something like "switch my OpenClaw model to k3" to trigger the skill.
  6. Important: make your own backup of openclaw.json first, and never commit config files containing API keys.
View source on GitHub ↗License: MIT