快速开始
Kilo Gateway 网关
Kilo Gateway 通过单个 OpenAI 兼容端点和 API key，将请求路由到多个模型。
| 属性 | 值 |
|---|---|
| 提供商 | kilocode |
| 身份验证 | KILOCODE_API_KEY |
| API | OpenAI 兼容 |
| 基础 URL | https://api.kilo.ai/api/gateway/ |
安装插件
openclaw plugins install @openclaw/kilocode-provideropenclaw gateway restart设置
创建账户
前往 app.kilo.ai，登录或创建账户，然后生成 API key。
运行新手引导
openclaw onboard --auth-choice kilocode-api-key或直接设置环境变量：
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret验证模型是否可用
openclaw models list --provider kilocode默认模型和目录
默认模型是 kilocode/kilo/auto，这是由提供商管理的智能路由模型。OpenClaw 不会
发布其任务到上游模型的映射；kilo/auto 背后的路由由 Kilo Gateway 管理。
启动时，OpenClaw 会查询 GET https://api.kilo.ai/api/gateway/models，并将发现的模型
合并到静态回退目录之前。静态回退目录仅包含 kilocode/kilo/auto（Kilo Auto、
input: ["text", "image"]、reasoning: true、contextWindow: 1000000、maxTokens: 128000）。
Gateway 网关上的任何模型都可以通过 kilocode/<upstream-id> 寻址（例如
kilocode/anthropic/claude-sonnet-4、kilocode/openai/gpt-5.5）。运行 /models kilocode 或
openclaw models list --provider kilocode 可查看发现的完整列表。
配置示例
{ env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret agents: { defaults: { model: { primary: "kilocode/kilo/auto" }, }, },}行为说明
传输和兼容性
Kilo Gateway 与 OpenRouter 兼容，因此它使用代理风格的 OpenAI 兼容请求
路径，而不是原生 OpenAI 请求格式（不含 store，也不含 OpenAI 推理强度载荷）。
- 由 Gemini 支持的 Kilo 引用仍使用代理 Gemini 路径：OpenClaw 会在该路径中清理 Gemini 思维 签名，但不会启用原生 Gemini 重放验证或引导重写。
- 请求使用根据你的 API key 构建的 Bearer 令牌。
流包装器和推理
Kilo 流包装器会添加 X-KILOCODE-FEATURE 请求标头（默认为 openclaw，
可通过 KILOCODE_FEATURE 环境变量覆盖），并为支持推理强度的
模型规范化相应载荷。
故障排查
- 如果启动时模型发现失败，OpenClaw 会回退到包含
kilocode/kilo/auto的静态目录。 - 确认你的 API key 有效，并且你的 Kilo 账户已启用所需模型。
- 当 Gateway 网关作为守护进程运行时，请确保该进程可使用
KILOCODE_API_KEY（例如将其放在~/.openclaw/.env中或通过env.shellEnv提供）。
