OpenClaw 接入五猫 API 教程：完整配置与排错指南
本文详细讲解如何在 OpenClaw 中接入五猫 API，包括 API Key、Base URL、openclaw.json 配置示例以及常见报错的排查方法。适合首次接入的用户直接照着完成配置。
如果你已经安装好了 OpenClaw，接下来只需要完成几个关键配置项，就可以把请求接到 五猫 API。
整个流程并不复杂，核心就 3 个字段：
baseUrlapiKeyapi
只要这几个字段填对，OpenClaw 一般就能正常工作。
一、开始前要准备什么
正式配置前，先确认你已经准备好下面 3 项：
- 已经安装并能正常打开
OpenClaw - 已经有一个可用的
五猫 API Key - 能编辑
OpenClaw的配置文件openclaw.json
如果还没有可用令牌，建议先在五猫 API 后台创建并复制好对应的 Key。
二、关键配置速查
下面是最关键的配置项，对照填写即可：
| 配置项 | 填什么 | 说明 |
|---|---|---|
baseUrl | https://api.wucat.cc/v1 | 五猫 API 的 OpenAI 兼容基础地址 |
apiKey | 你的五猫 API Key | 从后台复制，不建议手打 |
api | openai-completions | OpenClaw 使用的接口类型 |
最容易出错的地方
apiKey填成了账号密码，而不是 API KeybaseUrl少写了/v1JSON语法写错，导致配置文件无法加载- 改完配置后没有完整重启
OpenClaw
三、配置步骤
1. 找到 openclaw.json
常见的 Linux 路径示例如下：
/root/.openclaw/openclaw.json如果你的环境不同，路径也可能不同。重点不是死记路径，而是找到当前 OpenClaw 实际正在读取的那个 openclaw.json。
2. 复制五猫 API Key
登录五猫 API 后台，复制你准备使用的 API Key。
建议直接复制粘贴，不要手动输入，原因很简单：
- 少一位字符就会鉴权失败
- 前后多空格也可能报错
- 很容易粘贴错别的 Key
3. 修改 openclaw.json
在 openclaw.json 中找到供应商配置，把五猫 API 的配置加入进去。
你可以参考下面这个示例：
{
"models": {
"mode": "merge",
"providers": {
"wucat-api": {
"baseUrl": "https://api.wucat.cc/v1",
"apiKey": "替换成你的五猫 API Key",
"api": "openai-completions"
}
}
}
}配置说明
mode使用merge，表示在现有配置基础上合并providers表示供应商配置集合wucat-api是当前这组配置的名字，你也可以自定义，但建议保持语义清晰baseUrl使用五猫 API 的 OpenAI 兼容地址apiKey填你自己的五猫 API Keyapi这里使用openai-completions
不建议整文件覆盖
上面的示例是给你对照字段结构的，不代表你要直接把原配置全部删掉。
如果你原来的 openclaw.json 里已经有其他内容，建议这样处理：
- 只新增五猫 API 这部分配置
- 或只修改现有供应商的相关字段
这样更稳，不容易把旧配置一起破坏掉。
4. 保存并重启 OpenClaw
按下面顺序操作：
- 保存
openclaw.json - 完整关闭
OpenClaw - 重新打开
OpenClaw - 发起一次简单测试请求
如果程序能正常启动，并且请求有正常返回，就说明配置已经生效。
四、怎么判断已经配置成功
你可以直接看这 3 点：
OpenClaw启动时没有配置报错- 当前使用的是你刚刚配置的五猫 API 供应商
- 发起请求后可以正常返回内容
只要这几项都成立，通常就说明已经接入成功。
五、常见问题排查
1. 找不到 openclaw.json 怎么办
先确认 OpenClaw 至少启动过一次。
很多工具第一次运行后，才会生成自己的配置目录。如果你从未启动过程序，配置文件可能根本还没生成。
查找时建议直接搜文件名：
openclaw.json而不是只盯着某一个固定路径。
2. 保存后没有生效怎么办
这种情况最常见的原因就是没有真正重启程序。
有时候只是关掉了窗口，但后台进程并没有退出，程序仍然在读取旧配置。遇到这种情况，建议完整退出后再重新启动。
3. 启动时报 JSON 错误怎么办
优先检查下面几项：
- 字符串是否都使用了双引号
{}是否成对闭合- 多个字段之间是否漏了逗号
- 最后一个字段后面是否多写了逗号
JSON 格式比较严格，一个标点写错，整个配置就可能失效。
4. 返回 401 或鉴权失败怎么办
这类问题大多数都和 apiKey 有关，重点排查：
- Key 没复制完整
- 前后多了空格
- 复制错了令牌
- 当前 Key 已失效
- 账户额度或配额异常
最简单的处理方式，通常是重新复制一遍 Key，再保存并重启程序。
5. baseUrl 应该填什么
五猫 API 这里建议使用：
https://api.wucat.cc/v1我已经实际验证过这一点：
https://api.wucat.cc/v1/models在未带令牌时会返回401 Unauthorized- 这说明
/v1路径本身是有效的 OpenAI 兼容入口
所以对于 OpenClaw 来说，baseUrl 使用 https://api.wucat.cc/v1 是合理的。
