OpenClaw 接入 kkaiapi

最后更新:

使用 models.providers 注册 KK 的 Chat Completions 连接,通过环境变量读取 Key,选择 provider/model 并核对一次 Agent 任务。

注册 provider,再选择 provider/model

在 OpenClaw 配置中注册 models.providers.kkai。api 选择 openai-completions 对应 Chat Completions;agents.defaults.model.primary 使用 kkai/模型ID。下面是配置合并片段,先备份原文件,保留已有 providers 与 Agent 设置。

配置项值
协议OpenAI Chat Completions
Base URLhttps://api.kkaiapi.com/v1
模型 IDclaude-sonnet-5-5
凭据从当前工具进程的安全配置读取

合并配置片段

配置中只引用环境变量;应合并到现有配置,保留已有账户与其他模型条目。

{
  "models": {
    "mode": "merge",
    "providers": {
      "kkai": {
        "baseUrl": "https://api.kkaiapi.com/v1",
        "api": "openai-completions",
        "apiKey": "${KKAI_API_KEY}",
        "models": [
          {
            "id": "claude-sonnet-5-5",
            "name": "claude-sonnet-5-5",
            "input": [
              "text"
            ]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kkai/claude-sonnet-5-5"
      }
    }
  }
}

核对实际生效的工具路径

在启动 OpenClaw 的进程中提供 KKAI_API_KEY,然后重载或重启网关,核对模型选择与一次小任务。环境变量插值由 OpenClaw 读取,不要将真实 Key 写进配置。Responses 需要模型页明确提供 /v1/responses,不能只靠模型名推定。

配置依据与能力验证

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

配置字段依据openclaw 官方说明;工具界面可能随版本变化,所需能力应在已安装版本中核对。

常见问题

为什么 API 请求成功,工具仍不能完成任务?

继续核对工具实际选择的 provider、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。