Windows系统安装Openclaw全流程
一. 下载必须资源(若已下载可跳过)
1.1 下载安装Git
第一步,我们需要安装代码版本管理工具 Git。直接访问下方的官方网站,下载适用于 Windows 的安装程序,然后按照提示一步步完成安装即可。
https://git-scm.com/install/windows
1.2 下载安装Node.js
接下来是 Node.js,它是运行 OpenClaw 所必需的 JavaScript 环境。同样,访问其官网下载安装包。建议选择 LTS(长期支持版),稳定性更有保障。
https://nodejs.org/zh-cn/download
1.3 下载OpenClaw
核心主角登场。我们需要从 GitHub 上获取 OpenClaw 的源代码。访问下面的项目地址,下载压缩包并解压。这里有个关键细节:解压后的文件夹路径必须是纯英文的,避免后续运行中出现因中文路径引发的莫名其妙的问题。
https://github.com/openclaw/openclaw
二. 安装OpenClaw
2.1 配置git代理
准备工作做完,现在进入正题。首先,打开你解压好的 OpenClaw 文件夹,在地址栏输入“cmd”并回车,这样就能直接在此目录下打开命令窗口。
在命令窗口中,依次执行下面两条命令:
git config --global --unset http.proxy
git config --global --unset https.proxy
这两条命令的目的是什么?主要是为了清除系统里可能残留的旧代理配置。很多时候网络连接失败,问题就出在这儿。清理干净后,我们才能顺畅地使用国内的镜像源来加速后续的依赖下载,事半功倍。
2.2 全局安装 pnpm 与项目依赖
现在开始安装核心工具链。请在同一个命令窗口中,依次执行以下命令。别担心,我们一步步来:
# 第一步:提升脚本执行权限(系统会询问,输入 y 确认即可)
Set-ExecutionPolicy -Scope Process Bypass
# 第二步:全局安装 pnpm(一个更快的包管理器)
npm install -g pnpm
# 第三步:为 pnpm 配置国内镜像源,下载速度会快很多
pnpm config set registry https://registry.npmmirror.com
# 第四步:进入项目目录,安装所有依赖包(这一步时间稍长,取决于网络)
pnpm install
# 第五步:运行开发模式构建
pnpm dev
# 最后一步:验证安装是否成功。如果输出版本号且没有报错,恭喜你,安装完成了。
node openclaw.mjs --version
三. 安装OpenClaw的skill工具(可选非必须)
基础功能安装完毕。如果你想拓展 OpenClaw 的能力,比如让它具备联网搜索的功能,可以安装额外的 skill 工具。这部分是可选的,但相当实用。
# 安装 skill 管理工具
npm i -g clawhub
# 安装一个实用的浏览器代理 skill(示例)
npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser
四. 启动OpenClaw
进入OpenClaw项目文件夹
确保你的命令窗口工作路径,是在第一步解压出来的那个 OpenClaw 项目文件夹里。
打开CMD窗口
如果已经打开,请忽略;如果关闭了,记得用老方法:在文件夹地址栏输入“cmd”回车。
执行初始化启动命令
是时候第一次召唤它了。执行下面的命令,系统会引导你完成初始配置。
node openclaw.mjs gateway onboard
只需跟着屏幕上的提示一步步操作,配置完成后,你的 OpenClaw 服务就会正式启动起来。
五. 关机或退出后再次启动OpenClaw
日常使用中,我们不可能每次都从头配置。那么,以后如何快速启动呢?流程更简单。
进入OpenClaw项目文件夹
老规矩,首先导航到你的 OpenClaw 项目目录。
打开CMD窗口
执行启动命令
这次只需要一条简单的运行命令:
node openclaw.mjs gateway run
执行它,服务会再次运行起来。没错,后续的启动,就这样一步搞定。


