OpenClaw 连接 Kimi 图文实操教程前置环境准备本地已部署完成 OpenClaw v2.7.9 Windows 客户端程序可正常启动运行OpenClaw 右上角 Gateway 服务保持在线状态设备网络访问正常可正常打开 Moonshot 开放平台地址https://platform.moonshot.cn/准备可正常登录的 Moonshot 账号建议提前为账户充值便于 API 密钥创建完成后直接开展连通测试。完整图文操作步骤步骤 1访问 Moonshot 开放平台并完成登录打开浏览器访问 Moonshot 开放平台官网https://platform.moonshot.cn/ 进入网站首页后点击页面右上角登录按钮进入账号登录页面。步骤 2勾选服务协议完成账号登录跳转登录界面后按以下操作勾选页面底部用户服务协议相关选项可选登录方式包含微信扫码、手机号快捷登录、账号密码登录任选其一完成登录 成功登录跳转至平台控制台即为操作完成。步骤 3进入用户中心充值并打开 API 密钥管理页面登录控制台后按照页面指引操作点击页面右上角用户中心入口若账户可用额度不足可先进入充值界面补充余额找到左侧菜单栏内 API Key 管理板块进入 账户已有充足余额可直接跳过充值步骤进入密钥管理页面。步骤 4发起新建 API Key 操作进入 API Key 管理页面后点击页面右上角新建 API Key 按钮唤起创建弹窗。步骤 5填写标识名称确认生成密钥在弹出的创建窗口内填写信息自定义密钥名称例如设备名称、项目名称、OpenClaw 配套密钥等项目分类保持默认 default 无需修改点击确定按钮完成密钥创建系统将生成专属访问密钥。步骤 6复制密钥并妥善留存备份Moonshot 平台生成的 API 密钥仅会完整展示一次操作完成后无法再次查看完整密钥内容。 点击复制按钮完整复制密钥文本存储至备忘录、文档等便于查找的位置切勿随意转发给其他人员避免账户权限泄露。步骤 7回到 OpenClaw v2.7.9 配置密钥并连通测试切换至 OpenClaw 客户端执行配置操作点击软件右上角设置按钮在左侧菜单栏选择模型配置分类在列表中找到 Moonshot / Kimi 配置项将之前复制的完整 API 密钥粘贴至输入框点击测试按钮校验连通状态确认测试通过后点击右上角保存全部配置。 页面弹出 “连接成功获取到可用模型” 提示代表参数配置生效。补充说明 OpenClaw 内 Kimi 模型对应的服务商标识为 Moonshot / Kimi默认接口地址固定为https://api.moonshot.cn/v1/models仅填写密钥即可完成基础配置无需手动修改接口地址。步骤 8聊天界面切换选用 Kimi 系列模型打开 OpenClaw 左侧聊天功能页面在模型筛选框输入 kimi 进行检索在下拉列表挑选对应型号常见可选型号包含 kimi-k2.5、kimi-k2.6确认模型右侧标注服务商为 moonshot 再选择。步骤 9发送测试消息校验模型连通状态选定目标模型后在输入框发送测试语句示例你好你是什么模型 客户端正常输出回复内容且顶部状态栏标注当前模型为对应 Kimi 型号 moonshot 服务商即代表模型接入全部完成。接入完成自检核对清单浏览器可正常访问 Moonshot 开放平台官网https://platform.moonshot.cn/成功登录 Moonshot 平台控制台账户拥有可使用额度额度不足已完成充值顺利进入 API Key 管理功能页面完成全新 API 密钥创建操作完整复制并备份密钥文本在 OpenClaw v2.7.9 的 Moonshot / Kimi 栏目填入正确密钥点击测试按钮页面提示连接正常执行保存全部配置操作聊天页面成功选中带有 moonshot 标识的 Kimi 模型发送测试对话程序正常生成回复内容。高频问题排查方案1. OpenClaw 内配置项名称标注 Moonshot / Kimi 是什么原因Kimi 大模型所属服务商为 Moonshot AI因此软件内统一标注 Moonshot / Kimi直接填入对应平台创建的 API 密钥即可正常使用。2. 点击测试按钮提示连接失败如何处理依次核对以下内容 ① API 密钥完整复制文本前后无多余空格、换行字符 ② 密钥粘贴至 Moonshot / Kimi 对应配置栏未填错其他模型栏目 ③ 当前设备网络状态稳定无断网、网络拦截情况 ④ Moonshot 账户内拥有可用额度不存在余额耗尽 ⑤ 完成密钥粘贴测试后点击保存全部配置按钮留存参数。3. 密钥创建后需要立刻复制保存的原因平台仅在创建弹窗完整展示密钥内容关闭弹窗后无法查看完整密钥文本。若未提前备份只能删除原有密钥重新创建全新 API Key 使用。4. 聊天页面检索不到 Kimi 系列模型如何解决按照顺序逐项排查确认 Moonshot / Kimi 配置测试提示连接成功确认已点击保存全部配置参数已写入软件关闭聊天页面重新打开模型下拉列表再次检索 kimi上述操作无效时完全关闭 OpenClaw v2.7.9 客户端后重启重试。配套参考链接Moonshot 开放平台官网https://platform.moonshot.cn/openclaw Windows 版本 https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80Copenclaw 苹果系统版本https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C
