背景
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 startsetup 生成的是 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 ***"能看到你配的模型就通了。
几点经验
openclaw.json交给 CC Switch 管，要改模型/key/渠道都在 UI 点env/includeCoAuthoredBy别塞进openclaw.json- Model Name 别留空，6.11+ 是 required 非空串
- 改
gateway.port/auth.token用openclaw config set ...
这套流程跑通后，
~/.openclaw/openclaw.json就变成 CC Switch 的托管文件了，日常运维从改 JSON + 猜 Schema 变成 UI 点一下 + restart。
正文完
