用途：切换或修复 OpenClaw 实例的模型配置，通过安全编辑 openclaw.json 完成默认模型变更、模型定义添加与故障排查。
主要能力：先诊断后修改。资料指出 OpenClaw 的模型故障通常不是模型 id 本身，而是密钥路由（环境变量劫持）、provider 插件限制或端点/模型不匹配。技能提供配置发现、备份、镜像同步、重启网关与端到端验证流程，并附带陷阱目录参考文档。
使用方式：
- 定位真实配置文件，候选路径包括 ~/.openclaw/openclaw.json、~/.kimi/kimi-claw/openclaw.json、~/.kimi_openclaw/openclaw.json；用 openclaw gateway status 确认网关实际读取的 Config (service) 路径，多个文件需同步编辑。
- 修改前先用真实补全探测端点与模型，例如：curl -sS -o /tmp/probe.json -w "HTTP %{http_code}\n" -X POST "<baseUrl>/v1/messages" -H "Authorization: Bearer <apiKey>" -H "Content-Type: application/json" -H "anthropic-version: 2023-06-01" -d '{"model":"<model-id>","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'。
- 切换模型：python3 scripts/switch-model.py <model-id> --restart；可加 --provider 指定 provider，或 --config 指定配置路径。脚本会备份配置、添加模型定义、设置 agents.defaults.model.primary、同步镜像并重启网关。
- 强制端到端验证：openclaw agent --local --json --agent main --session-id verify-$(date +%s) -m "ping"，成功应显示 "result": "success" 且 "fallbackUsed": false。
适用场景：OpenClaw 模型切换、401/503 报错修复、thinking level 不兼容、配置改动不生效等。
限制与安全规则：编辑前必须备份；保留现有 apiKey、headers、插件配置与 env 块；手动编辑后用 python3 -m json.tool openclaw.json > /dev/null 校验；不要将含 API 密钥的配置提交到版本控制；每次改动后重做验证，失败则先恢复最新备份。具体模型规格与陷阱细节见 references/kimi-models.md 与 references/troubleshooting-model-config.md。