在 OpenClaw 里使用珂艾网关

能用。 改两个 JSON 文件即可，支持同时在一条配置里挂 GPT / Claude / Gemini / DeepSeek。
整理日期：2026-10-18 ｜相关：按任务选模型 · 配置三要素

一、先搞懂一个概念：`api` 字段决定协议

OpenClaw 的供应商配置里，api 字段决定用哪种协议，它和 baseUrl 必须配对：

`api` 值	对应协议	baseUrl 怎么写
`openai-completions`	OpenAI 兼容	`https://turbo.apimax.host/v1` ✅ 带 `/v1`
`openai-responses`	OpenAI Responses	`https://turbo.apimax.host/v1` ✅ 带 `/v1`
`anthropic-messages`	Anthropic	`https://turbo.apimax.host` ❌ 不带 `/v1`
`google-generative-ai`	Google Gemini	`https://turbo.apimax.host` ❌ 不带 `/v1`

配错这一对，就是 404。 这是 OpenClaw 配置里最容易踩的坑。

二、安装与初始化

需要 Node.js：

onboard 会问你一些基础设置，跟着走完就行。它会创建两个关键文件：

文件	作用
`~/.openclaw/openclaw.json`	主配置：供应商、模型、默认用哪个
`~/.openclaw/agents/main/agent/auth-profiles.json`	鉴权：真实 API Key

Windows 下路径是 C:\Users\<用户名>\.openclaw\。

三、改 `openclaw.json`

把 agents 和 models 两部分换成下面这样（四个供应商各自对应一种协议，你可以只留需要的）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "keai-claude/claude-sonnet-5-5"
      },
      "models": {
        "keai-claude/claude-sonnet-5-5": { "alias": "Claude Sonnet 5.5" },
        "keai-gpt/gpt-5.5": { "alias": "GPT-5.5" },
        "keai-gemini/gemini-3-8-flash": { "alias": "Gemini 3.8 Flash" },
        "keai-deepseek/deepseek-v4-pro": { "alias": "DeepSeek V4 Pro" }
      },
      "workspace": "~/clawd",
      "maxConcurrent": 4,
      "subagents": { "maxConcurrent": 8 }
    }
  },
  "auth": {
    "profiles": {
      "keai-claude:default": { "provider": "keai-claude", "mode": "api_key" },
      "keai-gpt:default": { "provider": "keai-gpt", "mode": "api_key" },
      "keai-gemini:default": { "provider": "keai-gemini", "mode": "api_key" },
      "keai-deepseek:default": { "provider": "keai-deepseek", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "keai-claude": {
        "baseUrl": "https://turbo.apimax.host",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-5-5",
            "name": "Claude Sonnet 5.5",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      },
      "keai-gpt": {
        "baseUrl": "https://turbo.apimax.host/v1",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.5",
            "name": "GPT-5.5",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      },
      "keai-gemini": {
        "baseUrl": "https://turbo.apimax.host",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3.8-flash",
            "name": "Gemini 3.8 Flash",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 8192
          }
        ]
      },
      "keai-deepseek": {
        "baseUrl": "https://turbo.apimax.host/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-v4-pro",
            "name": "DeepSeek V4 Pro",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

几个字段的意思

字段	说明
`agents.defaults.model.primary`	默认用哪个，格式 `供应商名/模型ID`
`agents.defaults.models`	可切换的模型清单，`alias` 是显示名
`models.mode: "merge"`	合并到内置模型列表，不覆盖
`cost`	全填 0 表示不由 OpenClaw 计费，实际扣费看珂艾控制台
`contextWindow` / `maxTokens`	按模型实际规格填，填大了会被截断

四、改 `auth-profiles.json`

这个文件里放真实密钥：

{
  "version": 1,
  "profiles": {
    "keai-claude:default":   { "type": "api_key", "provider": "keai-claude",   "key": "sk-你的珂艾密钥" },
    "keai-gpt:default":      { "type": "api_key", "provider": "keai-gpt",      "key": "sk-你的珂艾密钥" },
    "keai-gemini:default":   { "type": "api_key", "provider": "keai-gemini",   "key": "sk-你的珂艾密钥" },
    "keai-deepseek:default": { "type": "api_key", "provider": "keai-deepseek", "key": "sk-你的珂艾密钥" }
  }
}

珂艾是同一个 Key 走所有模型，所以四个 key 可以填同一个值。分开写只是为了方便以后换不同分组的令牌。

提示：auth-profiles.json 里 provider 的值、openclaw.json 里 auth.profiles 的 key 前缀、models.providers 的 key——这三处名字必须完全一致，否则该供应商会被跳过。

五、启动与验证

问它一句：

你现在用的是哪个模型？列出你所在的工作目录

判定标准：

✅ 报出 claude-sonnet-5-5 之类，且能列目录 → 通了

❌ 报错找不到 provider → 三处名字不一致

❌ 401 → auth-profiles.json 里的 key 不对

❌ 404 → baseUrl 和 api 协议不配对

❌ 能聊不能执行工具 → 模型不支持 function call，换 claude-sonnet-5-5

切换模型：

/model keai-gpt/gpt-5.5

六、三个版本怎么对应

站上曾有三篇 OpenClaw 教程，对应三个版本，配置思路一致，差异在这里：

版本	配置文件	差异点
Clawdbot（早期）	`clawdbot.json`	字段名早期叫 `clawdbot.json`，结构相同
最新版（推荐）	`openclaw.json`	文件改名，支持 `models.mode: "merge"`
配合 CC Switch	同上	CC Switch 用来在多个配置档之间切换，本质是替换这两个 JSON

新装用户直接用最新版，按本文配就行。老配置想迁移，把 clawdbot.json 的内容按本文结构搬到 openclaw.json 即可。

七、常见报错

现象	原因	解决
供应商被跳过 / 找不到模型	三处 provider 名不一致	统一命名，如上文都用 `keai-*`
`401`	key 错 / 放错文件	密钥在 `auth-profiles.json`，不在 `openclaw.json`
`404`	`baseUrl` 与 `api` 不配对	按第一节的表格改
模型不存在	`id` 填了官网名	换网关 ID
JSON 解析错误	少了逗号 / 多了逗号	用编辑器的 JSON 校验
改了配置没生效	没重启	完全退出再 `openclaw`
上下文报超限	`contextWindow` 填大了	按模型实际规格改小

八、计费与分组

项目	信息
计费方式	按量计费（按输入 / 输出 token 结算）
成本显示	OpenClaw 里的 `cost` 填 0，真实扣费只在珂艾控制台看
建议	OpenClaw 有子智能体并发，给它建独立令牌并设额度上限

实际单价以价格页为准。

九、相关阅读

不确定选哪个模型：按任务选模型

同类工具：Claude Code · DeepSeek Harness

搞不清填什么：配置三要素

报错排查：配置报错对照表

十、更新记录

日期	改了什么
2026-10-18	三篇旧教程（Clawdbot / 最新版 / CC Switch）合并为本篇。补四种协议的 baseUrl 配对表、三处 provider 名一致性要求

在 OpenClaw 里使用珂艾网关

一、先搞懂一个概念：api 字段决定协议#

二、安装与初始化#

三、改 openclaw.json#

几个字段的意思#

四、改 auth-profiles.json#

五、启动与验证#

六、三个版本怎么对应#

七、常见报错#

八、计费与分组#

九、相关阅读#

十、更新记录#