Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Kilo Gateway 提供一个统一 API,可将请求路由到单个端点和 API key 背后的多个模型。它兼容 OpenAI,因此大多数 OpenAI SDK 只需切换基础 URL 即可使用。
属性
提供商kilocode
凭证KILOCODE_API_KEY
APIOpenAI 兼容
基础 URLhttps://api.kilo.ai/api/gateway/

入门指南

1

创建账号

前往 app.kilo.ai,登录或创建账号,然后导航到 API Keys 并生成一个新密钥。
2

运行新手引导

openclaw onboard --auth-choice kilocode-api-key
或者直接设置环境变量:
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
3

验证模型可用

openclaw models list --provider kilocode

默认模型

默认模型是 kilocode/kilo/auto,这是一个由提供商拥有并由 Kilo Gateway 管理的智能路由模型。
OpenClaw 将 kilocode/kilo/auto 视为稳定的默认引用,但不会为该路由发布基于来源的任务到上游模型映射。kilocode/kilo/auto 背后的确切上游路由由 Kilo Gateway 拥有,而不是硬编码在 OpenClaw 中。

内置目录

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 列出全部
启动时,OpenClaw 会查询 GET https://api.kilo.ai/api/gateway/models,并将发现的模型合并到静态回退目录之前。内置回退始终包含 kilocode/kilo/autoKilo Auto),并带有 input: ["text", "image"]reasoning: truecontextWindow: 1000000maxTokens: 128000

配置示例

{
  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 的共享流包装器会添加提供商应用标头,并为受支持的具体模型引用规范化代理推理载荷。
kilocode/kilo/auto 和其他不支持代理推理的提示会跳过推理注入。如果你需要推理支持,请使用具体模型引用,例如 kilocode/anthropic/claude-sonnet-4
  • 如果启动时模型发现失败,OpenClaw 会回退到包含 kilocode/kilo/auto 的内置静态目录。
  • 确认你的 API key 有效,并且你的 Kilo 账号已启用所需模型。
  • 当 Gateway 网关以守护进程运行时,请确保 KILOCODE_API_KEY 可供该进程使用(例如在 ~/.openclaw/.env 中,或通过 env.shellEnv)。

相关

模型选择

选择提供商、模型引用和故障转移行为。

配置参考

完整的 OpenClaw 配置参考。

Kilo Gateway

Kilo Gateway 仪表板、API keys 和账号管理。