快速开始
Kilo Gateway 网关
Kilo Gateway 提供一个统一 API，可将请求通过单个端点和 API key 路由到许多模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换 base URL 即可工作。
| 属性 | 值 |
|---|---|
| 提供商 | kilocode |
| 凭证 | KILOCODE_API_KEY |
| API | 兼容 OpenAI |
| Base URL | https://api.kilo.ai/api/gateway/ |
入门指南
创建账户
前往 app.kilo.ai，登录或创建账户，然后导航到 API Keys 并生成一个新 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，这是由 Kilo Gateway 管理、提供商拥有的智能路由模型。
内置目录
OpenClaw 会在启动时从 Kilo Gateway 动态发现可用模型。使用 /models kilocode 查看你的账户可用模型完整列表。
Gateway 网关上任何可用模型都可以配合 kilocode/ 前缀使用：
| 模型 ref | 备注 |
|---|---|
kilocode/kilo/auto |
默认 — 智能路由 |
kilocode/anthropic/claude-sonnet-4 |
通过 Kilo 使用 Anthropic |
kilocode/openai/gpt-5.5 |
通过 Kilo 使用 OpenAI |
kilocode/google/gemini-3-pro-preview |
通过 Kilo 使用 Google |
| ...以及更多 | 使用 /models kilocode 列出全部 |
配置示例
{
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 refs 会保持在 proxy-Gemini 路径上，因此 OpenClaw 会在那里保留 Gemini 思考签名清理，而不会启用原生 Gemini 重放验证或 bootstrap 重写。
- Kilo Gateway 在底层使用 Bearer token 和你的 API key。
流包装器和推理
Kilo 的共享流包装器会添加提供商应用 header，并为受支持的具体模型 refs 规范化代理推理 payload。
故障排除
- 如果模型发现启动时失败，OpenClaw 会回退到包含
kilocode/kilo/auto的内置静态目录。 - 确认你的 API key 有效，并且你的 Kilo 账户已启用所需模型。
- 当 Gateway 网关作为守护进程运行时，确保
KILOCODE_API_KEY对该进程可用（例如在~/.openclaw/.env中，或通过env.shellEnv）。