OpenClaw 连接 Kimi(Moonshot)完整图文实操教程

一、前置准备

开始配置接入前,请提前核对完成全部前置条件,避免配置成功但无法调用模型:

  • 已安装并可正常启动运行 OpenClaw Windows 客户端

  • OpenClaw 顶部 Gateway 状态保持在线,无离线、报错异常。

  • 电脑网络正常,可稳定访问 Kimi 月之暗面开放平台。

  • 拥有可正常登录的 Kimi(Moonshot)账号

  • 建议账号内预留少量可用余额,便于创建密钥后直接测试模型调用。

  • 可正常访问 Kimi 开放平台官方地址:https://platform.moonshot.cn/

openclaw一键安装包获取如下图:

二、详细图文接入步骤

步骤 1:打开 Kimi 开放平台并进入登录页

打开浏览器,访问 Kimi 开放平台官方网址:https://platform.moonshot.cn/

进入平台首页后,点击页面右上角登录按钮,进入账号登录界面。

步骤 2:同意协议并完成账号登录

在登录页面完成以下操作:

  1. 勾选页面下方用户协议及隐私政策选项;

  2. 选择登录方式,支持微信扫码登录、手机号快捷登录、账号密码登录

  3. 完成验证后,成功进入 Kimi 开放平台控制台。

步骤 3:进入用户中心,充值并打开 API Key 管理

登录控制台后,按流程操作:

  1. 点击页面右上角用户中心

  2. 查看账户余额,若余额不足,先点击充值补充额度,避免模型调用失败;

  3. 在左侧菜单栏找到并进入 API Key 管理 页面;

账户已有可用余额可直接进入 API Key 管理页面,无需重复充值。

步骤 4:新建专属 API Key

进入 API Key 管理页面后,点击页面右上角 新建 API Key 按钮,开启密钥创建流程。

步骤 5:填写信息并确认创建密钥

在弹出的创建密钥窗口中,按要求填写参数,全程默认配置即可:

  • API Key 名称:自定义填写,例如 测试、OpenClaw、个人设备专用,方便后期识别管理;

  • 项目:保持默认 default,无需修改;

  • 参数确认无误后,点击确定完成创建。

步骤 6:复制并妥善保存密钥(核心关键步骤)

Kimi(Moonshot)API Key 仅在创建成功瞬间展示完整密钥,关闭弹窗后无法二次查看完整内容。

创建成功后,请立即点击复制按钮,完整保存密钥,妥善存放不要随意外泄、转发他人,保障账号接口安全。

步骤 7:OpenClaw 配置密钥并测试连通性

返回 OpenClaw 客户端,按步骤完成配置:

  1. 点击客户端右上角 设置

  2. 左侧菜单栏选择 模型配置

  3. 找到 Moonshot / Kimi 配置卡片;

  4. 粘贴刚刚复制的完整 Kimi API Key;

  5. 点击 测试,等待提示连接成功、识别可用模型;

  6. 最后点击右上角 保存全部配置

配置说明:Kimi 官方接口默认地址为 https://api.moonshot.cn/v1/models,默认无需手动修改,仅填写密钥即可完成配置。

步骤 8:聊天页面选择 Kimi 系列模型

配置保存完成后,进入 OpenClaw 左侧 聊天 页面:

  1. 在顶部模型选择框中搜索关键词 kimi

  2. 选择官方可用模型,推荐:kimi-k2.5、kimi-k2.6

  3. 确认模型右侧带有 moonshot 提供商标签,确保模型来源正确。

步骤 9:发送测试消息,验证接入成功

选中 Kimi 模型后,发送任意测试消息,例如:你好,你是什么模型

若客户端可正常返回 AI 回复,且顶部状态栏显示当前模型为 kimi-k2.6 / kimi-k2.5 · moonshot,即代表 OpenClaw 成功接入 Kimi 模型,可正常使用。

三、接入完成自检清单

逐项核对,排查遗漏问题,确保稳定使用:

  • ✅ 可正常访问并登录 Kimi 开放平台官网

  • ✅ 成功登录 Moonshot 控制台,账号状态正常

  • ✅ 账户余额充足,已按需完成充值

  • ✅ 成功进入 API Key 管理页面并新建专属密钥

  • ✅ 完整复制、妥善保存 API Key,无遗漏缺失

  • ✅ OpenClaw 中 Moonshot / Kimi 模块密钥粘贴正确

  • ✅ 密钥测试成功,客户端成功识别可用模型

  • ✅ 已保存全部配置参数

  • ✅ 聊天页成功选中带 moonshot 标签的 Kimi 模型

  • ✅ 发送测试消息,模型可正常回复调用

四、常见问题解答

1. OpenClaw 中 Kimi 为什么显示为 Moonshot / Kimi?

Kimi 是月之暗面(Moonshot AI)旗下大模型,其开放平台服务商主体为 Moonshot,因此 OpenClaw 内统一标注为 Moonshot / Kimi,直接粘贴你创建的 Kimi API Key 即可正常使用,无需额外修改。

2. 密钥测试失败如何排查?

优先排查高频问题,快速解决故障:

  • 检查 API Key 是否完整复制,无截断、无多余空格、无字符缺失;

  • 确认密钥粘贴在 Moonshot / Kimi 配置栏,未粘贴至其他模型通道;

  • 检查电脑网络是否正常,可正常访问 Kimi 官方接口;

  • 确认 Moonshot 账号余额充足,无欠费、额度耗尽情况;

  • 配置修改后必须点击「保存全部配置」,否则配置不生效。

3. 未及时保存 API Key 怎么办?

Kimi 密钥仅创建时展示一次完整内容,关闭弹窗后无法查看完整密钥。若未及时保存,只能删除原有旧密钥,重新创建新的 API Key 并配置。

4. 聊天页面搜索不到 Kimi 模型?

按顺序逐步排查即可解决:

  1. 确认 Moonshot / Kimi 密钥测试成功,接口连通正常;

  2. 确认已点击「保存全部配置」;

  3. 刷新模型列表,重新搜索 kimi;

  4. 仍无模型可重启 OpenClaw 客户端重试。

五、官方参考地址

Kimi(Moonshot)开放平台官网:https://platform.moonshot.cn/

Kimi 官方默认接口地址:https://api.moonshot.cn/v1/models

openclaw一键安装包获取如下图:

Logo

更多推荐