OpenClaw 配置 Kimi：K3 接入与 K2.5 迁移

截至 2026 年 9 月 24 日，Kimi 官方 API 上已经没有 K2.5：kimi-k2.5 在 2026 年 8 月 31 日全平台下线，官方给出的替代是 kimi-k3。在 OpenClaw 里接 Kimi，现在的做法是装官方 Moonshot 插件，用 Kimi 开放平台的 API Key 完成新手引导，再把默认模型设成 moonshot/kimi-k3（Kimi 开放平台：在 OpenClaw 中连接 Kimi）。

动手前确认两件事：账户里有可用余额，K3 没有余额调用不了；API Key 和认证选项属于同一个区域，否则会返回 401。中国区账号（platform.kimi.com，端点 https://api.moonshot.cn/v1 ）执行这组命令：

openclaw plugins install @openclaw/moonshot-provider
openclaw gateway restart
openclaw onboard --auth-choice moonshot-api-key-cn
openclaw models set moonshot/kimi-k3
openclaw models list --provider moonshot

国际版账号（platform.kimi.ai，端点 https://api.moonshot.ai/v1 ）把第三行的认证选项换成 moonshot-api-key。配好后打开 Control UI（地址在新手引导或 Gateway 的输出里），底部显示 kimi-k3 · moonshot 就说明已经在用 K3。

原来按 K2.5 教程配过的，不用重装 OpenClaw，按下面“从 K2.5 迁到 K3”一节改默认模型、清掉旧条目即可；还没装 OpenClaw 的，先看 OpenClaw 安装与集成指南。

先按你的情况选路线：OpenClaw 接 Kimi 的四种做法

“OpenClaw 接 Kimi”有四种做法。从上往下问三个问题，第一个回答“是”的就是你的路线，都不是就走默认的 Moonshot 插件：

四种做法用到的 key、端点和模型引用各不相同：

Moonshot 和 Kimi Coding 是两个独立插件，key 不能互换，端点和模型前缀（moonshot/... 与 kimi/...）也不同（OpenClaw 文档：Moonshot AI）。把 Kimi Code 的 key 填进 Moonshot 插件，会得到 401 / Invalid Authentication。

还想用 K2.5 的，官方接口这条路已经断了，只能找第三方托管。截至 2026 年 9 月 24 日，OpenRouter 上还有 SiliconFlow、AtlasCloud、Venice、Novita、Amazon Bedrock 这 5 家在提供 moonshotai/kimi-k2.5，月之暗面自己的端点已不在其中，输入价格在每百万 tokens $0.45–$0.60 之间，按 OpenRouter 的美元报价计费。已经装好 OpenClaw 的，不用重走完整的新手引导，登录 OpenRouter 再切模型即可：

openclaw models auth login --provider openrouter --method api-key
openclaw models set openrouter/moonshotai/kimi-k2.5

托管方和价格变化频繁，任何一家都可能停止提供 K2.5，这条路适合过渡，不适合长期依赖。OpenRouter 上同样有 K3（openrouter/moonshotai/kimi-k3），共 20 个端点，其中包括月之暗面自己的端点，每百万 tokens 输入 $3、输出 $15。

从 K2.5 迁到 K3：五步改完

8 月 31 日之后，Kimi 官方接口不再提供 kimi-k2.5，默认模型还停在 moonshot/kimi-k2.5 的 OpenClaw 必须改。同一天下线的还有 moonshot-v1 系列；更早的 kimi-k2 系列（kimi-k2-0905-preview、kimi-k2-turbo-preview、kimi-k2-thinking 等）已在 2026 年 5 月 25 日下线。Kimi 对这些旧模型给出的替代都是 kimi-k3（Kimi 模型列表）。配置里出现其中任何一个，都按下面五步处理。

第 1 步：确认现在用的是哪个模型

打开 Control UI，看底部显示的模型名。如果是 kimi-k2.5 · moonshot 或别的旧 ID，说明默认模型还没改。接着备份配置文件，把里面所有旧模型 ID 搜出来：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
grep -n -E "kimi-k2\.5|k2p5|kimi-k2-|moonshot-v1" ~/.openclaw/openclaw.json

搜出来的行号留着，第 4 步要用。

第 2 步：更新 Moonshot 插件并重启 Gateway

openclaw plugins update @openclaw/moonshot-provider
openclaw gateway restart

之前没装过这个插件的，把 update 换成 install。Kimi 的官方指南按 OpenClaw 2026.7.1 编写；如果更新插件后模型列表里仍没有 K3，先按官方入口把 OpenClaw 本身升级到新版本。

第 3 步：把默认模型切到 K3

openclaw models list --provider moonshot
openclaw models set moonshot/kimi-k3

列表里能看到 moonshot/kimi-k3 再执行 set。升级后列表里始终没有 K3，按下文“K3 不在列表时手动补条目”处理。

第 4 步：清掉旧条目

按第 1 步搜出的位置逐个处理：

• agents.defaults.models 里 "moonshot/kimi-k2.5" 之类的别名条目，删掉或改成 K3 的引用。
• models.providers.moonshot.models 里手写的 "id": "kimi-k2.5" 条目删掉，其他模型条目保留。
• 用 Kimi Code 会员、配置里写着 kimi/k2p5 的：OpenClaw 会自动把它当作 kimi/kimi-for-coding，不会报错，但它已经不是 K2.5，建议直接改成下文 Kimi Coding 一节里的当前引用。
• 旧教程截图里的“Moonshot AI (Kimi K2.5)”预设和 moonshot/kimi-k2.5 都是历史选项，重新走向导时不要选。

第 5 步：确认已经在用 K3

最直接的办法是看 Control UI：底部应显示 kimi-k3 · moonshot，发一条消息能正常回复。想在命令行里确认，可以跑一次 OpenClaw 文档里的冒烟测试：

openclaw agent --local \
  --session-id kimi-check \
  --message 'Reply exactly: KIMI_LIVE_OK' \
  --thinking max \
  --json

返回的 JSON 里 provider 应为 "moonshot"，model 应为 "kimi-k3"。文档原版在命令前加了 OPENCLAW_CONFIG_PATH 和 OPENCLAW_STATE_DIR 两个变量，把配置和状态放进 /tmp 下的独立目录，好在不碰日常会话的情况下测试；这里去掉它们，检查的就是你正在用的那份配置。

中国区和国际版：key 与端点不能混用

Kimi 开放平台分中国区和国际版两套账号体系，key、端点、计价货币都各自独立，一边的 key 不能拿去调另一边：

中国区的新手引导依次是：Model.auth provider 选 Moonshot，Model AI auth method 选 Kimi API key (.cn)，在 Enter Moonshot API Key (.cn) 处输入中国区 key，向导结束后把默认模型设为 moonshot/kimi-k3。向导里暂时看不到 K3 不影响，先完成认证，再用 models list 和 models set 设置。

和区域有关的几个易错点：

• 两个区域用同一个环境变量名 MOONSHOT_API_KEY。从国际版换到中国区（或反过来）后，旧 key 可能还留在环境变量里，这时重新运行新手引导，重新输入当前区域的 key。
• 想确认 OpenClaw 连的是哪个区域，看 ~/.openclaw/openclaw.json 里 models.providers.moonshot.baseUrl 是 .cn 还是 .ai。
• 组织开了 IP 白名单的，先把调用 API 的电脑或 Gateway 的出口 IPv4 地址加进白名单。
• API Key 只在本机向导或终端里输入，不要写进文档、截图、代码仓库或聊天记录。

用 K3 还是 K2.7 Code：能力与价格

Moonshot 插件内置目录里的三个模型：

• moonshot/kimi-k3：Kimi 目前能力最强的模型，2.8 万亿参数，原生视觉理解，上下文 1,048,576 tokens（1M）。它始终开启思考；直接调 API 时推理强度有 low、high、max 三档，但 OpenClaw 的 Moonshot 路线对 K3 只提供 /think max，每次都按 max 发送。temperature、top_p 这类采样参数由 K3 固定，OpenClaw 会自动去掉（Kimi K3 说明）。
• moonshot/kimi-k2.7-code：专门的编程模型，上下文 262,144 tokens（256K），同样始终思考，不兼容的参数由 OpenClaw 替你省略。
• moonshot/kimi-k2.7-code-highspeed：K2.7 Code 的高速版，Kimi 标称输出约 180 tokens/s，短上下文最高约 260 tokens/s，单价是 K2.7 Code 的两倍。

kimi-k2.6 仍在 Kimi API 上，支持思考与非思考两种模式，也是 OpenClaw 里 Kimi 搜索的默认模型，但 OpenClaw 英文文档的内置目录目前只列上面三个。

截至 2026 年 9 月 24 日，中国区定价页的价格（人民币，每百万 tokens）：

K3 的缓存写入另外计费：TTL 5 分钟档 ¥20.00、1 小时档 ¥40.00，不指定时按 5 分钟档；命中缓存的输入只按命中价计费，不再重复收写入费。

国际版（platform.kimi.ai 定价页）按美元计价、不含税，每百万 tokens：

国际版 K3 的缓存写入为 $3.00（5 分钟）或 $6.00（1 小时），账户至少充值 $1 才能调用 K3。

按中国区单价，K3 的输入约是 K2.7 Code 的 3 倍（¥20 对 ¥6.50），输出约 3.7 倍（¥100 对 ¥27）。放到一次长任务里看：假设累计输入 30 万 tokens，其中 20 万命中缓存，输出 3 万 tokens，费用 = 未命中输入 × 未命中单价 + 命中输入 × 命中单价 + 输出 × 输出单价（数量按百万 tokens 计）：

• K3：0.1 × ¥20 + 0.2 × ¥2 + 0.03 × ¥100 = ¥5.40
• K2.7 Code：0.1 × ¥6.50 + 0.2 × ¥1.30 + 0.03 × ¥27 = ¥1.72

这个示例没算 K3 另计的缓存写入费和税，只用来比较两者的量级；实际用量以接口返回的 usage 和控制台账单为准。

怎么选：默认用 K3。主要让 OpenClaw 写代码、跑终端任务，又在意成本的，可以把默认模型换成 K2.7 Code；需要超过 256K 上下文的任务留给 K3。

openclaw models set moonshot/kimi-k2.7-code

还在考虑 Kimi 以外的国产模型，可以看 DeepSeek V4 Flash、Kimi K3、GLM-5.2 怎么选。

用 Kimi Code 会员 key 配置

Kimi Code 会员的 key 在 Kimi Code 控制台创建，要装另一个插件 Kimi Coding，和开放平台的 Moonshot 插件互不相通：

openclaw plugins install @openclaw/kimi-provider
openclaw onboard --auth-choice kimi-code-api-key
openclaw models list --provider kimi
openclaw models set kimi/kimi-for-coding

这条路线的 key 环境变量是 KIMI_API_KEY，端点是 https://api.kimi.com/coding/v1 （OpenAI 兼容）和 https://api.kimi.com/coding/ （Anthropic 兼容），插件走的是 Anthropic Messages。截至 2026 年 9 月 24 日，OpenClaw 英文文档列出的模型引用是：

• kimi/kimi-for-coding 与 kimi/kimi-for-coding-highspeed
• kimi/k3：最高 1M 上下文，按会员档位开放，你的会员实际能用的上限可能更低
• kimi/k3-256k：256K 上下文，额度消耗更少

旧引用会被自动改写：kimi/kimi-code 和 kimi/k2p5 变成 kimi/kimi-for-coding，kimi/k3[1m] 变成 kimi/k3。OpenClaw 中文文档这部分还是旧写法（kimi/k3 为 256K、kimi/k3[1m] 为 1M），以英文页为准。

