OpenClaw 配置教程
OpenClaw 通过 models.providers 添加自定义模型供应商。ai2save 走 OpenAI Compatible 接口,Base URL 必须填 https://ai2save.com/v1。
1. 准备 OpenClaw 和 API Key
已安装 OpenClaw 可跳过安装:
npm install -g openclaw@latest
openclaw --version
- 打开 https://ai2save.com/keys。
- 创建一个属于 OpenAI / GPT 模型分组的 API Key。
- 复制完整
sk-...Key。
2. 编辑 OpenClaw 配置文件
OpenClaw 的默认配置文件是:
~/.openclaw/openclaw.json
Windows 通常在 %USERPROFILE%\.openclaw\openclaw.json。文件支持 JSON5,可以按下面结构合并到现有配置:
{
env: {
vars: {
AI2SAVE_API_KEY: "sk-你的密钥",
},
},
agents: {
defaults: {
model: {
primary: "ai2save/gpt-5.5",
},
},
},
models: {
mode: "merge",
providers: {
ai2save: {
baseUrl: "https://ai2save.com/v1",
apiKey: "${AI2SAVE_API_KEY}",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "gpt-5.5",
name: "GPT 5.5",
reasoning: true,
input: ["text"],
contextWindow: 200000,
},
],
},
},
},
}
关键字段说明:
models.providers.ai2save.baseUrl:必须带/v1。api: "openai-completions":OpenClaw 对 OpenAI Compatible 代理使用的接口类型。models[].id:必须与 ai2save 控制台开放的模型 ID 完全一致。agents.defaults.model.primary:格式是供应商ID/模型ID。apiKey可以直接写"sk-...";用${AI2SAVE_API_KEY}引用时,必须在env.vars中定义。
如果要添加多个模型,在 models 数组中继续追加,并把 primary 改成你想默认使用的 ai2save/模型ID。
3. 应用并检查配置
OpenClaw Gateway 会监听配置文件变化并自动应用。如果配置没有及时生效,执行:
openclaw gateway restart
然后检查模型是否已经出现在 OpenClaw:
openclaw models list --provider ai2save
把默认模型切到 ai2save:
openclaw models set ai2save/gpt-5.5
如果模型没有出现,运行诊断并查看配置错误:
openclaw doctor
4. 验证请求
- 打开 OpenClaw 的聊天界面或 WebChat。
- 新建会话,发送「你好,请报告当前模型名称」。
- 确认模型路由显示为
ai2save/gpt-5.5。 - 第一次先只用文本任务验证,成功后再打开文件、浏览器、长上下文等复杂工具。
OpenClaw 对非官方 OpenAI 代理会自动做兼容处理,不需要手工开启 developer role。如果遇到工具调用异常,先确认模型 ID 支持工具调用,再把超时时间调大。
5. 常见报错
- 401 / invalid_api_key:
AI2SAVE_API_KEY没有定义、Key 复制不完整,或 Key 分组不匹配。 - 404 / model not found:
models[].id、primary或实际请求模型名不一致。 - 连接失败 / empty response:检查
baseUrl是否为https://ai2save.com/v1,不要写成根地址。 - 模型列表为空:确认
models.mode: "merge",并确认models.providers.ai2save.models[]至少包含一个模型。 - 配置保存后未生效:重新执行
openclaw doctor,必要时重启 OpenClaw Gateway。