在 Windows 10 上安装 OpenClaw,推荐采用手动安装方式,以避免自动化脚本因网络、权限或环境问题导致失败。
一、安装前准备
- 系统要求:Windows 10 64位(推荐 22H2 或更高版本)、至少 8GB 内存、稳定网络。
- 关键依赖:Node.js(≥ v22.22)、Git、管理员权限 PowerShell。
二、详细安装步骤
-
安装 Node.js(必须 ≥ v22.22)
-
参考上一篇文章地址,使用nvm安装nodeJs,便于管理。传送门:NodeJS:使用nvm管理node版本
-
如安装版本:24.13.1 (nvm install 24.13.1)
-
验证安装:
node -v npm -v输出应分别为
v22.x.x或更高、10.x.x左右。
-
-
安装 Git
-
下载地址:Git for Windows
-
安装时注意:
-
在 “Choosing the default editor” 步骤保持默认。
-
在 “Adjusting your PATH environment” 步骤选择:
Git from the command line and also from 3rd-party software
-
-
验证安装:
git --version
-
-
配置 PowerShell 执行策略(关键!)
-
以管理员身份打开 PowerShell(后续全程使用powershell),执行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入
Y确认。
-
-
安装 OpenClaw
-
推荐使用国内镜像加速(避免 GitHub 访问慢):
npm config set registry https://registry.npmmirror.com npm install -g openclaw@latest -
验证安装:
openclaw --version
-
-
初始化配置
-
运行引导向导:
openclaw onboard --install-daemon -
按提示操作:
I understand this is powerful...→ 选 yes- Onboarding mode → 选 QuickStart
- 大模型选择 → 国内用户可选 Qwen(通义千问) 或 Minimax(首次有免费额度)
- 通道(Channels)→ 首次可选 Skip for now
- Skill/Hooks → 选 Skip for now
- 启动方式 → 选 Open the Web UI
-
-
访问 Web 控制台
-
安装成功后,浏览器会自动打开:
http://127.0.0.1:18789 -
若未自动打开,可手动运行:
openclaw dashboard
-
三、验证是否安装成功
在 PowerShell 中执行以下命令,若返回对应结果即成功:
openclaw --version
openclaw gateway health
输出中包含 Gateway Health OK 表示服务正常运行。
在使用过程中请保持PowerShell处于打开状态,且不要关闭cmd页面。若不小心关闭,或关机后再次使用,可在powershell中执行以下指令以启动OpenClaw:
openclaw dashboard
openclaw gateway start
四、后续建议
-
接入飞书/钉钉:可在 Web UI 中输入“请帮我配置飞书机器人”,OpenClaw 会引导完成。
-
隐私提示:OpenClaw 需要较高系统权限,建议在无敏感数据的设备上使用 。
-
卸载命令(如需):
openclaw uninstall --all --yes --non-interactive npm uninstall -g openclaw
以上方法优先采用手动、可验证、低风险的路径,适合 Win10 原生环境部署。亲测有效,安装完再安装其他skill。