夜雨聆风Windows系统OpenClaw安装部署全攻略
本文将尝试用最直接的方式帮助您在WINDOWS系统下完成OPENCLAW的部署，每一步都有详细的说明，希望您能一起完成这个从0到1的旅程，一起加油出发吧。
⚠️ 前置提醒：全程不要随便关闭弹出的窗口，不要修改任何看不懂的设置，严格跟着步骤走，就能一次成功！
一、安装前准备（必做！避免后续报错）
在安装OpenClaw之前，我们需要先准备2个基础环境：
准备1：检查电脑系统与配置
✅ 系统要求：Windows10及以上版本（Windows11最佳，Windows7不支持，别白忙活）
✅ 配置要求：内存≥4GB（推荐8GB，避免运行卡顿），磁盘可用空间≥500MB（安装包+依赖占用）
✅ 其他：电脑能正常联网（安装过程需要下载文件），关闭电脑自带的杀毒软件（部分杀毒软件会误判安装文件，安装完成后再打开即可）
右键点击电脑“此电脑”→ 选择“属性”，就能查看自己的系统版本和内存，确认符合要求再继续。
准备2：安装Node.js（OpenClaw运行的基础）
OpenClaw需要依赖Node.js才能运行，必须安装指定版本，不然会报错！小白直接按以下步骤操作，全程“下一步”就行～
打开电脑自带的浏览器，搜索“Node.js 官方下载”，找到对应Windows系统的安装包（选择64位，后缀为.msi的文件，推荐Node.js 22 LTS版本，稳定性最高，适配OpenClaw所有功能）；
下载完成后，双击安装包，弹出安装界面，点击“Next”（下一步）；
勾选“我接受协议”，继续点击“Next”；
默认安装路径不用改（改了容易找不到，小白慎改），直接点击“Next”；
弹出“Node.js runtime”“npm package manager”等选项，全部默认勾选，点击“Next”；
最后点击“Install”（安装），等待3-5分钟，出现“Finish”就说明安装成功了。
【验证是否安装成功】：按下电脑键盘“Win+R”，输入“cmd”，按下回车，弹出黑色命令窗口；在窗口中输入“node -v”（注意中间有空格），按下回车，如果显示“v22.x.x”（x为任意数字），就说明安装成功了；再输入“npm -v”，按下回车，显示版本号即可（不用记版本号，有显示就没问题）。
命令窗口输入命令后，若出现红色报错，说明安装失败，重新卸载安装包，再按步骤重新安装一次即可。
二、OpenClaw安装步骤（全程复制粘贴，零代码）
准备工作做好后，开始安装OpenClaw，不用手动输入复杂命令，直接复制粘贴即可，全程3-5分钟搞定～
步骤1：以管理员身份打开PowerShell
按下电脑键盘“Win+X”，弹出菜单，选择“Windows PowerShell（管理员）”（注意：一定要选带“管理员”的，普通PowerShell会报错）；
弹出“用户账户控制”窗口，点击“是”（允许运行），此时会弹出蓝色的命令窗口（就是我们后续操作的窗口，不要关闭）。
如果找不到“Windows PowerShell（管理员）”，可以在开始菜单搜索“PowerShell”，右键点击搜索结果，选择“以管理员身份运行”。
步骤2：配置国内镜像（加速安装，避免卡顿失败）
由于网络原因，直接安装可能会很慢或失败，我们先配置国内镜像，直接复制以下命令，粘贴到蓝色命令窗口，按下回车即可（复制后右键粘贴，不用手动输入）：
npm config set registry https://registry.npmmirror.com
粘贴后按下回车，没有任何提示就说明配置成功了，继续下一步即可。
步骤3：一键安装OpenClaw
在蓝色命令窗口中，复制以下命令，粘贴后按下回车，开始安装OpenClaw（安装过程中会自动下载依赖，耐心等待，不要关闭窗口）：
npm install -g openclaw@latest
【安装过程说明】：安装时窗口会滚动很多文字，属于正常现象，不要中断；如果出现“success”字样，就说明安装进度正常，等待全部完成即可（大概3-5分钟，取决于网络速度）。
步骤4：验证OpenClaw是否安装成功
安装完成后，在命令窗口中输入以下命令，按下回车：
openclaw --version
✅ 成功标志：窗口显示OpenClaw的版本号（如v2026.3.8），没有红色报错，就说明安装成功了；
❌ 失败标志：如果出现“不是内部或外部命令”，说明安装失败，重新执行步骤3的安装命令即可。
三、配置Kimi2.5大模型（重点！指定模型，一步到位）
安装好OpenClaw后，我们需要配置指定的大模型——Kimi2.5（月之暗面），这是目前性价比很高、上下文很长的模型，按步骤操作，不用懂代码，全程复制粘贴命令即可。
步骤1：获取Kimi2.5的API Key（必做！模型调用的“钥匙”）
打开浏览器，搜索“Kimi 月之暗面 官方平台”，注册并登录自己的账号（个人用户免费，仅需手机号+身份证实名认证，很简单）；
登录后，找到平台中的“API密钥”或“Access Key”入口（通常在个人中心、开发者设置里，找不到就搜“API Key”）；
点击“创建API Key”，给密钥起个名字（随便起，如“OpenClaw专用”），创建完成后，点击“复制”，将API Key保存到记事本中（后续要用，不要泄露给别人）。
API Key是一串随机字符，复制时不要多复制空格，也不要泄露，泄露后可能会被他人盗用，导致自己无法使用。
步骤2：在OpenClaw中配置Kimi2.5模型
回到之前打开的蓝色PowerShell命令窗口，按以下顺序执行命令，每输完一条命令，按下回车，等待执行完成再输下一条（全部复制粘贴即可）：
首先停止OpenClaw服务（避免配置不生效），输入命令：
openclaw gateway stop配置Kimi2.5的基础参数，输入命令（将命令中的“你的Kimi API Key”替换成你刚才复制的API Key，注意保留引号）：
openclaw config set 'models.providers.kimi' --json '{"baseUrl":"https://api.kimi.com/coding/v1","apiKey":"你的Kimi API Key"}'设置默认模型为Kimi2.5，输入命令：
openclaw config set 'model.primary' 'kimi/k2p5'重启OpenClaw服务，使配置生效，输入命令：
openclaw gateway restart
【验证是否配置成功】：输入命令openclaw model list，按下回车，如果窗口中显示“kimi/k2p5”，就说明Kimi2.5模型配置成功了，可以正常调用了。
【避坑提醒】：配置时一定要注意API Key替换正确，不要少写、多写字符；如果出现“401”报错，大概率是API Key错误，重新复制API Key，再执行步骤2的命令即可。
四、配置飞书通道（重点！随时随地调用AI）
配置完Kimi2.5模型后，我们设置飞书通道——这样以后不用打开命令窗口，在飞书里就能直接调用OpenClaw+Kimi2.5，非常方便，小白全程零代码，按步骤操作即可。
准备：安装飞书客户端并登录
先在电脑上安装飞书客户端（搜索“飞书官方下载”，下载Windows版本，双击安装，全程下一步，安装完成后登录自己的飞书账号，个人账号即可，无需企业认证）。
步骤1：在飞书开放平台创建机器人（获取对接凭证）
打开浏览器，搜索“飞书开放平台”，用自己的飞书账号登录；
登录后，点击页面右上角“创建应用”，选择“个人应用”（个人用户选这个，操作最简单）；
填写应用基础信息：应用名称（随便起，如“OpenClaw AI助手”）、应用描述（随便写，如“对接Kimi2.5的AI助手”），点击“创建”；
创建完成后，页面会自动跳转到应用详情页，找到左侧菜单“凭证与基础信息”，点击进入；
找到“App ID”和“App Secret”，分别点击右侧“复制”，将这两个信息保存到记事本中（和之前的Kimi API Key放在一起，后续要用，不要泄露）。
App ID和App Secret相当于飞书机器人的“账号密码”，一定要妥善保存，泄露后可能导致机器人被他人操控。
步骤2：安装OpenClaw飞书插件（实现对接）
回到蓝色的PowerShell命令窗口，输入以下命令，按下回车，安装飞书插件（等待1-2分钟，提示“Plugin installed successfully”即安装成功）：
openclaw plugins install openclaw/feishu
步骤3：配置OpenClaw与飞书对接（关键步骤，别跳步）
首先确保OpenClaw服务已停止，若之前重启过，先输入命令停止：
openclaw gateway stop输入命令进入配置界面：
openclaw configure，按下回车；进入配置界面后，用键盘上下键选择，按回车确认，全程按以下顺序操作：
① 选择「Local」→ ② 选择「Channels」→ ③ 选择「Configure/link」→ ④ 选择「Feishu/Lark」→ ⑤ 选择「Enter App Secret」；
⑥ 粘贴记事本中保存的「App Secret」（右键粘贴），按下回车；
⑦ 粘贴记事本中保存的「App ID」（右键粘贴），按下回车；
⑧ 选择「WebSocket」（最稳定，无需公网IP，小白首选），按下回车；
⑨ 选择「Feishu (feishu.cn) - China」，直接按下回车确认；
⑩ 选择「Open」，按下回车；
⑪ 选择「Finished」，退出配置；
⑫ 出现「Configure DM access policies now?」，选择「NO」，按下回车。
配置完成后，重启OpenClaw网关，输入命令： openclaw gateway restart，等待窗口显示“Gateway started”，即重启成功。
步骤4：飞书应用发布与权限设置（机器人生效）
回到飞书开放平台的应用详情页，左侧菜单点击「事件与回调」，进入事件订阅页面；
订阅方式选择「使用长连接接收事件」，点击「保存」（如果出现“未检测到应用连接信息”报错，回到命令窗口，重新执行「openclaw gateway restart」命令，再保存）；
点击「添加事件」，在弹窗中找到“消息与群组”相关的所有选项，全部勾选，点击「确认」；
左侧菜单点击「权限管理」，找到“消息与群组”相关的所有权限，全部开启（勾选后点击保存）；
左侧菜单点击「版本管理与发布」，点击「创建版本」，填写版本信息（随便写，如“v1.0”），点击「确认发布」，等待应用状态变为「已上线」，即发布成功。
步骤5：测试飞书对接是否成功
打开电脑上的飞书客户端，在顶部搜索框输入你创建的应用名称（如“OpenClaw AI助手”），找到对应机器人，点击进入对话窗口；
在对话窗口发送测试消息（如“你好”），此时回到PowerShell命令窗口，会显示一个「配对码」（一串数字+字母）；
在命令窗口中输入命令（将“配对码”替换成窗口显示的实际代码）：
openclaw pairing approve feishu 配对码，按下回车；✅ 成功标志：飞书机器人在3-5秒内回复AI生成的内容（如“你好呀！我是OpenClaw AI助手，很高兴为你服务～”），就说明飞书通道配置成功了，以后在飞书里就能直接调用Kimi2.5模型了！
五、常见问题与解决方案
安装部署过程中，可能会遇到各种报错，不用慌！以下是最常见的10种问题，每一种都给出了具体的解决方案，对照报错找方法，轻松解决～
问题1：安装Node.js后，输入“node -v”显示“不是内部或外部命令”
✅ 解决方案：卸载已安装的Node.js，重新下载安装，安装时一定要勾选“Add to PATH”（默认勾选，不要取消）；安装完成后，关闭所有命令窗口，重新打开PowerShell（管理员），再输入命令验证。
问题2：安装OpenClaw时，出现“权限不足”报错
✅ 解决方案：确保打开的是“Windows PowerShell（管理员）”，不是普通的cmd或PowerShell；如果还是报错，在安装命令前加“sudo ”（注意空格），即sudo npm install -g openclaw@latest，按下回车后，输入电脑开机密码（输入时不显示字符，正常输入即可），再按回车。
问题3：配置Kimi2.5模型后，调用时出现“401”报错
✅ 解决方案：大概率是API Key错误或泄露，重新登录Kimi平台，创建新的API Key，替换步骤2中的API Key，重新执行配置命令；另外检查命令中的baseUrl是否为“https://api.kimi.com/coding/v1”，少写“/v1”也会报错。
问题4：配置飞书时，出现“App ID或App Secret错误”
✅ 解决方案：回到飞书开放平台，重新复制App ID和App Secret，确保没有多复制空格、没有复制错误；重新执行飞书配置步骤，粘贴时右键粘贴，不要手动输入。
问题5：飞书机器人发送消息后，没有回复，命令窗口显示“未检测到配对码”
✅ 解决方案：检查OpenClaw网关是否已重启（执行openclaw gateway restart）；检查飞书事件订阅是否已勾选“消息与群组”所有事件，权限是否全部开启；重新发布飞书应用，再发送测试消息。
问题6：安装OpenClaw时，出现“下载超时”“依赖安装失败”
✅ 解决方案：先配置国内镜像（步骤2的命令），再重新执行安装命令；如果还是超时，检查电脑网络，切换到稳定的WiFi，关闭代理软件，重新安装；也可以尝试用命令pnpm install -g openclaw@latest安装（需要先执行npm install -g pnpm安装pnpm）。
问题7：配置模型后，改了配置但不生效
✅ 解决方案：OpenClaw有session缓存，需要删除缓存文件才能生效；按下“Win+R”，输入“%USERPROFILE%/.openclaw/agents/main/sessions”，找到“sessions.json”文件，删除它；然后重新执行openclaw gateway restart，即可读取新配置。
问题8：PowerShell窗口中，粘贴命令后无法执行，显示“命令不存在”
✅ 解决方案：检查命令是否复制完整，没有遗漏字符；确保OpenClaw已安装成功（执行openclaw --version验证）；如果还是不行，关闭PowerShell窗口，重新以管理员身份打开，再粘贴命令。
问题9：飞书应用发布后，搜索不到机器人
✅ 解决方案：确保应用状态为“已上线”，如果是“审核中”，等待审核完成（个人应用通常立即审核通过）；飞书客户端退出登录，重新登录，再搜索应用名称；检查应用名称是否输入正确，不要输错字。
问题10：OpenClaw启动后，电脑卡顿、闪退
✅ 解决方案：检查电脑内存是否≥4GB，内存不足会导致卡顿闪退；关闭电脑中其他占用内存的软件（如游戏、视频软件）；重新启动OpenClaw网关（执行openclaw gateway restart）；如果还是不行，卸载OpenClaw，重新安装。
六、总结
全程核心步骤：准备Node.js环境 → 安装OpenClaw → 配置Kimi2.5模型（获取API Key+执行配置命令） → 配置飞书通道（创建机器人+对接配置+发布应用） → 测试生效。 后续会继续分享在使用过程中的各种有趣事情，一起努力由1到100！
