Kilo Gateway

Kilo Gateway 通过单个 OpenAI 兼容端点和 API 密钥，将请求路由到多个模型。

属性	值
提供商	`kilocode`
认证	`KILOCODE_API_KEY`
API	OpenAI 兼容
基础 URL	`https://api.kilo.ai/api/gateway/`

安装插件¶

openclaw plugins install @openclaw/kilocode-provider

安装会自动应用于正在运行的 Gateway；否则将在下次启动时生效。参见应用更改并检查.

设置¶

1. 创建账户

前往 app.kilo.ai，登录或创建账户，然后生成 API 密钥。

2. 运行引导设置

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

或直接设置环境变量：

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

3. 验证模型可用

openclaw models list --provider kilocode

引导设置会保留你的模型条目，并将生成的目录行留给发现机制。使用 models.mode: "replace" 时，它还会写入内置目录，因为该模式会跳过发现。

默认模型和目录¶

默认模型是 kilocode/kilo-auto/balanced，即 Kilo Gateway 的均衡智能路由层级。 OpenClaw 不会为其发布任务到上游模型的映射；kilo-auto/balanced 背后的路由由 Kilo Gateway 负责。

启动时，OpenClaw 会查询 GET https://api.kilo.ai/api/gateway/models，并将非空的公开列表与静态路由条目合并。静态目录仅包含 kilocode/kilo-auto/balanced（Auto Balanced、input: ["text", "image"]、reasoning: true、 contextWindow: 1000000、maxTokens: 65536）。

网关上的任何模型都可以以 kilocode/<upstream-id> 的形式寻址（例如 kilocode/anthropic/claude-sonnet-4、kilocode/openai/gpt-5.5）。运行 /models kilocode 或 openclaw models list --provider kilocode 可查看完整的已发现列表。

配置示例¶

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

行为说明¶

传输与兼容性

Kilo Gateway 与 OpenRouter 兼容，因此它使用代理式 OpenAI 兼容请求路径，而不是原生 OpenAI 请求整形（没有 store，没有 OpenAI reasoning-effort 负载）。

基于 Gemini 的 Kilo 引用仍走代理 Gemini 路径：OpenClaw 会在那里清理 Gemini 思维签名，但不会启用原生 Gemini 重放验证或引导重写。
请求使用由你的 API 密钥构建的 Bearer 令牌。

流包装器和推理

Kilo 流包装器会添加 `X-KILOCODE-FEATURE` 请求头（默认 `openclaw`，
可通过 `KILOCODE_FEATURE` 环境变量覆盖），并为支持该功能的模型规范化
reasoning-effort 负载。

Warning

kilocode/kilo-auto/balanced 和 x-ai/* 引用会跳过 reasoning-effort 注入。如果需要推理支持，请使用具体的模型引用，例如 kilocode/anthropic/claude-sonnet-4。

故障排查

如果模型发现失败，OpenClaw 会报告目录刷新不可用。它不会用静态行替换失败的请求，也不会将空响应转换为 kilocode/kilo-auto/balanced。
确认你的 API 密钥有效，并且你的 Kilo 账户已启用所需模型。
当 Gateway 作为守护进程运行时，确保 KILOCODE_API_KEY 对该进程可用（例如在 ~/.openclaw/.env 中或通过 env.shellEnv）。

模型选择

选择提供商、模型引用和故障转移行为。

配置参考

完整的 OpenClaw 配置参考。

Kilo Gateway

Kilo Gateway 仪表板、API 密钥和账户管理。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw