OpenClaw 2.7.9 对接 Moonshot Kimi 大模型完整实操教程

本文依托 Moonshot 开放平台后台操作逻辑、OpenClaw Windows 2.7.9 客户端模型配置规范整理，完整覆盖平台登录、账户余额充值、API 密钥创建、客户端密钥校验连通、切换模型对话整套操作流程，快速实现本地客户端调用 Kimi 系列大模型完成对话交互。

前置环境准备

1. 本地设备安装 OpenClaw 2.7.9 Windows 客户端，安装包体积 45.8MB
2. Windows 客户端下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
3. 苹果系统客户端下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C，软件可正常启动运行；
4. 保持 OpenClaw 顶部 Gateway 网关运行状态持续在线；
5. 设备网络通畅，可稳定访问 Moonshot 开放平台官网：https://platform.moonshot.cn/；
6. 拥有能够正常登录的 Moonshot（Kimi）平台账号；
7. 建议提前为账户预留可用余额，方便生成密钥后直接开展连通测试。

分步配置操作流程

步骤 1：进入 Moonshot 开放平台并发起登录

打开 Moonshot 开放平台官网地址：https://platform.moonshot.cn/ 进入首页后，点击页面右上角登录按钮，跳转至账号登录页面。

步骤 2：同意平台协议完成账号登录

登录页面操作流程：

1. 勾选页面下方用户协议同意选项；
2. 按需选择登录方式，支持微信扫码、手机号快捷登录、账号密码登录； 完成登录并成功进入平台控制台即代表本步骤操作完成。

步骤 3：进入用户中心，充值后打开密钥管理页面

登录控制台后按如下顺序操作：

1. 点击页面右上角用户中心入口；
2. 查看账户余额，余额不足时点击充值入口完成充值；
3. 在左侧菜单栏找到 API Key 管理板块进入； 若账户已有充足余额，可直接跳转至密钥管理页面。

步骤 4：创建全新 API 密钥

进入 API Key 管理页面后，点击页面右上角新建 API Key 按钮。

步骤 5：自定义密钥标识完成创建

在弹出的创建窗口内填写对应信息：

1. 自定义密钥名称，可填写测试、OpenClaw、本机调试等便于区分的标识；
2. 项目分类保持默认 default 无需改动；
3. 点击确定按钮生成密钥。

步骤 6：复制密钥并妥善留存备份

Moonshot 平台生成的 API 密钥仅会完整展示一遍，密钥生成弹窗出现后立刻点击复制按钮保存内容。 建议将密钥存储在便于查找的文档内，切勿随意转发给其他人员。

步骤 7：OpenClaw 客户端录入密钥并完成连通测试

切换至本地 OpenClaw 2.7.9 客户端执行配置：

1. 点击软件右上角设置按钮；
2. 在左侧菜单栏选择模型配置分类；
3. 在模型列表找到 Moonshot / Kimi 对应配置栏，粘贴此前复制的 API 密钥；
4. 点击测试按钮校验连通状态；
5. 确认测试通过后点击右上角保存全部配置； 页面弹出连接成功、读取到可用模型的提示，代表基础配置生效。

补充说明： OpenClaw 中将 Kimi 对应的服务商标注为 Moonshot / Kimi，配套默认接口地址为https://api.moonshot.cn/v1/models，常规场景仅填写密钥即可正常使用，无需手动修改接口地址。

步骤 8：聊天界面筛选选用 Kimi 系列模型

打开 OpenClaw 左侧聊天页面，在模型下拉选择框输入 kimi 进行检索，从列表挑选需要使用的模型，常用型号如下：

• kimi-k2.5
• kimi-k2.6 选中时留意模型右侧服务商标签显示为 moonshot。

步骤 9：发送测试消息验证模型调用效果

选定目标模型后输入测试文本，例如：你好，你是什么模型。 客户端正常输出回复内容，且页面顶部标注当前使用模型为 kimi-k2.6・moonshot 等对应型号，即代表整套接入流程全部完成。

接入完成自检核对清单

全部操作结束后可对照清单逐项校验，规避配置疏漏：

1. 可正常访问 Moonshot 开放平台官网；
2. Moonshot 平台账号登录控制台无异常；
3. 账户余额充足，余额不足时已完成充值；
4. 成功进入平台 API Key 管理页面；
5. 完成全新 API 密钥的创建操作；
6. 完整复制并妥善保存生成的密钥文本；
7. OpenClaw 2.7.9 客户端 Moonshot / Kimi 板块密钥填写无误；
8. 点击测试按钮，页面提示连接成功；
9. 执行保存全部配置操作；
10. 聊天模型列表选中带有 moonshot 标识的 Kimi 系列模型；
11. 发送测试消息，客户端能够正常返回模型回复内容。

常见问题与处理方案

1. 客户端内标注为 Moonshot / Kimi 的原因

Kimi 所属开放平台服务商为 Moonshot AI，因此 OpenClaw 模型列表统一标注 Moonshot / Kimi，直接在此分类填入平台生成的 API 密钥即可正常调用模型。

2. 点击测试按钮后提示连接失败排查顺序

按照以下顺序逐项核对定位问题：

1. API 密钥完整复制，文本前后不存在多余空格、换行符；
2. 密钥粘贴至 Moonshot / Kimi 对应输入框，未选错模型服务商；
3. 当前设备网络可正常访问 Moonshot 平台接口；
4. Moonshot 账户余额充足，不存在欠费限制调用的情况；
5. 修改密钥参数后，已点击保存全部配置。

3. 密钥生成后需要立刻复制保存的原因

平台不会重复展示完整密钥内容，若创建完成未及时备份，后续无法调取完整密钥文本，只能删除原有密钥重新生成。

4. 聊天页面检索不到 Kimi 模型解决办法

依次执行以下操作排查：

1. 确认 Moonshot / Kimi 板块连通测试提示成功；
2. 核对参数修改后执行保存全部配置；
3. 关闭并重新打开聊天模型选择列表，再次检索 kimi；
4. 若依旧无对应模型，重启 OpenClaw 2.7.9 客户端后重新查看。

参考访问地址

Moonshot 开放平台官网：https://platform.moonshot.cn/