快速开始
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 reasoning-effort 载荷）。
- 基于 Gemini 的 Kilo 引用会保留在代理 Gemini 路径上：OpenClaw 会在那里清理 Gemini thought signatures，但不会启用原生 Gemini 重放验证或 bootstrap 重写。
- 请求使用由你的 API key 构建的 Bearer token。
流包装器和推理
Kilo 流包装器会添加 X-KILOCODE-FEATURE 请求头（默认 openclaw，
可用 KILOCODE_FEATURE 环境变量覆盖），并为支持它的模型规范化 reasoning-effort 载荷。
故障排查
- 如果启动时模型发现失败，OpenClaw 会回退到包含
kilocode/kilo/auto的静态目录。 - 确认你的 API key 有效，并且你的 Kilo 账户已启用所需模型。
- 当 Gateway 网关作为守护进程运行时，确保该进程可以使用
KILOCODE_API_KEY（例如在~/.openclaw/.env中，或通过env.shellEnv）。
