乐于分享
好东西不私藏

十万字OpenClaw详细部署指南第四篇:Windows装OpenClaw比Mac多3个坑,我帮你标好了

十万字OpenClaw详细部署指南第四篇:Windows装OpenClaw比Mac多3个坑,我帮你标好了

说实话,Windows装OpenClaw确实比Mac麻烦一点。

Mac那边的人踩3个坑,Windows这边要踩5个。但别慌,这些坑我都帮你标好了,只要跟着我走,一个都不会踩。

我知道很多Windows用户看到技术教程就头疼,什么命令行、环境变量、防火墙,听着就复杂。但OpenClaw真的值得装,它能帮你自动处理很多重复工作,就像雇了个24小时不休息的助理。

所以,深呼吸,我们一步一步来。

先说清楚

如果你是Mac用户,请去看第3篇,这篇是Windows专属教程。

如果你是第一次接触OpenClaw,建议先看第2篇了解一下基本概念,知道OpenClaw是什么、能干什么。

准备好了吗?我们开始。

Windows专有坑预告

在开始安装之前,我先告诉你Windows比Mac多的3个坑:

1ExecutionPolicy脚本执行策略 - Windows默认不让运行脚本,需要改个设置
2防火墙拦截 - WebUI打不开,不是安装失败,是防火墙拦住了
3PATH没有配置好 - 命令找不到,不是没装好,是系统不知道去哪找

这三个坑,90%的Windows用户都会遇到。但别担心,每个坑我都有解决方案。

第一步:安装Node.js(600字)

Windows不需要Homebrew,直接官网下载安装包就行。

打开浏览器,访问:https://nodejs.org/en/download

你会看到两个版本:LTS和Current。选左边的LTS版本,这是稳定版。

点击"Windows Installer (.msi)",下载64位的安装包。如果你的电脑是32位的(现在很少见了),就选32位。

下载完成后,双击运行安装包。

一路点"Next",但有一个关键步骤必须注意:

必须勾选"Add to PATH"这个选项!

这个选项在安装向导的某个页面,大概长这样:

  • [x] Add to PATH
  • [ ] 其他选项...

一定要勾上!不勾的话,后面会提示"node不是内部命令"。

继续点Next,直到安装完成。

安装完成后,验证一下是否成功:

按Win+R键,输入"powershell",回车。

在打开的PowerShell窗口里,输入:

Code
node -v

应该显示版本号,比如v22.14.0。

再输入:

Code
npm -v

应该显示npm的版本号,比如10.9.2。

如果提示"node不是内部命令"或"npm不是内部命令",说明PATH没配置好。

解决方案:卸载Node.js,重新安装,确认勾选了"Add to PATH"。

第二步:以管理员身份打开PowerShell(300字)

这一步很多人跳过,但非常重要。

不要用普通方式打开PowerShell,要用管理员身份打开。

方法1:在开始菜单搜索"PowerShell",右键点击搜索结果,选"以管理员身份运行"。

方法2:按Win+X键,选"Windows PowerShell(管理员)"。

打开后,确认窗口标题显示"管理员: Windows PowerShell"。

为什么要用管理员身份?

因为后面要改系统设置(ExecutionPolicy),普通权限改不了。

如果你不用管理员身份,会遇到权限错误,然后又要重来一遍。

第三步:安装OpenClaw(500字)

现在,在管理员PowerShell里,输入安装命令:

Code
iwr -useb https://clawd.org.cn/install.ps1 | iex

按回车。

这个命令会从官网下载安装脚本并执行。

等待1-3分钟,期间会显示下载进度和安装信息。

安装完成后,验证一下:

Code
openclaw-cn --version

应该显示OpenClaw的版本号,比如0.1.0。

Windows坑1:ExecutionPolicy报错

如果你看到这样的错误:

"无法加载文件...,因为在此系统上禁止运行脚本"

别慌,这是Windows的安全策略。

