背景

OpenClaw（俗称”龙虾”）升级到 2026.6.11 后 Schema 校验变严，手改 openclaw.json 很容易踩坑：

• 混入 Codex / Claude Code 的字段（env、includeCoAuthoredBy）→ <root>: Invalid input
• Provider 里 models[].name 留空 → models.providers.xxx.models.0.name: Invalid input
• doctor --fix 救不回来，gateway stop / uninstall 也因读配置而阻断

结果就是：配置坏了 → CLI 全废 → 只能手动清。

下面是一套”核弹重置 + 移交 CC Switch”的最短路径，之后不再手碰 JSON。

一、重置（文件级清理）

CLI 已不可用，直接上文件系统。

# 1. 杀进程
Get-Process | ? {$_.ProcessName -match "openclaw|node"} | Stop-Process -Force

# 2. 清计划任务（Windows 下 Gateway 由 schtasks 托管）
schtasks /Delete /F /TN "OpenClaw Gateway"  2>$null

# 3. 删状态目录（配置/workspace/sessions 全清）
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue

# 4.（可选）重装 CLI 锁版本
npm uninstall -g openclaw
npm install -g openclaw@2026.5.28

二、初始化基线

openclaw setup
openclaw gateway start

setup 生成的是 200+ 字节的最小模板（agents + gateway + meta），无任何 models.providers，Schema 必过。Gateway 起来监听 127.0.0.1:18789 即可。

三、移交 CC Switch（之后不再手改 JSON）

CC Switch → OpenClaw 选项卡 → +：

字段	填法
Name	纯小写英文+横杠，如 my-api，作 provider id 用
Base URL	你的 OpenAI-compatible 中转，带 /v1
API Key	对应 sk
Model ID	如 deepseek-v4-pro
Model Name	必填，如 DeepSeek V4 Pro——新版 Schema 拒空
Wire API	Chat Completions（中转通用）

Enable → CC Switch 自动写 openclaw.json → 终端里：

openclaw gateway restart

验证：

curl http://127.0.0.1:18789/v1/models -H "Authorization: Bearer ***"

能看到你配的模型就通了。

几点经验

1. openclaw.json 交给 CC Switch 管，要改模型/key/渠道都在 UI 点
2. env / includeCoAuthoredBy 别塞进 openclaw.json
3. Model Name 别留空，6.11+ 是 required 非空串
4. 改 gateway.port / auth.token 用 openclaw config set ...

这套流程跑通后，~/.openclaw/openclaw.json 就变成 CC Switch 的托管文件了，日常运维从改 JSON + 猜 Schema 变成 UI 点一下 + restart。