夜雨聆风最近技术圈的热度担当，非OpenClaw莫属。这只“小龙虾”（网友爱称）凭借“本地部署+主动执行+无限扩展技能”的特性，让无数人想用自己的电脑养一只AI助理。
但如果你直接去扒官方文档，很容易在第一步就破防——Windows原生环境劝退率极高。作为一个在PowerShell里折腾了一周、重装了三次系统的踩坑专业户，今天把这套“Windows用户保命安装法”整理出来。全程避坑，只要跟着做，半小时内你也能拥有自己的Clawdbot。
第一步：听劝！别拿主力机冒险
在敲任何命令之前，先听一句狠话：不要在你的主力机（尤其是存着工作资料和公司密码的电脑）上直接跑！
OpenClaw虽然强大，但它本质上是一个拥有高权限的自动化Agent，能访问你的文件系统和网络。如果代码有Bug或者未来装了不安全的技能，隐私风险是真实存在的。最佳实践是弄一台干净的备用机，或者像我一样，租一个VPS（虚拟专用服务器），几块钱一周，玩坏了直接重置，不心疼。
第二步：Windows环境准备
如果你坚持要在Windows上跑，或者只有Windows电脑，请严格按照以下步骤，不要跳步。
1. 安装包管理工具
Windows对Node.js的管理比较混乱，我们必须借助nvm来管理版本。去GitHub下载 nvm-setup.exe，一路Next安装即可。
2. 安装Node.js
安装完成后，务必使用管理员模式打开PowerShell：
```powershell
# 安装Node.js 22版本（OpenClaw要求版本必须≥22）
nvm install 22
# 使用该版本
nvm use 22.22.0
```
看到 “Now using node...” 的提示才算成功。
第三步：一键安装OpenClaw
在管理员PowerShell中执行以下魔法命令：
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```
如果报错说无法执行，是因为策略限制，先输入下面这句再重试：
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
安装脚本跑完后，通常会弹出一个蓝色的配置向导（Onboarding）。如果没弹出来，或者不小心关掉了，手动执行：
```powershell
openclaw onboard --flow quickstart
```
第四步：初始化配置（关键！）
配置向导会让你选模型、填Key等。这里有几个坑要避开：
· 风险提示： 会出现 I understand this is powerful and inherently risky. Continue? 这是实话，选 Yes。
· 模型选择： 新手建议先选一个便宜的或者有免费额度的模型（比如国内的Kimi或阿里的通义千问），等跑通了再换Claude Opus这类“龙虾圣体”模型。
· API Key： 这是必须的，去你选的模型官网申请一个填进去。
· 渠道（Channel）配置： 这一步是最大坑点。官方文档明确说Windows原生环境配置飞书/钉钉容易出bug。建议在向导里先选“Skip for now”跳过，我们后面再手动救火。
一路回车默认配置，直到安装完成。
第五步：验证安装
配置完成后，OpenClaw会自动启动网关（Gateway）并打开浏览器，弹出Web控制台，地址通常是 http://127.0.0.1:18789/ 。
在对话框里随便发一句“你好”，如果有回复，恭喜你，龙虾已经养活了。
第六步：必学“救命”命令
玩OpenClaw，难免会把它玩死。记住下面这几句“救命咒语”，死不了：
· 查看实时日志（查错首选）：
```powershell
openclaw logs follow
```
出了任何问题，先看日志，它会告诉你哪里炸了。
· 自检修复：
```powershell
openclaw doctor --fix
```
很多配置错误，它自己就能修好。
· 重启网关：
```powershell
openclaw gateway restart
```
修改配置后，记得重启才能生效。
第七步：接入飞书（Windows救火版）
前面我们跳过了渠道配置，现在用命令手动接入飞书，让你能在聊天软件里使唤它。
1. 安装飞书插件：
在刚才的PowerShell里执行：
```powershell
openclaw plugins install @m1heng-clawd/feishu
```
2. 创建飞书应用：
去飞书开放平台创建一个企业自建应用，随便起个名字，添加机器人能力。然后拿到 App ID 和 App Secret 。
3. 配置到OpenClaw：
把下面命令中的AppID和AppSecret换成你自己的：
```powershell
openclaw config set channels.feishu.appId "你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
openclaw config set channels.feishu.enabled true
openclaw gateway restart
```
4. 飞书后台权限配置（这一步漏了肯定连不上）：
回到飞书开放平台的后台，需要配置三样东西：
· 权限管理： 搜索并添加 im:message 相关的权限（至少要加上接收和发送消息的权限）。
· 事件订阅： 订阅方式选择 “使用长连接接收事件”（不是Webhook）。
· 添加事件： 必须添加 im.message.receive_v1（接收消息事件），不然机器人就是个聋子。
· 发布版本： 所有配置改完后，一定要在「版本管理与发布」里创建一个版本并发布，配置才会生效。
配置成功后，在飞书里私聊你的机器人，它会返回一个配对码。把配对码复制下来，发给刚才Web控制台里的Clawdbot（或者用命令配对），绑定就完成了。
最后的话
至此，你的Windows电脑或VPS上就拥有一个7x24小时待命的AI助理了。
OpenClaw的强大不在于聊天，而在于它的“技能（Skills）”。装好之后，建议去ClawHub插件市场给它装上联网搜索、读写文件等技能，那时它才真正从“只会聊天的鹦鹉”进化为“能干活的长臂猿”。
如果你在安装过程中遇到了“明明照着做却报错”的情况，别怀疑自己，那是OpenClaw在Windows上的老毛病。重启大法好，实在不行就WSL2吧，那又是另一篇教程了。
