提供商
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/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)。
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/balanced" }, }, },}行为说明
传输和兼容性
Kilo Gateway 网关兼容 OpenRouter,因此它使用代理式的 OpenAI 兼容请求
路径,而不是原生 OpenAI 请求结构(无 store,无 OpenAI 推理强度载荷)。
- 由 Gemini 支持的 Kilo 引用仍使用代理 Gemini 路径:OpenClaw 会在那里清理 Gemini 思考 签名,但不会启用原生 Gemini 重放验证或引导重写。
- 请求使用根据你的 API key 构建的 Bearer token。
流包装器和推理
Kilo 流包装器会添加 X-KILOCODE-FEATURE 请求标头(默认为 openclaw,
可通过 KILOCODE_FEATURE 环境变量覆盖),并为支持的模型规范化推理强度载荷。
故障排查
- 如果启动时模型发现失败,OpenClaw 会回退到包含
kilocode/kilo-auto/balanced的静态目录。 - 确认你的 API key 有效,并且你的 Kilo 账户已启用所需模型。
- 当 Gateway 网关作为守护进程运行时,请确保该进程可以使用
KILOCODE_API_KEY(例如位于~/.openclaw/.env中,或通过env.shellEnv提供)。