OpenClaw Windows 安装指南：少走弯路版

说到 AI 助手，很多人第一反应是 ChatGPT、Claude。但如果你想自己在本地部署一个高度可定制的 AI 助手框架，OpenClaw 是个值得关注的选择。

最近在 Windows 上折腾了一把 OpenClaw，把几个坑都踩过了，今天整理一份少走弯路版安装指南。

前置准备：别省这一步

安装 OpenClaw 之前，你需要先准备好两样东西：

• Node.js（版本 >= 22）→ 官网下载^[1]
• Git Bash（Windows 上的 Git 终端）→ 官网下载^[2]

这两个不装好，后面的步骤会出问题。

第一步：找个地方安家

在 D 盘（或其他你喜欢的盘）创建一个工作区目录：

mkdir D:\software\openclaw\workspace

这个目录用来存放 OpenClaw 的配置文件和数据。建议早点定好，方便以后备份和迁移。

第二步：配置环境变量（关键！）

这一步很多人会跳过，但强烈建议认真做。不配置的话，OpenClaw 默认会把数据往 C 盘塞，以后找文件麻烦。

2.1 打开环境变量设置

按 Win + R，输入 sysdm.cpl，回车 → 高级选项卡 → 环境变量。

2.2 添加四个用户变量

在「用户变量」区域点击新建，依次添加：

值你可以自己定，不一定要跟我一样。但建议路径中不要有中文和空格。

2.3 验证是否生效

保存后，关闭并重新打开 Git Bash，运行：

echo$OPENCLAW_HOMEecho$OPENCLAW_WORKSPACE

看到你设置的路径就说明生效了。

如果没反应？ 重启电脑，基本就能解决。

第三步：装 OpenClaw

打开 Git Bash 或 PowerShell，执行：

npm install -g openclaw

等待安装完成。

第四步：运行配置向导

openclaw onboard --workspace D:\software\openclaw\workspace --install-daemon

这会启动一个交互式配置界面，每一步都有提示，跟着走就行。

主要配置项：

1. 确认安装 → 默认选 Yes，直接回车

2. 选择模式 → 选 QuickStart，快速上手

3. 选 AI 模型 → 国内用户推荐选智谱 GLM，速度快，API 也好申请。也可以选 Claude 或 OpenAI，看你自己情况。

4. 输入 API Key → 根据上一步选的模型，填入对应的 Key。智谱的 Key 在 bigmodel.cn^[3] 申请。

5. 选择聊天平台 → 国内推荐选飞书，配对后手机就能直接跟 AI 聊。

6. 配置飞书应用 → 这里需要去飞书开放平台创建一个自建应用，把 App ID 和 App Secret 填进来。

7-10. 搜索/Skills/其他 API/Hooks → 都可以先跳过，后续需要再加。

11. 网关配置 → 默认配置够用，按回车继续。

第五步：验证是否装成功

两个检查：

检查版本

openclaw --version

打开桌面网页

默认地址是 127.0.0.1:18789，浏览器打开后会让你填 token。

Token 在你工作区的 openclaw.json 里，搜索 token 就能找到：

"auth":{"mode":"token","token":"XXXXXXX"}

填入 token 登录，即可在网页里直接跟 AI 对话。

第六步：飞书配对（手机 + 电脑）

这是我觉得最实用的功能——用手机飞书直接跟 AI 对话。

操作步骤：

1. 打开手机飞书，搜索你创建的应用名称
2. 发任意一条文字
3. 应用会自动回复一个配对码
4. 在电脑的 cmd 或终端里输入配对码，完成绑定

之后在飞书里发消息，AI 就能收到了，体验很像在跟一个真正的助手聊天。

常见坑点

Q: 环境变量设了但不生效？ → 关闭所有终端窗口重新打开，还不行就重启电脑。

Q: Node.js 版本不够？ → 去 nodejs.org 下载 LTS 版本，22 以上就行。

Q: 飞书配对失败？ → 确认飞书应用创建时勾选了「机器人」能力，权限要配对好。

Q: 想删掉重装？ → 参考官方卸载指南，涉及 npm 卸载、服务移除、目录清理。

总结

安装流程说白了就几步：

1. 装 Node.js + Git Bash2. 建工作区目录3. 配置 4 个环境变量4. npm install -g openclaw5. openclaw onboard 跑配置向导6. 验证 + 飞书配对

最难的部分其实是环境变量配置，搞懂了这个后面就很顺。

如果你在安装过程中遇到其他问题，欢迎留言，看到会回。

相关工具：

• 智谱 API：bigmodel.cn^[4]
• 飞书开放平台：open.feishu.cn^[5]

引用链接