在 OpenClaw 中配置 Kilo Gateway 后，只需一张 API 密钥即可调用 Claude、GPT、Gemini 等模型，默认使用智能路由模型 kilocode/kilo/auto。运行 openclaw onboard --auth-choice kilocode-api-key 设置环境变量，然后用 openclaw models list --provider kilocode 验证可用模型。若模型发现失败，会回退到静态目录，仅包含 kilocode/kilo/auto。

Kilo Gateway 怎么接入 OpenClaw（统一 API 密钥）

Kilo Gateway 提供统一 API，通过单一端点和 API Key 路由请求到众多模型。它兼容 OpenAI 接口，切换 base URL 后大多数 OpenAI SDK 即可直接使用。

属性	值
Provider	`kilocode`
认证	`KILOCODE_API_KEY`
API	OpenAI 兼容
Base URL	`https://api.kilo.ai/api/gateway/`

快速开始

创建账号

前往 [app.kilo.ai](https://app.kilo.ai) 登录或注册，进入 API Keys 页面生成新密钥。

运行 onboard 向导

```bash
openclaw onboard --auth-choice kilocode-api-key
```

或直接设置环境变量：

```bash
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
```

验证模型可用

```bash
openclaw models list --provider kilocode
```

默认模型

默认模型是 kilocode/kilo/auto，由 Kilo Gateway 管理的智能路由模型。

INFO

OpenClaw 将 kilocode/kilo/auto 作为稳定默认引用，但未发布从该路由到上游模型的任务映射。kilocode/kilo/auto 后的精确上游路由由 Kilo Gateway 控制，不在 OpenClaw 中硬编码。

内置模型列表

OpenClaw 启动时从 Kilo Gateway 动态发现可用模型。使用 /models kilocode 查看你账号下的完整模型列表。

网关上的所有模型均可通过 kilocode/ 前缀引用：

模型引用	说明
`kilocode/kilo/auto`	默认 — 智能路由
`kilocode/anthropic/claude-sonnet-4`	Anthropic 通过 Kilo
`kilocode/openai/gpt-5.5`	OpenAI 通过 Kilo
`kilocode/google/gemini-3.1-pro-preview`	Google 通过 Kilo
...更多	使用 `/models kilocode` 列出全部

TIP

启动时 OpenClaw 查询 GET https://api.kilo.ai/api/gateway/models，并将发现的模型合并到静态回退目录之前。内置回退目录始终包含 kilocode/kilo/auto（Kilo Auto），其 input: ["text", "image"]、reasoning: true、contextWindow: 1000000、maxTokens: 128000。

配置示例

json5

{
  env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
  agents: {
    defaults: {
      model: { primary: "kilocode/kilo/auto" },
    },
  },
}

传输层和兼容性

Kilo Gateway 源码标注为 OpenRouter 兼容，因此走代理式 OpenAI 兼容路径而非原生 OpenAI 请求整形。

- Gemini 支持的 Kilo 引用走代理 Gemini 路径，OpenClaw 会在该路径上保留 Gemini 思想签名清理，但不启用原生 Gemini 重放验证或启动重写。
- Kilo Gateway 底层使用 Bearer Token 携带你的 API Key。

流包装与推理支持

Kilo 的通用流包装器添加 provider 应用头，并对支持的具体模型引用标准化代理推理载荷。

WARNING

`kilocode/kilo/auto` 及其他不支持代理推理的提示会跳过推理注入。如果需要推理支持，请使用具体模型引用，例如 `kilocode/anthropic/claude-sonnet-4`。

Troubleshooting

- 如果启动时模型发现失败，OpenClaw 回退到包含 `kilocode/kilo/auto` 的静态目录。
- 确认你的 API Key 有效，并且 Kilo 账号已启用期望的模型。
- 当 Gateway 以守护进程运行时，确保 `KILOCODE_API_KEY` 对该进程可用（例如在 `~/.openclaw/.env` 或通过 `env.shellEnv`）。

常见问题

模型发现失败怎么办？

如果启动时发现失败，OpenClaw 会自动回退到内置静态目录，该目录只包含 kilocode/kilo/auto。请检查 KILOCODE_API_KEY 环境变量是否设置正确，以及你的 Kilo 账号是否启用了目标模型。守护进程运行时要确保环境变量在 ~/.openclaw/.env 或 env.shellEnv 中。

默认模型 `kilocode/kilo/auto` 支持推理吗？

不支持代理推理。kilocode/kilo/auto 会跳过推理注入。如果需要推理支持，请使用具体模型引用，例如 kilocode/anthropic/claude-sonnet-4。

Kilo Gateway 与 OpenAI SDK 完全兼容吗？

是的，Kilo Gateway 是 OpenAI 兼容的，只需将 base URL 改为 https://api.kilo.ai/api/gateway/ 并提供 Bearer Token 即可。大多数 OpenAI SDK 可直接使用。

Kilo Gateway 怎么接入 OpenClaw（统一 API 密钥） ​

快速开始 ​

默认模型 ​

内置模型列表 ​

配置示例 ​

相关文档 ​

常见问题 ​

模型发现失败怎么办？ ​

默认模型 kilocode/kilo/auto 支持推理吗？ ​

Kilo Gateway 与 OpenAI SDK 完全兼容吗？ ​