Moonshot AI

Moonshot 提供了与 OpenAI 兼容的 Kimi API 端点。配置提供商并将默认模型设置为 MoonshotAPIOpenAImoonshot/kimi-k2.6，或者使用 Kimi Coding 和 kimi/kimi-for-coding。

Warning

Moonshot 和 Kimi Coding 是

独立的提供商

。密钥不可互换，端点不同，且模型引用也不同（

moonshot/...

vs

kimi/...

）。

内置模型目录

模型引用	名称	推理	输入	上下文	最大输出
moonshot/kimi-k2.6	Kimi K2.6	否	文本、图像	262,144	262,144
moonshot/kimi-k2.5	Kimi K2.5	否	文本、图像	262,144	262,144
moonshot/kimi-k2-thinking	Kimi K2 Thinking	是	文本	262,144	262,144
moonshot/kimi-k2-thinking-turbo	Kimi K2 Thinking Turbo	是	文本	262,144	262,144
moonshot/kimi-k2-turbo	Kimi K2 Turbo	否	文本	256,000	16,384

当前 Moonshot 托管的 K2 模型的捆绑成本估算使用 Moonshot 发布的按量付费费率：Kimi K2.6 缓存命中为 $0.16/MTok，输入为 $0.95/MTok，输出为 $4.00/MTok；Kimi K2.5 缓存命中为 $0.10/MTok，输入为 $0.60/MTok，输出为 $3.00/MTok。除非你在配置中覆盖，否则其他遗留目录条目保持零成本占位符。

入门指南

选择你的提供商并按照设置步骤操作。

Moonshot APIKimi Coding

最适用于： 通过 Moonshot 开放平台使用 Kimi K2 模型。

1. 选择您的端点区域

   认证选择	端点	区域
   moonshot-api-key	https://api.moonshot.ai/v1	国际版
   moonshot-api-key-cn	https://api.moonshot.cn/v1	中国大陆

2. 运行新手引导

   openclaw onboard --auth-choice moonshot-api-key

   或者针对中国端点：

   openclaw onboard --auth-choice moonshot-api-key-cn

3. 设置默认模型

   {
     agents: {
       defaults: {
         model: { primary: "moonshot/kimi-k2.6" },
       },
     },
   }

4. 验证模型可用性

   openclaw models list --provider moonshot

5. 运行实时冒烟测试

   当您想要验证模型访问权限和成本跟踪而不影响您的正常会话时，请使用隔离的状态目录：

   OPENCLAW_CONFIG_PATH=/tmp/openclaw-kimi/openclaw.json \
   OPENCLAW_STATE_DIR=/tmp/openclaw-kimi \
   openclaw agent --local \
     --session-id live-kimi-cost \
     --message 'Reply exactly: KIMI_LIVE_OK' \
     --thinking off \
     --json

   JSON 响应应报告 provider: "moonshot" 和 model: "kimi-k2.6"。当 Moonshot 返回使用元数据时，助手转录条目会将标准化的令牌使用情况以及估算成本存储在 usage.cost 下。

配置示例

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.6" },
      models: {
        // moonshot-kimi-k2-aliases:start
        "moonshot/kimi-k2.6": { alias: "Kimi K2.6" },
        "moonshot/kimi-k2.5": { alias: "Kimi K2.5" },
        "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" },
        "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" },
        "moonshot/kimi-k2-turbo": { alias: "Kimi K2 Turbo" },
        // moonshot-kimi-k2-aliases:end
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [
          // moonshot-kimi-k2-models:start
          {
            id: "kimi-k2.6",
            name: "Kimi K2.6",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0.95, output: 4, cacheRead: 0.16, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0.6, output: 3, cacheRead: 0.1, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-thinking",
            name: "Kimi K2 Thinking",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-thinking-turbo",
            name: "Kimi K2 Thinking Turbo",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-turbo",
            name: "Kimi K2 Turbo",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 16384,
          },
          // moonshot-kimi-k2-models:end
        ],
      },
    },
  },
}

适用于： 通过 Kimi Coding 端点进行的代码相关任务。

Note

Kimi Coding 使用与 Moonshot (moonshot/...Moonshot) 不同的 API 密钥和提供商前缀 (kimi/...API)。稳定的 API 模型引用是 kimi/kimi-for-coding；旧的引用 kimi/kimi-code 和 kimi/k2p5API 仍然被接受，并会规范化为该 API 模型 ID。

1. Run 新手引导

   openclaw onboard --auth-choice kimi-code-api-key

2. Set a default 模型

   {
     agents: {
       defaults: {
         model: { primary: "kimi/kimi-for-coding" },
       },
     },
   }

