Openclaw安装-window

Openclaw安装-window

一、管理员权限运行Powershell

任何涉及全局安装的操作，第一步往往都是打开具有管理员权限的命令行窗口。在Windows系统下，最顺手的就是 Powershell了。记得，一定要右键点击，然后选择“以管理员身份运行”。

二、安装GIT

这是很多软件生态依赖的基础工具，必须得有。直接访问官方下载页面：

https://git-scm.com/install/windows

进去之后，下载最新版本的安装程序就行。一路“Next”安装完毕，后续很多依赖管理才会顺畅。

三、Window下安装node

3.1. 手动下载安装（推荐）

对于大多数用户来说，手动下载安装包是最稳妥、最直观的方式。可以从国内的镜像源下载，速度会快很多：

https://registry.npmmirror.com/-/binary/node/latest-v25.x/node-v25.0.0-x64.msi

下载完成后，直接双击运行这个 .msi 文件，跟着安装向导的提示一步步操作即可，基本没什么坑。

安装完，别忘了验证一下。打开刚才的 Powershell，输入以下命令：

# 验证版本
node -v
# 输出 v25.0.0 即为成功
npm -v

能正常输出版本号，就说明Node.js环境已经准备就绪了。

3.2、国内源配置（关键！）

到了这一步，有个操作能极大提升后续体验，堪称“关键一步”——配置国内镜像源。如果不配置，安装依赖时那个下载速度，可能会让你怀疑人生。

打开Powershell，依次执行下面的命令：

# 配置 npm 国内源（淘宝镜像）
npm config set registry https://registry.npmmirror.com
# 验证源是否生效
npm config get registry
# 全局安装 pnpm（一个更快的包管理器）
npm install -g pnpm
# 若后续用 pnpm，同步配置（已装 pnpm 时）
pnpm config set registry https://registry.npmmirror.com

把源切换到国内镜像，接下来的安装过程就会如丝般顺滑。

四、NPM安装

4.1 安装OpenClaw

基础环境搭建好，主角就可以登场了。回到你的管理员Powershell，运行这两条简单的命令：

# Install OpenClaw
npm i -g openclaw
# Meet your lobster
openclaw onboard

第一条命令负责全局安装OpenClaw本体，第二条则是一个有趣的初始化命令，带你开始使用。

4.2 npm报错处理

当然，安装过程并非总是一帆风顺。如果在这里执行 npm i -g openclaw 时报了错，大概率是因为系统里缺少GIT。

没错，即使你之前已经安装了Git，npm在某些情况下可能依然识别不到。这时候，请果断返回上面的第二步，确保Git已经正确安装并添加到了系统环境变量中。通常重新安装一次就能解决问题。

五、后台运行

安装完毕，最后一步就是让它持续在后台提供服务。首先进行登录配置：

openclaw channels login
openclaw gateway --port 18789

如果你想让它安静地在后台运行，并且把日志输出到文件里，方便日后排查问题，可以使用下面这个命令：

& openclaw gateway > openclaw.log 2>&1

这样，网关服务就会在指定端口启动，并且默默地在后台工作了。至此，整个Windows下的OpenClaw安装和基础启动流程就全部完成了。