和 Moonshot 路线不同，这里的 K3 可以调思考强度：/think minimal 或 low 对应 low，medium、high、adaptive 对应 high（默认），xhigh 或 max 对应 max，/think off 关闭思考。会员价格和额度以 Kimi 官方定价页当日显示为准。

Kimi Claw 是什么：用 Kimi Claw 还是自己部署

Kimi Claw 是 Kimi 官方托管在云端的 OpenClaw。在 Kimi 里点“创建”，大约 1 分钟部署完成，并自动配置 Kimi K3；之后 7×24 在线，自带 40GB 云存储、5,000 多个 ClawHub 技能、定时任务，以及可在设置里打开的网页版 SSH 终端（Kimi Claw 介绍，2026 年 8 月 12 日更新）。

判断方法：

• 没有常开的机器、不想自己维护，而且已经是或愿意开通 Allegretto 及以上会员，选 Kimi Claw。Allegretto 的价格以 Kimi 会员页面当日显示为准。
• 已经有服务器或常开的电脑，想按 tokens 控制花费、换用其他厂商的模型，或者希望数据留在自己机器上，自己部署。
• 已经在本地跑 OpenClaw，又想在 Kimi 里用它：在 Kimi Claw 页面选择关联已有的 OpenClaw（英文界面为 Link existing OpenClaw），按提示在你的设备上安装 Kimi 插件，这一步免费。

Kimi Claw 不回复消息时按这个顺序处理：先刷新页面，连接可能断了；不行就到设置里重启 Kimi Claw（Restart Kimi Claw），等重启完再发；还不行，用设置里的自动修复（Auto-fix Kimi Claw）。另外，网页终端和插件共用一条通信通道，重启 OpenClaw 的 Gateway 会让终端断开连接。

配置 Kimi 搜索

Moonshot 插件还会把 Kimi 注册成 OpenClaw 的联网搜索（web_search）提供方，用的同样是 Kimi 开放平台的 key：

openclaw configure --section web

在联网搜索部分选 Kimi，按提示选择 API 区域（https://api.moonshot.cn/v1 或 https://api.moonshot.ai/v1 ）和搜索模型（默认 kimi-k2.6）。key 从 MOONSHOT_API_KEY 或 KIMI_API_KEY 读取，用 Gateway 方式安装的可以写进 ~/.openclaw/.env；配置保存在 plugins.entries.moonshot.config.webSearch 下（OpenClaw 文档：Kimi 搜索）。

用之前知道这几点：

• 返回的是一段综合答案加行内引用，不是一串排好序的结果链接。
• Kimi Coding 路线也用 KIMI_API_KEY 存会员 key。两条路线都配了的，在 webSearch 配置里单独填上开放平台的 apiKey，免得搜索读到会员 key。
• 聊天走中国区端点、搜索又没单独设 baseUrl 时，搜索会自动沿用 .cn 端点；手动给搜索填了国际端点，.cn 的 key 会收到 401。
• Kimi 没有真正联网就直接作答时，OpenClaw 返回 kimi_web_search_ungrounded 错误。可以重试，或改用 Brave 这类返回结果列表的搜索；已经有目标网址时，用 web_fetch 或浏览器工具。
• 搜索调用由 Moonshot 计费，价格见开放平台定价页里的“联网搜索定价”。

401、找不到 Moonshot、列表没有 K3：报错时先查什么

key 类错误和限速的通用排查见 OpenClaw API Key 错误与速率限制排错指南，与 Kimi 无关的报错查 OpenClaw 错误排查中心。

K3 不在列表时手动补条目

更新插件、重启 Gateway 之后列表里还是没有 K3，可以在 ~/.openclaw/openclaw.json 的 models.providers.moonshot.models 里补一条 K3，已有模型保留。下面是 Kimi 官方指南给出的中国区写法，国际版把 baseUrl 换成 https://api.moonshot.ai/v1：