3. Verify the 模型 is available

   openclaw models list --provider kimi

配置示例

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "kimi/kimi-for-coding" },
      models: {
        "kimi/kimi-for-coding": { alias: "Kimi" },
      },
    },
  },
}

Kimi 网页搜索

OpenClaw 还内置了 Kimi 作为 OpenClawweb_searchMoonshot 提供商，由 Moonshot 网络搜索支持。

1. Run interactive web search setup

   openclaw configure --section web

   在网络搜索部分选择 Kimi 以存储 plugins.entries.moonshot.config.webSearch.*。

2. Configure the web search region and 模型

   交互式设置会提示以下内容：

   设置	选项
   API 区域	https://api.moonshot.ai/v1 (国际) 或 https://api.moonshot.cn/v1 (中国)
   网络搜索模型	默认为 kimi-k2.6

配置位于 plugins.entries.moonshot.config.webSearch 下：

{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // or use KIMI_API_KEY / MOONSHOT_API_KEY
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.6",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

高级配置

Native thinking mode

Moonshot Kimi 支持二进制原生思维模式：

• thinking: { type: "enabled" }
• thinking: { type: "disabled" }

通过 `agents.defaults.models.

.params` 为每个模型进行配置：

```json5
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
```OpenClaw

OpenClaw 还为 Moonshot 映射运行时 `/think`Moonshot 级别：

| `/think`Moonshot 级别       | Moonshot 行为          |
| -------------------- | -------------------------- |
| `/think off`         | `thinking.type=disabled`   |
| 任何非 off 级别    | `thinking.type=enabled`Moonshot    |

Warning

当启用 Moonshot 思维模式时，tool_choice 必须为 auto 或 noneOpenClaw。OpenClaw 会将不兼容的 tool_choice 值标准化为 auto 以确保兼容性。

Kimi K2.6 还接受一个可选的 thinking.keep 字段，用于控制 reasoning_content 的多轮保留。将其设置为 "all" 可在多轮对话中保留完整 推理过程；省略该字段（或将其保留为 nullOpenClaw）以使用服务器 默认策略。OpenClaw 仅会为 moonshot/kimi-k2.6 转发 thinking.keep， 并会将其从其他模型中移除。

{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}

Tool call id sanitization

Moonshot Kimi 提供的 tool_call ids 格式类似于 `functions.

:

`OpenClawOpenAI。OpenClaw 会原样保留它们，以确保多轮工具调用正常工作。

若要在自定义 OpenAI 兼容提供商上强制执行严格清理，请设置 `sanitizeToolCallIds: true`：

```json5
{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}
```

<Accordion title=“流式使用兼容性”Moonshot> 原生 Moonshot 端点（https://api.moonshot.ai/v1 和 https://api.moonshot.cn/v1）在共享的 openai-completionsOpenClawMoonshot 传输上声明了流式使用兼容性。OpenClaw 密钥会关闭端点 功能，因此针对相同原生 Moonshot 主机的兼容自定义提供商 ID 会继承相同的流式使用行为。

通过捆绑的 K2.6 定价，包含输入、输出
和缓存读取令牌的流式使用也会转换为本地估计的 USD 成本，
用于 `/status`、`/usage full`、`/usage cost` 和基于记录的会话
账户核算。

<Accordion title=“端点和模型引用参考”Moonshot> | 提供商 | 模型引用前缀 | 端点 | 认证环境变量 | | ---------- | ---------------- | ----------------------------- | ------------------- | | Moonshot | moonshot/ | https://api.moonshot.ai/v1 | MOONSHOT_API_KEYMoonshot | | Moonshot CN| moonshot/ | https://api.moonshot.cn/v1 | MOONSHOT_API_KEY | | Kimi Coding| kimi/ | Kimi Coding endpoint | KIMI_API_KEYMoonshotAPI | | Web search | N/A | Same as Moonshot API region | KIMI_API_KEY 或 MOONSHOT_API_KEY |

- Kimi 网络搜索使用 `KIMI_API_KEY` 或 `MOONSHOT_API_KEY`，默认为 `https://api.moonshot.ai/v1` 并配合模型 `kimi-k2.6`。
- 如有需要，请在 `models.providers`Moonshot 中覆盖定价和上下文元数据。
- 如果 Moonshot 为模型发布了不同的上下文限制，请相应地调整 `contextWindow`。

相关

模型选择

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

网络搜索

配置包括 Kimi 在内的网络搜索提供商。

配置参考

提供商、模型和插件的完整配置架构。

Moonshot 开放平台

Moonshot API 密钥管理和文档。