OpenClaw 2026.3.2 完整版安装配置教程｜一步到位无报错

⚠️ 重要说明：由于OpenClaw更新速度较快，本文仅针对 2026.3.2 版本编写，其他版本可参考核心步骤，部分操作可能存在差异，建议对应版本对照使用～

---

一、前置准备：安装Node.js环境

Node是运行OpenClaw的核心基础，必须先安装对应稳定版本，避免后续报错。

1. 下载与安装

下载地址：https://nodejs.cn/download

版本选择：长期支持版 24.14.0（千万别下错成最新测试版，稳定性差）

安装步骤：下载完成后直接双击安装包，全程无脑点击Next即可，无需修改默认配置，新手直接默认路径安装最稳妥。

2. 验证安装是否成功

按下Win+X，选择打开PowerShell窗口，依次输入以下两条命令，能正常显示版本号，就代表安装成功：

node -v
npm -v

❌ 报错处理：如果输入npm -v提示权限报错，执行下面这条命令，输入y后按回车确认即可：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 切换国内镜像（提速必备，必做）

默认国外镜像下载超慢还容易失败，打开cmd命令行，输入命令切换国内淘宝镜像：

npm config set registry https://registry.npmmirror.com

验证是否设置成功，输入以下命令，返回对应镜像地址即为生效：

npm config get registry

---

二、安装Git工具

Git是OpenClaw安装的依赖工具，同样无脑安装即可，无需额外配置。

1. 下载与安装

下载地址：https://git-scm.com/install/windows

版本选择：Git for Windows/x64 Setup（64位系统默认选这个）

安装步骤：双击安装包，全程点击Next，保持默认配置就行，不用手动修改参数。

2. 验证安装

必须重新打开一个新的PowerShell窗口，输入以下命令，显示git version 2.53.0.windows.1类似版本号，即为安装成功：

git -v

---

三、核心安装：OpenClaw 2026.3.2

前面两个依赖装好后，开始安装OpenClaw，这一步容易遇权限报错，跟着教程一步步解决。

1. 执行安装命令

重新打开干净的PowerShell窗口，输入以下命令，耐心等待安装完成：

npm i -g openclaw

2. 高频报错解决（code 128权限错误）

如果出现下面这类git权限报错，别慌，直接执行修复命令：

npm error code 128
npm error An unknown git error occurred
npm error git@github.com: Permission denied (publickey).

✅ 解决方案：先输入这条命令，再重新打开PowerShell，执行上面的安装命令即可：

git config --global url."https://github.com/".insteadOf ssh://git@github.com/

3. 验证安装结果

安装完成无报错后，输入以下命令，返回版本号，代表OpenClaw彻底安装成功：

openclaw -v

---

四、详细配置：OpenClaw初始化+权限设置

4.1 一键初始化配置

终端输入以下命令，进入初始化界面，通过键盘上下键选择，回车键确认：

openclaw onboard

按顺序一步步选择：

• 第一步：选择 yes

• 第二步：选择 QuickStart

• 第三步：选择所需模型，本文以MiniMax为例，按需选择即可

• 第四步：频道选择，直接选 skip for now 暂时跳过

• 第五步：配置Skills，选择 No

• 第六步：Enable hooks，按空格键全勾选，再按回车确认

初始化完成后，会自动弹出一个cmd窗口，绝对不能关闭；Node弹出网络访问提示，务必选择允许。

4.2 权限升级配置（关键步骤）

默认权限不足，需要手动修改配置文件解锁全权限，操作需谨慎，高权限意味着可操控电脑核心功能！

1. 打开路径：C:\Users\你电脑的用户名.openclaw

2. 找到文件夹内的 openclaw.json 文件，用记事本/代码编辑器打开

3. 找到以下代码段，把messaging修改为full：

"tools": {
  "profile": "messaging"
},

修改后效果：

"tools": {
  "profile": "full"
},

1. 保存文件，重启OpenClaw让配置生效，输入命令：

openclaw gateway restart

1. 权限验证：向OpenClaw发送指令“请发给我当前电脑的硬件信息”，能正常返回结果，代表权限配置成功。

---

五、OpenClaw常用命令汇总

日常管理OpenClaw，直接在PowerShell输入对应命令即可，整理了高频实用命令：

openclaw gateway start    # 启动openclaw
openclaw gateway restart  # 重启openclaw
openclaw gateway stop     # 停止openclaw
openclaw status           # 查看openclaw运行状态
openclaw dashboard        # 获取openclaw访问地址，自动打开浏览器