ai2saveai2save

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
  1. 打开 https://ai2save.com/keys。
  2. 创建一个属于 OpenAI / GPT 模型分组的 API Key。
  3. 复制完整 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. 验证请求

  1. 打开 OpenClaw 的聊天界面或 WebChat。
  2. 新建会话,发送「你好,请报告当前模型名称」。
  3. 确认模型路由显示为 ai2save/gpt-5.5。
  4. 第一次先只用文本任务验证,成功后再打开文件、浏览器、长上下文等复杂工具。

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。