提供商

Kilo Gateway 网关

Kilo Gateway 网关通过单个兼容 OpenAI 的端点和 API key,将请求路由到多个模型。

属性
提供商 kilocode
身份验证 KILOCODE_API_KEY
API 兼容 OpenAI
基础 URL https://api.kilo.ai/api/gateway/

安装插件

bash
openclaw plugins install @openclaw/kilocode-provideropenclaw gateway restart

设置

  • 创建账户

    前往 app.kilo.ai,登录或创建账户,然后生成 API key。

  • 运行新手引导

    bash
    openclaw onboard --auth-choice kilocode-api-key

    或直接设置环境变量:

    bash
    export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
  • 验证模型是否可用

    bash
    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/balancedAuto Balancedinput: ["text", "image"]reasoning: truecontextWindow: 1000000maxTokens: 65536)。

    Gateway 网关上的任何模型都可通过 kilocode/<upstream-id> 寻址(例如 kilocode/anthropic/claude-sonnet-4kilocode/openai/gpt-5.5)。运行 /models kilocodeopenclaw models list --provider kilocode 可查看发现的完整列表。

    配置示例

    json5
    {  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 提供)。

    相关内容

    Was this useful?
    On this page

    On this page