快速开始
Kilo Gateway 网关
Kilo Gateway 提供一个统一 API，可将请求路由到单个端点和 API key 背后的多个模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换基础 URL 即可使用。
| 属性 | 值 |
|---|---|
| 提供商 | kilocode |
| 凭证 | KILOCODE_API_KEY |
| API | OpenAI 兼容 |
| 基础 URL | https://api.kilo.ai/api/gateway/ |
入门指南
创建账号
前往 app.kilo.ai，登录或创建账号，然后导航到 API Keys 并生成一个新密钥。
运行新手引导
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/ 前缀：
| 模型引用 | 说明 |
|---|---|
kilocode/kilo/auto |
默认 — 智能路由 |
kilocode/anthropic/claude-sonnet-4 |
通过 Kilo 使用 Anthropic |
kilocode/openai/gpt-5.5 |
通过 Kilo 使用 OpenAI |
kilocode/google/gemini-3.1-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 引用会保留在代理 Gemini 路径上，因此 OpenClaw 会继续在那里执行 Gemini 思维签名清理，而不会启用原生 Gemini 重放验证或引导重写。
- Kilo Gateway 底层会使用带有你的 API key 的 Bearer token。
流包装器和推理
Kilo 的共享流包装器会添加提供商应用标头，并为受支持的具体模型引用规范化代理推理载荷。
故障排除
- 如果启动时模型发现失败，OpenClaw 会回退到包含
kilocode/kilo/auto的内置静态目录。 - 确认你的 API key 有效，并且你的 Kilo 账号已启用所需模型。
- 当 Gateway 网关以守护进程运行时，请确保
KILOCODE_API_KEY可供该进程使用（例如在~/.openclaw/.env中，或通过env.shellEnv）。