OpenClaw
在 OpenClaw 配置中合并以下片段(不是覆盖现有完整配置),启动进程前安全设置 NEKOCLOUD_API_KEY。此例仅用于 Chat Completions 模型。
json
{
"agents": {
"defaults": {
"model": {
"primary": "nekocloud/REPLACE_WITH_MODEL_ID"
}
}
},
"models": {
"mode": "merge",
"providers": {
"nekocloud": {
"baseUrl": "https://api.nekocloud.vip/v1",
"apiKey": "${NEKOCLOUD_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "REPLACE_WITH_MODEL_ID",
"name": "NekoCloud"
}
]
}
}
}
}模型引用是 供应商ID/模型ID,但发给接口的模型 ID 不含 nekocloud/。模型注册列表和默认模型要同时更新;只配置默认名称不会自动注册供应商。
Responses 模型需将 api 改为对应版本支持的 openai-responses;Anthropic 模型使用 anthropic-messages 并按官方说明设置 Base URL。不能把一种协议套到所有模型。通过官方配置加载方式生效,再用 openclaw models list 核对。不要为了接入修改 Gateway 网络监听或取消工具审批。
验证与安全
先保存原配置,只合并本页相关字段,不覆盖其他供应商、插件、MCP 和权限设置。密钥不要提交到仓库,配置备份同样需要保护。环境变量必须传入实际运行 Agent 的进程;Remote SSH、容器与本地桌面不是同一个环境。
重新打开客户端并选中猫云模型,发送短消息,到主站「使用记录」核对时间、模型与实扣。随后在隔离项目中只读取一个非敏感文件,检查工具调用、结果回传和最终回答。测试可能产生费用,保留工具审批,不开放自动执行来解决兼容性问题。
本页根据官方供应商配置说明适配,不代表所有模型及本站完整工具链已逐一验收。模型 ID、协议、权限以模型广场和密钥分组为准。错误处理见故障排查。
官方资料
https://docs.openclaw.ai/concepts/model-providers/custom-providers