提供商

Moonshot AI

Moonshot 通过兼容 OpenAI 的端点提供 Kimi API。请配置该提供商，并将默认模型设置为 moonshot/kimi-k2.6，或者使用 kimi/kimi-code 配置 Kimi Coding。

内置模型目录

Model ref	名称	推理	输入	上下文	最大输出
`moonshot/kimi-k2.6`	Kimi K2.6	否	text, image	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	否	text, image	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	是	text	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	是	text	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	否	text	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 API

最适合： 通过 Moonshot Open Platform 使用 Kimi K2 模型。

选择你的端点区域

身份验证选择	端点	区域
`moonshot-api-key`	`https://api.moonshot.ai/v1`	国际
`moonshot-api-key-cn`	`https://api.moonshot.cn/v1`	中国

运行新手引导

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

或者使用中国端点：

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

设置默认模型

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

验证模型可用

openclaw models list --provider moonshot

运行实时冒烟测试

当你想在不影响正常会话的情况下验证模型访问和成本跟踪时，请使用隔离的状态目录：

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 下存储标准化后的 token 用量以及估算成本。

配置示例

{
  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

最适合： 通过 Kimi Coding 端点处理偏代码的任务。

运行新手引导

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

设置默认模型

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

验证模型可用

openclaw models list --provider kimi

配置示例

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

Kimi web 搜索

OpenClaw 还内置了 Kimi 作为 web_search 提供商，由 Moonshot web 搜索提供支持。

运行交互式 web 搜索设置

openclaw configure --section web

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

配置 web 搜索区域和模型

交互式设置会提示你输入：

设置	选项
API 区域	`https://api.moonshot.ai/v1`（国际）或 `https://api.moonshot.cn/v1`（中国）
Web 搜索模型	默认为 `kimi-k2.6`

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

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

高级配置

原生思考模式

Moonshot Kimi 支持二元原生思考模式：

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

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

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

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

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

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

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

工具调用 id 清理

Moonshot Kimi 提供的 tool_call id 形如 functions.<name>:<index>。OpenClaw 会原样保留它们，以便多轮工具调用继续正常工作。

若要对自定义的兼容 OpenAI 提供商强制进行严格清理，请设置 sanitizeToolCallIds: true：

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

流式用量兼容性

原生 Moonshot 端点（https://api.moonshot.ai/v1 和 https://api.moonshot.cn/v1）会在共享的 openai-completions 传输上声明流式用量兼容性。OpenClaw 会根据端点能力来判断，因此，指向相同原生 Moonshot 主机的兼容自定义提供商 id 也会继承相同的流式用量行为。

使用内置的 K2.6 定价时，包含输入、输出和缓存读取 token 的流式用量也会被转换为本地估算 USD 成本，用于 /status、/usage full、/usage cost 以及基于转录的会话记账。

端点与模型引用参考

提供商	Model ref 前缀	端点	身份验证环境变量
Moonshot	`moonshot/`	`https://api.moonshot.ai/v1`	`MOONSHOT_API_KEY`
Moonshot CN	`moonshot/`	`https://api.moonshot.cn/v1`	`MOONSHOT_API_KEY`
Kimi Coding	`kimi/`	Kimi Coding 端点	`KIMI_API_KEY`
Web 搜索	N/A	与 Moonshot API 区域相同	`KIMI_API_KEY` 或 `MOONSHOT_API_KEY`

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

Moonshot AI

内置模型目录

入门指南

Moonshot API

选择你的端点区域

运行新手引导

设置默认模型

验证模型可用

运行实时冒烟测试

配置示例

Kimi Coding

运行新手引导

设置默认模型

验证模型可用

配置示例

Kimi web 搜索

运行交互式 web 搜索设置

配置 web 搜索区域和模型

高级配置

相关内容

Ask OpenClaw

# 内置模型目录

# 入门指南

Moonshot API

选择你的端点区域

运行新手引导

设置默认模型

验证模型可用

运行实时冒烟测试

# 配置示例

Kimi Coding

运行新手引导

设置默认模型

验证模型可用

# 配置示例

# Kimi web 搜索

运行交互式 web 搜索设置

配置 web 搜索区域和模型

# 高级配置

# 相关内容

内置模型目录

入门指南

配置示例

配置示例

Kimi web 搜索

高级配置

相关内容