桌面智能体 OpenClaw 接入 Kimi 操作指南,API Key 生成与连通测试(含安装包)
OpenClaw 联动 Kimi 图文实操教程,完整配置 Moonshot 模型调用
适配客户端:OpenClaw Windows 2.7.9 适配系统:Windows10、Windows11 64 位|图形化可视化配置|配套故障排查方案
一、部署前基础条件核对
在执行模型对接操作前,需要确认本地环境、账号资源全部就绪,避免中途出现配置中断问题:
- 电脑已完成 OpenClaw Windows 2.7.9 完整部署,客户端能够正常打开并稳定运行;
- 软件顶部 Gateway 后台服务标识显示在线,不存在离线、运行报错等异常;
- 设备网络环境稳定,能够正常访问 Kimi 开放平台官方站点:https://platform.moonshot.cn/;
- 准备可正常登录使用的 Moonshot 账号,建议提前向账户存入余额,方便生成密钥后直接开展模型调用测试。
部署包资源地址:
Windows 版本:https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
苹果系统版本:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
配套一键整合部署包整体文件体积为 45.8MB。
二、分步完整配置操作流程
步骤 1:访问 Moonshot 开放平台并完成账号登录
打开电脑浏览器,输入 Kimi 开放平台官方访问地址https://platform.moonshot.cn/,页面右上角可以找到登录入口,点击跳转至账号登录界面,进入平台管理控制台。
步骤 2:勾选服务协议,任选登录渠道完成身份校验
进入登录页面后,勾选页面底部展示的服务协议与隐私相关条款。平台提供三类登录渠道,分别是微信扫码登录、手机号快捷登录、账号密码登录,使用者可以根据自身习惯任选其一完成登录验证,登录成功后自动跳转至个人后台控制台。
步骤 3:账户余额充值,进入 API 密钥管理功能页
登录控制台后,点击页面右上角头像展开个人中心菜单。 如果账户当前可用余额不足,可先执行充值操作补充余额;余额充足的情况下可以直接在左侧导航栏找到 API Key 管理页面并进入。
步骤 4:发起新建专属调用密钥
进入 API Key 管理页面,点击页面右上角新建 API Key 功能按钮,唤起密钥创建弹窗窗口。
步骤 5:自定义密钥备注名称并确认生成
在弹窗输入框填写便于区分的密钥备注名称,例如个人设备测试、OpenClaw 专用调用等,项目分类选项保持默认 default 无需调整。核对填写内容无误后点击确定按钮,系统会自动生成一组专属模型调用密钥。
步骤 6:复制完整密钥并妥善留存,做好保密管理
Moonshot 平台生成的完整 API Key 仅在创建弹窗内完整展示一次,页面刷新、关闭弹窗后将无法再次查看完整密钥字符。创建完成后第一时间点击复制按钮保存至本地文档,密钥不可随意转发分享给他人,防止账户产生非本人操作的调用消耗;如果密钥不慎丢失,只能删除原有密钥并重新创建一组全新密钥。
步骤 7:OpenClaw 客户端填入密钥,执行连通校验测试
打开本地安装完成的 OpenClaw 2.7.9 客户端,点击软件右上角设置功能按钮; 左侧功能分类栏切换至模型配置板块; 在模型服务商列表找到 Moonshot / Kimi 专属配置栏目,将上一步复制的完整 API Key 粘贴至输入框; 接口访问地址默认填写https://api.moonshot.cn/v1/models,无需手动修改参数; 密钥粘贴完成后点击测试按钮,页面弹出连接正常、读取到可用模型的提示即代表密钥校验通过,最后点击右上角保存全部配置,确保参数生效。
补充说明:客户端内标注 Moonshot / Kimi,是由于 Kimi 大模型隶属于 Moonshot AI 厂商,二者共用同一套配置通道,填入相同密钥即可完成对接。
步骤 8:对话界面筛选调用 Kimi 系列模型
返回软件左侧对话操作页面,在模型检索输入框输入 kimi 关键词筛选对应模型条目,列表会展示多款可用 Kimi 型号,日常使用频率较高的型号为 kimi-k2.5、kimi-k2.6,选择时留意模型后方附带的 moonshot 厂商标识。
步骤 9:发送测试对话内容,验证模型接入效果
选中目标 Kimi 系列模型后,在底部对话输入框发送一段测试文本,例如:简单介绍自身具备的能力。若客户端能够正常输出完整回答,对话顶部同步展示 kimi-k2.6・moonshot 标识,则代表 OpenClaw 与 Kimi 大模型的对接流程全部完成。
三、接入完成自检核对清单
可无阻碍访问 Moonshot 开放平台官网 顺利登录个人 Moonshot 管理控制台 账户内存在可用余额,满足模型调用扣费需求 成功进入 API Key 管理页面并创建全新密钥 完整复制密钥并安全存储,不存在泄露风险 OpenClaw 模型配置栏填入正确密钥,连通测试提示正常 全部参数修改完成后执行保存操作 对话模型下拉列表可检索到带有 moonshot 标签的 Kimi 系列模型 发送测试文本,模型能够稳定生成对应回复内容
四、高频配置故障解决方案
问题 1:密钥测试弹窗提示连接失败
按照以下顺序逐项排查问题根源:
- 核对复制粘贴的 API Key 完整字符,密钥前后、中间不能夹带多余空格、换行符号;
- 确认密钥粘贴至 Moonshot / Kimi 专属配置区域,未误填入其他模型服务商通道;
- 检查本地电脑网络环境,确认设备能够正常访问对应接口地址;
- 查看 Moonshot 账户可用余额,余额耗尽会直接拦截全部模型调用请求;
- 密钥连通测试通过后,必须点击保存全部配置,未保存会导致参数失效。
问题 2:对话模型列表检索不到任意 Kimi 相关模型
- 重新打开模型配置页面,确认 Moonshot / Kimi 连通测试状态显示连接成功;
- 再次点击保存全部配置,同步更新本地缓存的模型列表信息;
- 返回对话操作界面,重新展开模型下拉列表检索 kimi 关键词;
- 若以上操作均无效果,完全关闭 OpenClaw 2.7.9 客户端重启后再次检索。
问题 3:API Key 创建后仅单次展示,丢失无法查看完整密钥
平台出于账户安全防护机制设计,密钥创建弹窗仅单次展示完整密钥字符,页面刷新或关闭窗口后不再提供完整密钥查看入口。如果密钥遗失,只能在 API Key 管理页面删除旧密钥,重新创建一组全新密钥用于模型调用。
配套部署包下载地址汇总
Windows 版本:https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
苹果系统版本:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C 配套一键整合部署包整体文件体积为 45.8MB。
更多推荐




所有评论(0)