适合谁
这条路径适合:
- 日常主要在 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 -v 或 npm -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 重开一个新对话,再测最简单任务。
下一步建议
- 继续走最短路径:看 开始使用
- 如果你已经安装完成,下一步去看 技能精选
- 如果你担心权限问题,先看 安全检查清单
- 如果你准备把结果发回团队入口,去看 飞书接入
- 遇到 Windows 安装问题 → GitHub Issues
- 查看官方安装文档 → OpenClaw 文档