乐于分享
好东西不私藏

千万别在主力机试!OpenClaw小白安装教程,我替你踩过了18个坑

千万别在主力机试!OpenClaw小白安装教程,我替你踩过了18个坑

最近技术圈的热度担当,非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吧,那又是另一篇教程了。