在 Windows 系统上安装 OpenClaw

步骤https://docs.openclaw.ai/start/getting-started

一、为什么「一行命令安装」经常翻车?

先说句大实话:

那条 iwr | iex 的 PowerShell 脚本,本质是一个"自动帮你把环境补齐"的安装器

它默认你:

系统策略允许执行远程脚本

PowerShell 版本正常

网络能顺利访问 GitHub / npm

本机已经有(或能自动安装)Node.js/ npm

但在Windows 真实世界里:

执行策略经常是 Restricted

Node / npm 根本没装

PATH 没配好

网络被墙 / 证书问题

于是就会出现一个非常典型的现象:

👉 脚本跑了,但 Clawdbot 用不了

所以,与其迷信"一行命令",不如老老实实按 OpenClaw 的真实依赖来。


二、我去翻了官方仓库,发现 OpenClaw 其实很「朴素」

笔者的做法是:

打开OpenClaw / Clawdbot 官方 GitHub 仓库

看 README

package.json

看 CLI 启动逻辑

结论非常清晰:

Clawdbot 本质就是一个 ="http://node.js/">Node.js CLI 工具

所以它的安装逻辑,其实只有三步。


三、Windows 正确安装 OpenClaw 的三步走(照着做就行)

省流版先给结论:
1️⃣ 装 Git 2️⃣ 装 Node.js(新版)3️⃣ npm install -g clawdbot(挂梯子会快很多)
每一步都能用命令验证,哪一步有问题,就停在哪一步解决。


四、省流 · 实操步骤清单(一步一步照着做)

如果你不想看解释,只想装好,直接按下面做。

Step 1:安装 Git

官网下载并安装:https://git-scm.com/

安装完成后,打开 PowerShell:

git --version

能看到版本号,继续下一步。


Step 2:安装 Node.js(不要装太老的)

官网:https://nodejs.org/

建议:LTS 或当前最新版

安装完成后,验证:

node -v

npm -v

两条命令都能跑,才算这一步完成。


Step 3:全局安装 Clawdbot

npm install -g clawdbot

安装完成后,验证:

clawdbot --version

能看到版本号,说明 OpenClaw 已经装成功。

可能出现问题:

这个错误是因为 Git 仓库使用了 SSH 协议,但系统没有配置 SSH 密钥

最简便有效的解决方法:

直接使用 npm 命令重试(GitHub 现在可能需要令牌)

由于 libsignal-node 仓库可能需要访问权限:

清除 npm 缓存

npm cache clean --force

或者指定使用 npm 官方源安装

npm install -g clawdbot --registry=https://registry.npmjs.org/

Step 4:启动

clawdbot onboard

按提示,选择第一步先yes,然后接着选择 qwen,然后在打开的浏览器中登陆注册千问即可,有github账号的可以直接登陆 ,然后直接先跳过,就可以对话了。

重启命令 clawdbot restart


五、为什么我不推荐直接跑那条一行命令

客观说一句,它不是不能用,只是:

更适合

对大多数普通 Windows 用户来说:

❌ 黑盒太多,失败也不好排查

而手动三步法的好处是:

每一步都可验证

出问题知道卡在哪

失败可 Google / 可重装


六、中间操作部分


七、启动

关机后再启动openclaw:

注意:Windows下powershell中要输 clawbot gateway --port 18789 --verbose(已经收藏过了)

相关推荐
互联网江湖1 分钟前
珞石机器人:向左科技股,向右零部件制造商?
大数据·人工智能
阿里云大数据AI技术29 分钟前
从数据湖到多模态湖仓-基于阿里云EMR Serverless StarRocks与DLF Paimon构建AI时代的统一分析检索架构
人工智能
前端的阶梯33 分钟前
浅谈Workflow和Agent的区别
人工智能
正在走向自律40 分钟前
Deepseek V4 Flash 高效应用实战指南
人工智能·deepseek·deepseek v4·ai赋能中心
Xzaveir1 小时前
别把所有“认证”都塞进 AuthService:实名、一键登录与号码身份的领域拆分
android·人工智能
BerrySen1781 小时前
KMP全栈开发:从Android到AI Agent的技术演进与实践
android·人工智能
战族狼魂2 小时前
高频面试题精选:分治与AI Agent架构
人工智能·算法·大模型·大语言模型
zSD55rt5a2 小时前
方差在扩散模型保护中的作用
人工智能·harmonyos
人生百态,人生如梦3 小时前
情感交互仿生人从技术到落地构想3——技术交流贴(2026.7)
人工智能·机器学习·人机交互·交互·具身智能