本页介绍如何在 OpenClaw 中接入 Moonshot AI（Kimi）。Moonshot 和 Kimi Coding 是两个独立的提供商，Key 不通用、端点不同、模型 ID 前缀不同（分别用 moonshot/... 和 kimi/...）。当前 Kimi K2 系列包括 kimi-k2.5、kimi-k2-thinking、kimi-k2-thinking-turbo、kimi-k2-turbo，全部拥有 262,144 token 上下文窗口。

Moonshot AI（Kimi）

Moonshot 通过 OpenAI 兼容端点提供 Kimi API。在 OpenClaw 中，将默认模型设为 moonshot/kimi-k2.5，或使用 Kimi Coding 接入 kimi/kimi-code。

重要：Moonshot 和 Kimi Coding 是独立提供商，Key 不可互换，端点不同，模型 ID 前缀也不同。

当前 Kimi K2 模型 ID

• kimi-k2.5
• kimi-k2-thinking
• kimi-k2-thinking-turbo
• kimi-k2-turbo

快速上手

Moonshot API Key

openclaw onboard --auth-choice moonshot-api-key
# 中国大陆用户
openclaw onboard --auth-choice moonshot-api-key-cn

• moonshot-api-key：国际端点 https://api.moonshot.ai/v1
• moonshot-api-key-cn：中国端点 https://api.moonshot.cn/v1

Kimi Coding

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

配置示例

Moonshot API（Kimi K2）

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.5" },
      models: {
        "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" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "kimi-k2.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, 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,
          },
        ],
      },
    },
  },
}

Kimi Coding 配置

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

Kimi 网页搜索

OpenClaw 内置 Kimi 作为 web_search 提供商，底层使用 Moonshot 网页搜索。

通过交互式配置设置：

openclaw configure --section web
# 在网页搜索区块选择 Kimi

或直接配置 plugins.entries.moonshot.config.webSearch：

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

原生 Thinking 模式（Moonshot）

Moonshot Kimi 支持二进制原生 thinking：

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

通过 agents.defaults.models.<provider/model>.params 按模型配置：

{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.5": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}

OpenClaw 还映射了运行时 /think 等级：

• /think off → thinking.type=disabled
• 任意非 off 等级 → thinking.type=enabled

启用 Moonshot thinking 时，tool_choice 必须为 auto 或 none。OpenClaw 会自动将不兼容的 tool_choice 值规范化为 auto。

注意事项

• Moonshot 模型 ID 前缀：moonshot/<modelId>；Kimi Coding 前缀：kimi/<modelId>
• 当前 Kimi Coding 默认模型：kimi/kimi-code；旧版 kimi/k2p5 仍作为兼容 ID 保留
• Kimi 网页搜索使用 KIMI_API_KEY 或 MOONSHOT_API_KEY，默认端点 https://api.moonshot.ai/v1，默认模型 kimi-k2.5
• 原生 Moonshot 端点支持流式 usage 兼容，基于端点能力检测自动启用

常见问题

Q: Moonshot 和 Kimi Coding 的 API Key 可以互用吗？

A: 不可以。两者是完全独立的提供商，Key、端点、模型 ID 都不同。Moonshot 使用 MOONSHOT_API_KEY，端点为 api.moonshot.ai 或 api.moonshot.cn；Kimi Coding 使用 KIMI_API_KEY，走独立的 Kimi Coding 端点。错误使用会导致认证失败。

Q: 我想用 Kimi K2 的 Thinking 模式，需要额外付费吗？

A: 是否需要额外付费取决于 Moonshot 的计费政策（请查阅 Moonshot 官方定价）。在 OpenClaw 中，通过设置 params.thinking: { type: "enabled" } 即可启用，无需额外配置，但要注意 Thinking 启用时 tool_choice 会被强制改为 auto。

Q: Kimi 网页搜索和普通 web_search 工具有什么区别？

A: Kimi 网页搜索是 Moonshot 提供的原生搜索 API，配置在 plugins.entries.moonshot.config.webSearch 下，会返回结构化的标题、URL 和摘要。设置 tools.web.search.provider: "kimi" 后，Agent 调用 web_search 工具时会自动走 Kimi 搜索路径。