输入这个命令解决:

Code
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

系统会问你是否要更改执行策略,输入"Y",回车。

然后再重新运行安装命令。

Windows坑2:命令找不到

如果提示"openclaw-cn不是内部命令",关掉PowerShell,重新以管理员身份打开,再试一次。

有时候PATH更新需要重启终端。

第四步:运行配置向导(500字)

安装完成后,运行配置向导:

Code
openclaw-cn onboard --install-daemon

这个命令会启动一个交互式配置向导。

你会看到几个配置项:

1选择模型 - 默认用deepseek/deepseek-chat就行,免费好用
2API密钥 - 如果你有OpenAI、Claude的API密钥可以填,没有就跳过
3工作目录 - 默认在用户目录下的.openclaw文件夹
4安装守护进程 - 选Yes,让OpenClaw开机自启动

每个选项都有说明,按提示操作就行。

Windows特别提醒:防火墙弹窗!

配置过程中,Windows防火墙可能会弹窗,问你是否允许Node.js通过防火墙。

一定要点"允许访问"!

如果不小心点了"取消"或"拒绝",后面WebUI就打不开了。

如果错过了弹窗,后面我会教你怎么手动设置。

第五步:首次运行(400字)

配置完成后,启动OpenClaw:

Code
openclaw-cn gateway --port 18789

这个命令会启动OpenClaw的Web界面服务。

等待几秒钟,看到"Server listening on http://127.0.0.1:18789"就说明启动成功了。

打开浏览器,访问:http://127.0.0.1:18789/

你应该能看到OpenClaw的Web界面。

如果看不到,可能是端口被占用,或者防火墙拦截了。

Windows坑3:防火墙拦截

如果浏览器显示"无法访问此网站",可能是防火墙的问题。

解决方法:

1打开控制面板
2找到"Windows Defender 防火墙"
3点击"允许应用或功能通过Windows Defender防火墙"
4点击"更改设置"
5找到"Node.js"或"node",勾选"专用"和"公用"
6点击"确定"

或者更简单的方法:在防火墙弹窗出现时,直接点"允许访问"。

常见问题汇总(400字)

我整理了Windows用户最常遇到的5个问题:

1. ExecutionPolicy报错

症状:无法运行脚本

解决:Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned,输入Y

2. 命令找不到(PATH问题)

症状:node不是内部命令 / openclaw-cn不是内部命令

解决:卸载重装Node.js,确认勾选Add to PATH;关掉PowerShell重开

3. 端口18789被占用

症状:启动时提示端口已被占用

解决:

Code
netstat -ano | findstr 18789

找到占用端口的进程ID(PID),比如1234

Code
taskkill /PID 1234 /F

或者换个端口启动:openclaw-cn gateway --port 18790

4. 防火墙拦截WebUI

症状:浏览器打不开127.0.0.1:18789

解决:控制面板→防火墙→允许Node.js通过;或者重启时注意防火墙弹窗

5. 安装一半卡住

症状:安装过程卡住不动

解决:关掉PowerShell,重新以管理员身份打开,重新运行安装命令

结尾

如果你按照上面的步骤走下来,现在应该已经能看到OpenClaw的Web界面了。

说实话,Windows用户走到这一步,动手能力已经超过了九成来问我的读者。

Windows确实比Mac麻烦一点,但麻烦也就麻烦在这几个坑上。坑我都帮你标出来了,解决方案也给了,剩下的就是按步骤操作。

装好了OpenClaw,就像有了一个24小时在线的智能助理。它能帮你写代码、处理文档、整理信息、自动回复消息...

但装好只是第一步。

下一篇,我会教你如何配置OpenClaw,让它真正开始帮你干活。比如怎么连接飞书、怎么设置自动回复、怎么创建自己的工作流。

到时候你会发现,前面这些安装的麻烦,都是值得的。

我是OpenClaw完全指南的作者,我们下篇见。