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窗口，依次输入以下两条命令，能正常显示版本号，就代表安装成功：

powershell 复制代码

node -v
npm -v

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

powershell 复制代码

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

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

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

cmd 复制代码

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

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

cmd 复制代码

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类似版本号，即为安装成功：

powershell 复制代码

git -v

三、核心安装：OpenClaw 2026.3.2

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

1. 执行安装命令

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

powershell 复制代码

npm i -g openclaw

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

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

powershell 复制代码

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

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

powershell 复制代码

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

3. 验证安装结果

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

powershell 复制代码

openclaw -v

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

4.1 一键初始化配置

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

powershell 复制代码

openclaw onboard

按顺序一步步选择：

第一步：选择 yes
第二步：选择 QuickStart
第三步：选择所需模型，本文以MiniMax为例，按需选择即可
第四步：频道选择，直接选 skip for now 暂时跳过
第五步：配置Skills，选择 No
第六步：Enable hooks，按空格键全勾选，再按回车确认

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

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

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

打开路径：C:\Users\你电脑的用户名.openclaw
找到文件夹内的 openclaw.json 文件，用记事本/代码编辑器打开
找到以下代码段，把messaging修改为full：

json 复制代码

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

修改后效果：

json 复制代码

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

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

powershell 复制代码

openclaw gateway restart

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

五、OpenClaw常用命令汇总

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

powershell 复制代码

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

温馨提示：本文适配Windows系统，全程对应OpenClaw 2026.3.2版本，操作过程中建议每一步都验证是否成功，避免前面步骤出错导致后续全部报错～

（注：文档部分内容可能由 AI 生成）