TOPIC / SETUP

OpenClaw Windows 安装:先解决环境一致性,再进入使用阶段

Windows 环境下安装 OpenClaw 最重要的不是命令本身,而是先把环境一致性问题理顺,包括终端权限、Docker 配置和路径差异等常见坑点。按官方当前文档完成安装、启动和基础验证,每一步给出 Windows 特有的排障建议,让你不用反复踩别人已经踩过的坑。

适合谁

  • 主要在 Windows 环境里工作
  • 想先解决环境一致性再进入使用阶段
  • 需要一个可控的本地验证路径

适合谁

这条路径适合:

  • 日常主要在 Windows 环境工作
  • 想先在本地验证 OpenClaw 是否适合自己
  • 暂时不需要多用户长期在线

先处理环境一致性

Windows 路线常见的问题,不一定出在 OpenClaw 本身,而是:

  • 终端权限不一致
  • 路径分隔和工作目录混乱
  • Docker 或本地运行时没有先确认可用

所以第一次安装前,请先打开 PowerShell,并确认以下命令都能正常返回结果:

node -v
npm -v
docker --version
git --version

预期输出示例:

v22.12.0        ← Node.js 版本(≥22,推荐 24)
10.2.4          ← npm 版本
Docker version 25.0.3  ← 走 Docker 路线才需要
git version 2.43.0

如果 node -vnpm -v 没返回结果,先去装 Node.js,再继续往下做。

如果你在 PowerShell 中遇到权限问题(如脚本执行策略限制),可以尝试:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

另外,如果你更习惯 Linux 环境,Windows 上也可以通过 WSL 安装后再走 Linux 路线。

网络不稳时的可选处理

如果你在 Windows 上拉依赖明显很慢,可以先临时切到 npm 镜像:

npm config set registry https://registry.npmmirror.com/

同样,这一步不是必须项。能直接走默认源时,优先保持默认配置。

关键步骤

1. 先决定你走哪条安装路

不要一边照着脚本装,一边临时切到 Docker,最后很难判断配置来自哪里。先选一条官方当前推荐路径。

第一次装时,建议直接先看 官方中文安装教程,再决定是走本地脚本还是 Docker。

2. 统一工作目录

把 OpenClaw 放在一个干净、权限明确的目录里。第一次验证时,不要直接混进已有的大型工作区。

3. 安装后立刻检查启动链路

重点不是“安装完成”四个字,而是:

  • 进程能否稳定启动 → openclaw 命令返回版本号和帮助信息
  • 配置是否持久化 → openclaw config list 显示已保存的配置
  • 日志是否可见 → openclaw logs --follow 能实时输出日志
  • 一个最小输入是否有输出 → openclaw run --prompt "你好" 返回正常回复
  • openclaw doctor 是否能正常通过 → 所有检查项为绿色

4. 先接一个渠道,不要先做复杂自动化

当你确认基本服务可用后,先把消息通路接好,再去装技能和扩展能力。

不建议一开始做的事

  • 同时混用多种安装路径
  • 一次接多个渠道
  • 还没看权限边界就装大量第三方技能
  • 在没做回滚准备时反复替换关键配置

跑坏了先这样排查

如果你已经装上了,但行为不稳定,Windows 路线先做最小排查:

openclaw doctor
openclaw doctor --repair

如果只是当前对话链路乱了,也可以先在 OpenClaw 里用 /new 重开一个新对话,再测最简单任务。

下一步建议