一句话:这篇写给第一次在 Windows 上折腾 OpenClaw 的人。按“从 0 开始、照着做就能跑”的顺序:安装 Node → 安装 OpenClaw → 跑起来 → 打开 Control UI →(可选)做成开机自启。
你需要什么
- 一台 Windows 10/11(建议 64 位)
- 可以联网(能访问 npm)
- (可选)Telegram Bot:如果你希望用 Telegram 收发消息
注意注意注意
- 第一次建议先按“本机运行”走通流程,先别急着做公网暴露。
- 控制台默认是本地访问:
http://127.0.0.1:18789/。如果你要远程访问,建议走反代 + 认证(不要裸奔)。
第一部分:装 Node.js(OpenClaw 必需)
OpenClaw 需要 Node 22 或更新版本。下面给两种装法,任选其一。
方式 A:用 winget(推荐)
用 PowerShell(管理员或普通都可以)执行:
winget install OpenJS.NodeJS.LTS
node -v
npm -v
方式 B:官网下载安装包
- 打开 Node.js 官网,下载 LTS 安装包安装即可。
- 装完后在 PowerShell 验证:
node -v
npm -v
第二部分:安装 OpenClaw
打开 PowerShell,执行:
npm install -g openclaw@latest
openclaw --version
如果你遇到“执行策略/权限/无法运行脚本”等问题,先确认你的 PowerShell 权限,或者换用 Windows Terminal 再试一次。
第三部分:跑引导(最省心)
这一步会引导你生成配置,并尝试安装后台运行方式:
openclaw onboard --install-daemon
然后验证配置文件是否有效:
openclaw config validate
配置文件路径:一般在你的用户目录下:
%USERPROFILE%.openclawopenclaw.json
第四部分:启动 Gateway + 打开控制台
1)先用“前台启动”跑通(排障最方便)
openclaw gateway --port 18789
2)打开 Control UI
浏览器打开:
http://127.0.0.1:18789/
如果打不开,先检查端口是否被占用(或者被防火墙拦了)。
第五部分:(可选)做成开机自启 / 常驻运行
Windows 上常驻运行我建议两条路:
- 优先:用 OpenClaw 自己的安装方式(
openclaw onboard --install-daemon) - 兜底:用“任务计划程序”(Task Scheduler)在登录后自动启动
用任务计划程序做兜底(稳定、好理解)
- 打开“任务计划程序” → 创建基本任务
- 触发器:登录时(At log on)
- 操作:启动程序
- 程序/脚本:
openclaw - 参数:
gateway --port 18789 - 起始于(可选):你的工作目录(不填也行)
这样你每次开机登录后,Gateway 会自动起来。缺点是:它依赖“登录”。如果你要真正系统级的服务,再考虑 NSSM 或更复杂的方式。
第六部分:常见问题(我建议你按这个顺序排)
1)控制台能打开,但功能不工作
先看浏览器控制台报错,再看 OpenClaw 日志。如果你后面要把控制台反代到域名,记住一条:WebSocket 授权很容易翻车,推荐 trusted-proxy + 反代认证。
2)不回复/超时
大多数时候是上游模型超时或网络抖动。思路是先把 OpenClaw 超时拉长,再排 provider 稳定性。
3)端口冲突
如果 18789 被别的程序占了,换端口即可,例如 19001:
openclaw gateway --port 19001
结尾
到这里,Windows 上“从 0 → 能跑 → 能打开控制台”就完成了。后面如果你要接 Telegram、接模型代理、或者做域名反代安全访问,我建议分开做,每一步都先验证再继续,出问题更好定位。