JSON 模板比手动口述更可靠
OpenClaw 的 openclaw.json 字段较多，团队应把 baseUrl、apiKey、models 和 agents.defaults.model.primary 写成审阅过的模板，再由成员替换个人 UUcode Key。
OpenClaw JSON Runbook
用 UUcode provider 管理 OpenClaw 多模型 JSON 配置
OpenClaw 文档展示了 providers、models、alias、reasoning 和 input 字段。这个 Runbook 帮助团队把 UUcode 模型网关配置成可复制的 JSON 模板。
- providers.uucode
- model aliases
- Agent Runbook
多模型字段要和平台展示保持一致
模型 ID、名称、reasoning、input 和 API 类型应以 doc.uucode.top 与 uucode.top 当前展示为准，避免旧模型名导致 model not found。
Runbook 应包含验证和回滚
修改配置后运行一个小任务，检查 UUcode 控制台请求记录。如果失败，恢复上一版 openclaw.json，再逐项排查 provider、Key 和模型 ID。
01
备份现有配置
复制当前 openclaw.json，保留可回滚版本。
02
写入 UUcode provider
按文档配置 providers.uucode、baseUrl、apiKey 和模型列表。
03
执行最小任务
运行一个短 Agent 请求，确认 OpenClaw 能通过 UUcode 返回结果。
常见问题
为什么要保留 alias？
alias 可以让成员用更短的名称选择模型，同时保持底层模型 ID 与 UUcode 平台一致。
openclaw.json 需要提交到仓库吗？
含有 apiKey 的个人配置不应提交。团队可以提交不含密钥的模板或文档。