安装Node.js

• 环境推荐：Node 24（推荐）或 Node 22.16+.

下载安装

去官网下载安装程序，官网地址：https://nodejs.org/zh-cn/download，下载「LTS版」，一路next安装即可。

验证安装

cmd中运行 node --version npm --version

切换npm下载镜像源

• 查看镜像源：npm config get registry
• 修改镜像源（可切到国内镜像源，安装速度会快）：npm config set registry https://registry.npmmirror.com/
  

安装Git

⚠️ OpenClaw 安装的过程中，有一些依赖的安装需要用到 Git。

下载安装

去官网下载安装程序，官网地址：https://git-scm.com/install/windows，下载完后双击运行

验证安装

cmd中运行 git --version

安装OpenClaw

• 安装 OpenClaw ， PowerShel 和 cmd 都可以
• 如果是通过官方脚本安装是必须用 PowerShell，因为那个脚本是基于 PowerShel 的语法编写的
• PowerShell 默认的安全策略会阻止运行，这时候通过 set-ExecutionPolicy-scope currentUser -ExecutionPolicy Remotesigned 修改一下设置即可。如果用 cmd 就不会有这个问题。
• 不管用哪款终端工具，都建议用管理员身份运行，因为在后边安装 Gateway 后台服务的时候是需要管理员权限的。

⚠️ cmd中安装，用管理员身份运行cmd

# 安装/更新 OpenClaw
# npm install -g openclaw@latest
# 安装 OpenClaw（显示安装日志便于排错）
npm install -g openclaw@latest --verbose
# --verbose:显示详细日志
# -g:全局安装
# openclaw@latest:最新稳定版
# openclaw@beta:最新预览版
# openclaw@2026.3.13:指定具体版本

# 验证安装，查看版本号
openclaw --version

# npm查看全局是否安装openclaw
npm ls -g openclaw

# 查看openclaw包相关信息
npm show openclaw
# 查看openclaw的历史版本
npm show openclaw versions

# 查看通过 npm 全局安装的所有包及其版本
npm list -g --depth=0

openclaw默认安装目录：C:\Users<用户名>\AppData\Roaming\npm
openclaw内置技能目录：C:\Users<用户名\AppData\Roaming\npm\node_modules\openclaw\skills
openclaw内置插件目录：C:\Users<用户名\AppData\Roaming\npm\node_modules\openclaw\dist\extensions

首次配置

⚠️ cmd中安装，用管理员身份运行cmd

# 新手引导并安装服务
openclaw onboard --install-daemon
# 命令作用为
# 1）引导我们进行一些配置；
# 2）建立必要的工作目录和文件；（主要为用户目录下的.openclaw文件夹，以及文件夹下的openclaw.json配置文件和一些像workspace、agents等文件夹）
# 3）将 Gateway 安装成后台服务；

openclaw 给出的安全提示，选择yes（可以接受被攻击可破坏）

选择配置模式：QuickStart（此模式配置项较少，无需手动设置workspace目录、gateway端口等均使用默认配置）

选择模型厂商，配置 API Key（后期配置可选择 Skip for now），选择模型（后期自定义模型可选Enter model manually），后续可以我们在 Gateway 中进行配置

配置 Channel，可先 Skip for now

配置 Search provider，可先 Skip for now

安装 Skills，可选择 yes->clawhub（后期可通过 npm install -g clawhub 进行安装）

国外服务的API KEY，都选择no

配置 Hooks，可以先选择 Skip for now，之后引导程序会自动安装GateWay后台服务，自动在新窗口启动GateWay（ ⚠️ 新窗口不要关闭，关闭后gateway服务将停止运行，需使用 openclaw gateway start 重启gateway服务）。

💡 若安装失败，重置再来，先 Ctrl+C 退出引导，再执行 openclaw uninstall，若已经安装clawhub，可使用 npm rm -g clawhub 进行卸载，然后再执行openclaw onboard --install-daemon