【教程】Windows 从 0 部署 OpenClaw(安装、配置、启动、控制台访问)

一句话:这篇写给第一次在 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)在登录后自动启动

用任务计划程序做兜底(稳定、好理解)

  1. 打开“任务计划程序” → 创建基本任务
  2. 触发器:登录时(At log on)
  3. 操作:启动程序
  4. 程序/脚本:openclaw
  5. 参数:gateway --port 18789
  6. 起始于(可选):你的工作目录(不填也行)

这样你每次开机登录后,Gateway 会自动起来。缺点是:它依赖“登录”。如果你要真正系统级的服务,再考虑 NSSM 或更复杂的方式。


第六部分:常见问题(我建议你按这个顺序排)

1)控制台能打开,但功能不工作

先看浏览器控制台报错,再看 OpenClaw 日志。如果你后面要把控制台反代到域名,记住一条:WebSocket 授权很容易翻车,推荐 trusted-proxy + 反代认证。

2)不回复/超时

大多数时候是上游模型超时或网络抖动。思路是先把 OpenClaw 超时拉长,再排 provider 稳定性。

3)端口冲突

如果 18789 被别的程序占了,换端口即可,例如 19001:

openclaw gateway --port 19001

结尾

到这里,Windows 上“从 0 → 能跑 → 能打开控制台”就完成了。后面如果你要接 Telegram、接模型代理、或者做域名反代安全访问,我建议分开做,每一步都先验证再继续,出问题更好定位。

发表评论