说实话,Windows装OpenClaw确实比Mac麻烦一点。
Mac那边的人踩3个坑,Windows这边要踩5个。但别慌,这些坑我都帮你标好了,只要跟着我走,一个都不会踩。
我知道很多Windows用户看到技术教程就头疼,什么命令行、环境变量、防火墙,听着就复杂。但OpenClaw真的值得装,它能帮你自动处理很多重复工作,就像雇了个24小时不休息的助理。
所以,深呼吸,我们一步一步来。
先说清楚
如果你是Mac用户,请去看第3篇,这篇是Windows专属教程。
如果你是第一次接触OpenClaw,建议先看第2篇了解一下基本概念,知道OpenClaw是什么、能干什么。
准备好了吗?我们开始。
Windows专有坑预告
在开始安装之前,我先告诉你Windows比Mac多的3个坑:
这三个坑,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窗口里,输入:
应该显示版本号,比如v22.14.0。
再输入:
应该显示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里,输入安装命令:
按回车。
这个命令会从官网下载安装脚本并执行。
等待1-3分钟,期间会显示下载进度和安装信息。
安装完成后,验证一下:
应该显示OpenClaw的版本号,比如0.1.0。
Windows坑1:ExecutionPolicy报错
如果你看到这样的错误:
"无法加载文件...,因为在此系统上禁止运行脚本"
别慌,这是Windows的安全策略。
输入这个命令解决:
系统会问你是否要更改执行策略,输入"Y",回车。
然后再重新运行安装命令。
Windows坑2:命令找不到
如果提示"openclaw-cn不是内部命令",关掉PowerShell,重新以管理员身份打开,再试一次。
有时候PATH更新需要重启终端。
第四步:运行配置向导(500字)
安装完成后,运行配置向导:
这个命令会启动一个交互式配置向导。
你会看到几个配置项:
每个选项都有说明,按提示操作就行。
Windows特别提醒:防火墙弹窗!
配置过程中,Windows防火墙可能会弹窗,问你是否允许Node.js通过防火墙。
一定要点"允许访问"!
如果不小心点了"取消"或"拒绝",后面WebUI就打不开了。
如果错过了弹窗,后面我会教你怎么手动设置。
第五步:首次运行(400字)
配置完成后,启动OpenClaw:
这个命令会启动OpenClaw的Web界面服务。
等待几秒钟,看到"Server listening on http://127.0.0.1:18789"就说明启动成功了。
打开浏览器,访问:http://127.0.0.1:18789/
你应该能看到OpenClaw的Web界面。
如果看不到,可能是端口被占用,或者防火墙拦截了。
Windows坑3:防火墙拦截
如果浏览器显示"无法访问此网站",可能是防火墙的问题。
解决方法:
或者更简单的方法:在防火墙弹窗出现时,直接点"允许访问"。
常见问题汇总(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被占用
症状:启动时提示端口已被占用
解决:
找到占用端口的进程ID(PID),比如1234
或者换个端口启动: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完全指南的作者,我们下篇见。
夜雨聆风