{
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "api": "openai-completions",
        "models": [{
          "id": "kimi-k3",
          "name": "Kimi K3",
          "reasoning": true,
          "input": ["text", "image", "video"],
          "contextWindow": 1048576,
          "maxTokens": 8192,
          "thinkingLevelMap": {
            "off": null,
            "minimal": "max",
            "low": "max",
            "medium": "max",
            "high": "max",
            "xhigh": "max",
            "max": "max"
          },
          "compat": {
            "maxTokensField": "max_tokens",
            "supportsUsageInStreaming": false,
            "requiresStringContent": true,
            "supportsReasoningEffort": true,
            "supportedReasoningEfforts": ["minimal", "low", "medium", "high", "xhigh", "max"]
          }
        }]
      }
    }
  }
}

contextWindow 保持 1M；maxTokens 的 8192 是 OpenClaw 单次回复的上限，不要把 1M 输入窗口当成单次输出上限。maxTokensField、supportsUsageInStreaming、requiresStringContent 三项是 K3 的兼容性设置，不能删。补完后重新执行 openclaw models set moonshot/kimi-k3。内置目录里已经有 K3 时不需要这段。

常见问题

OpenClaw 中文文档说新手引导默认用 K2.6，该按哪个来？

按英文原页和 Kimi 官方指南来。截至 2026 年 9 月 24 日，OpenClaw 中文版 Moonshot 页面仍保留“新手引导默认 K2.6”的旧说法，目录里也还列着 K2.5；同一天的英文原页已改为新装时默认选 moonshot/kimi-k3，Kimi 的指南同样要求设为 moonshot/kimi-k3。不要依赖向导的默认值：装完用 openclaw models list --provider moonshot 看一眼，再用 openclaw models set moonshot/kimi-k3 显式设置。

在 OpenClaw 里还能用 Kimi K2.5 吗？

Kimi 官方 API 上不能，kimi-k2.5 已于 2026 年 8 月 31 日下线。要继续用只能找第三方托管，比如 OpenRouter：截至 2026 年 9 月 24 日有 5 家托管方在提供，随时可能变动，接法见“先按你的情况选路线”一节。Kimi Code 会员配置里的 kimi/k2p5 会被自动改指向 kimi/kimi-for-coding，已经不是 K2.5。

在 OpenClaw 里能把 K3 的思考强度调低吗？

走 Moonshot 插件（开放平台 key）时不能：OpenClaw 对 K3 只提供 /think max，每次请求都带 reasoning_effort: "max"，之前设过的更低档位或关闭思考的设置会被忽略。K3 本身支持 low、high、max 三档；在 OpenClaw 里想用低档位，可以改走 Kimi Coding 路线的 kimi/k3，用 /think 调节，也可以 /think off 关闭思考。

OpenClaw 显示的费用为什么和 Kimi 账单对不上？

/status、/usage cost 里的费用是 OpenClaw 按内置目录的美元单价估算的（K3 每百万 tokens 输入 $3、输出 $15）。中国区账号按人民币计费（K3 输入 ¥20、输出 ¥100），两边口径不同，不能直接对照。内置目录还把 K3 的缓存写入记为 0，而 Kimi 实际按档位收取写入费，所以国际版账号的估算也可能偏低。扣费以 Kimi 开放平台控制台的账单为准。

OpenClaw、Clawdbot、Moltbot 是同一个东西吗？

是。OpenClaw 的前身叫 Clawdbot 和 Moltbot，是开源、自托管的 AI 智能体平台，能接入 WhatsApp、Telegram、Discord、Slack、Signal 等聊天应用。Kimi 是月之暗面（Moonshot AI）的模型与 API 服务，“OpenClaw 配置 Kimi”就是让 OpenClaw 调用 Kimi 模型；Kimi Claw 则是 Kimi 官方托管的 OpenClaw。想把 OpenClaw 接到 Telegram，可以看 OpenClaw Telegram 设置指南。