openlaw安装教程

大家好，我是AI技术开发团队，从一开始的区块链技术开发到现在的AI技术开发，每天和各种工具打交道，从最初的基础办公软件，到现在的各类AI工具、效率神器，踩过的坑能装一箩筐，也攒下了不少实用干货。

技术合作微信：meta5201

最近后台被问爆了，全是求OpenClaw安装教程的，留言清一色“老周，OpenClaw怎么装？”“装了好几次都失败，快崩溃了”“新手小白，求一步一步教，别搞专业术语”。

我太懂这种感受了，新手面对一堆代码、命令行，很容易犯怵，要么找不到正确的安装包，要么卡在环境配置上，要么装完打不开，白白浪费时间。所以今天，我抛开所有复杂的专业表述，用最通俗的话、最详细的步骤，手把手教大家安装OpenClaw，不管你是电脑小白，还是稍微懂点电脑操作，跟着我走，保证一次安装成功，全程无坑！

先跟大家说句实在的，OpenClaw作为一款开源的智能体平台，确实好用，能在本地机器上运行，还能通过微信、飞书这些常用聊天软件干活，帮我们处理文件、安排日程，甚至对接公众号API，实现一键发布文章，不管是办公还是做自媒体，都能省不少事。但它的安装确实有一些小门槛，尤其是对新手来说，环境配置不到位，很容易失败，这也是很多人卡壳的核心原因。

今天这篇教程，我分了三大板块：安装前的准备工作（重中之重，决定安装成败）、不同系统的详细安装步骤（Windows、Mac、Linux都覆盖，按需查看）、安装后的验证与常见问题排查（解决大家装完用不了的痛点），全程干货，没有一句废话，建议大家先收藏，再一步步跟着操作，避免中途找不到步骤。

另外提醒一句：全程不要跳步骤！不要跳步骤！不要跳步骤！很多人安装失败，就是因为觉得某一步不重要，直接跳过，结果后面报错，又不知道问题出在哪，来回折腾，反而更费时间。还有，安装过程中，全程保持网络稳定，不要中途断网，也不要随意关闭安装窗口，耐心等待即可。

一、安装前的准备工作（必看！）

在安装OpenClaw之前，我们要先做好3件事，这3件事直接决定了后续安装是否顺利，新手一定要仔细看，不要偷懒。

1. 确认电脑系统版本，满足最低要求

OpenClaw对电脑系统有一定要求，不是所有系统都能装，大家先对照自己的电脑系统，确认是否符合要求：

Windows系统：必须是Win10及以上版本（Win7、Win8不支持，别白费功夫），建议64位系统，运行更流畅；

Mac系统：macOS10.15及以上版本，不管是Intel芯片还是Apple Silicon芯片，都支持；

Linux系统：主流发行版即可（比如Ubuntu、CentOS），我这里重点讲新手常用的Windows和Mac，Linux用户可以参考后面的简化步骤。

2. 安装并配置Node.js（核心依赖，缺一不可）

这是最关键的一步，也是很多新手卡壳的地方。OpenClaw的运行，必须依赖Node.js，而且版本有硬性要求：Node≥22.12.0，低于这个版本，安装会直接失败，甚至连安装包都下载不了。

很多人可能之前装过Node.js，这里一定要先检查版本，步骤很简单：

Windows用户：以管理员身份打开PowerShell（按住Win+X，选择“Windows PowerShell（管理员）”），输入命令“node -v”，按下回车，如果显示“v22.12.0”及以上版本，就可以直接跳过这一步；如果显示低于这个版本，或者提示“不是内部或外部命令”，就需要重新安装。

Mac用户：打开终端（ Launchpad→其他→终端），输入“node -v”，回车后查看版本，同样，低于22.12.0版本，需要重新安装。

Node.js安装步骤（新手友好版）：

① 卸载旧版本（如果之前装过低于22.12.0的版本）：

Windows用户：打开控制面板→程序和功能，找到“Node.js”，右键卸载，卸载完成后，重启电脑；

Mac用户：打开终端，输入命令“sudo npm uninstall -g node”，输入电脑密码（输入时不显示密码，正常输入即可），回车，等待卸载完成。

② 下载最新适配版本：

打开Node.js官方下载地址：https://nodejs.org/dist/v22.12.0/node-v22.12.0-x64.msi（Windows 64位），直接点击下载，下载速度可能有点慢，耐心等待，不要中途取消。

Mac用户：下载地址：https://nodejs.org/dist/v22.12.0/node-v22.12.0.pkg，同样直接下载安装。

③ 安装Node.js：

Windows用户：双击下载好的安装包，点击“下一步”，勾选“Add to PATH”（非常重要，勾选后才能在命令行中使用Node.js），然后一直点击“下一步”，直到安装完成，安装完成后，重启电脑，确保环境变量生效。

Mac用户：双击安装包，按照提示一步步操作，输入电脑密码，等待安装完成即可，无需手动配置环境变量。

④ 验证安装：

重启电脑后，Windows用户再次打开管理员身份的PowerShell，Mac用户打开终端，输入“node -v”和“npm -v”，如果分别显示“v22.12.0”和“10.8.3”左右的版本，就说明Node.js安装成功了。

3. 配置国内镜像源（提升下载速度，避免超时）

因为OpenClaw的安装包和依赖包都在国外服务器，直接下载速度很慢，很容易出现“下载超时”“安装失败”的问题，所以我们要先配置国内镜像源，相当于走“捷径”，下载速度会快很多。

操作步骤：

Windows用户（管理员PowerShell）、Mac用户（终端），输入以下命令，回车即可：

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

输入完成后，再输入“npm config get registry”，如果显示刚才输入的镜像地址，就说明配置成功了。

到这里，安装前的准备工作就全部完成了，接下来就是正式安装OpenClaw，不同系统的安装步骤略有不同，大家按需查看，不要混淆。

二、不同系统的OpenClaw详细安装步骤

我分Windows、Mac、Linux三个系统，分别讲解，重点讲Windows和Mac（新手最多），Linux用户可以参考简化步骤，操作起来也很简单。

（一）Windows系统安装步骤（新手重点看）

Windows用户安装，有两种方法，一种是一键安装（推荐新手，最简单，不用手动输入太多命令），一种是npm安装（适合有一定电脑基础的用户），我两种方法都讲，大家选一种即可，推荐新手用一键安装。

方法一：一键安装（推荐新手）

关闭电脑上的杀毒软件（很多杀毒软件会误判OpenClaw的安装文件为病毒，导致安装失败，安装完成后再打开即可）；
以管理员身份打开PowerShell（Win+X，选择“Windows PowerShell（管理员）”）；
输入一键安装命令，复制下面的命令，粘贴到PowerShell中，回车：

iwr -useb https://openclaw.ai/install.ps1 | iex

4. 等待安装，安装过程中，会自动下载安装包和依赖包，屏幕上会显示安装进度，不要关闭窗口，也不要操作电脑，耐心等待5-10分钟（具体时间看网络速度）；

5. 安装完成后，会提示“Installation successful”，此时，OpenClaw就安装完成了。

方法二：npm安装（有基础用户）

同样以管理员身份打开PowerShell；
输入安装命令，回车：

npm install -g openclaw@latest --force --unsafe-perm=true

3. 等待安装，过程中会下载依赖包，可能会出现一些警告信息，不用管，只要不出现“error”报错，就继续等待；

4. 直到屏幕上显示“added xxxx packages in xxxs”，就说明安装成功了。

补充：如果安装过程中提示“缺少pnpm”，输入命令“sudo npm install -g pnpm”，安装完成后，再重新执行OpenClaw的安装命令即可。

（二）Mac系统安装步骤

Mac系统安装比Windows更简单，同样有两种方法，一键安装和npm安装，新手推荐一键安装。

方法一：一键安装（推荐）

打开终端（Launchpad→其他→终端）；
输入一键安装命令，回车：

curl -fsSL https://openclaw.ai/install.sh | bash

3. 输入电脑密码（输入时不显示密码，正常输入即可），回车，开始安装；

4. 等待安装完成，过程中会自动下载依赖包，不要关闭终端，耐心等待5分钟左右，出现“安装成功”的提示，就完成了。

方法二：npm安装（有基础用户）

打开终端，输入命令，回车：
npm install -g openclaw@latest

2. 如果提示权限不足，就在命令前加“sudo”，即：

sudo npm install -g openclaw@latest

3. 输入电脑密码，回车，等待安装完成即可。

补充：Mac用户如果想安装原生菜单栏应用（Beta版），可以去GitHub Releases下载OpenClaw.app，拖拽到应用程序文件夹，首次启动时，前往系统设置→隐私与安全性，点击“仍要打开”，授予麦克风、摄像头等必要权限，即可使用。

（三）Linux系统安装步骤（简化版）

Linux用户大多有一定技术基础，这里简化讲解，步骤如下：

1. 打开终端，先安装curl指令（如果没有）：

sudo apt update

sudo apt install curl -y

2. 输入一键安装命令，回车：

curl -fsSL openclaw.ai/install.sh | bash -s -- --install-method git

3. 等待安装完成，过程中如果提示缺少依赖，按照提示安装即可，安装完成后，输入“openclaw --version”，验证是否安装成功。

三、安装后的验证与初始化配置

安装完成后，不要着急关闭终端，我们先验证一下是否安装成功，然后进行简单的初始化配置，这样后续使用起来更顺畅。

1. 验证安装是否成功

不管是哪个系统，打开终端（Windows是管理员PowerShell），输入以下命令，回车：

openclaw --version

如果显示版本号（比如“2026.2.26”），没有报错，就说明安装成功了；如果提示“不是内部或外部命令”，说明环境变量配置有问题，重启电脑后再试，还是不行，就重新安装Node.js，确保勾选“Add to PATH”。

另外，还可以输入“openclaw doctor”，进行系统诊断，如果显示“没有发现问题”，就说明一切正常，可以放心使用。

2. 初始化配置（新手可跳过，后续按需配置）

安装成功后，我们可以进行简单的初始化配置，比如设置语言、关联账号等，步骤如下：

① 输入初始化命令，回车：

openclaw onboard

② 按照提示一步步操作，首先选择“Yes”，进入配置向导；

③ 选择“QuickStart”（快速启动），新手推荐；

④ 后续步骤中，没有特殊需求的话，全部选择“Skip for now”（暂时跳过），模型选择“Keep current”，技能配置选择“No”；

⑤ 最后选择“Hatch in UI”，会自动打开浏览器，进入OpenClaw的Web控制台，配置完成。

3. 中文版设置（新手友好）

很多新手担心界面是英文，看不懂，其实OpenClaw从2026年3月起，已经支持官方原生中文了，设置方法很简单：

① 打开Web控制台，输入命令“openclaw dashboard”，浏览器会自动打开；

② 在控制台的设置页面，找到“语言”选项，选择“简体中文”；

③ 刷新页面，界面就变成中文了，非常方便。

如果觉得官方中文不够完整，可以卸载原版，安装社区汉化版，步骤：输入“npm uninstall -g openclaw”，卸载完成后，输入“npm install -g @qingchencloud/openclaw-zh@latest”，安装完成后，输入“openclaw --version”，版本号后面有“-zh”后缀，就说明汉化成功了。

四、常见问题排查（新手必看，避免踩坑）

我整理了大家安装过程中最常遇到的5个问题，以及对应的解决方法，大家如果安装失败，对照下面的问题，一一排查，基本都能解决。

1. 问题一：安装时提示“权限不足”“EPERM错误”

解决方法：Windows用户，必须以“管理员身份”打开PowerShell，不要用普通的命令提示符；Mac/Linux用户，在安装命令前加“sudo”，输入电脑密码即可。

2. 问题二：下载超时、依赖包下载失败

解决方法：先检查网络是否稳定，更换网络试试；如果还是不行，重新配置国内镜像源（前面讲过的命令），配置完成后，重新执行安装命令。

3. 问题三：安装完成后，输入“openclaw --version”提示“不是内部或外部命令”

解决方法：大概率是Node.js的环境变量没有配置好，Windows用户，重启电脑，重新安装Node.js，确保勾选“Add to PATH”；Mac用户，关闭终端，重新打开，再试一次。

4. 问题四：启动OpenClaw时，提示“缺少ZOD库”“无法加载模块”

解决方法：ZOD库是OpenClaw插件开发的必要依赖，输入命令“npm install -g zod”，安装完成后，重新启动OpenClaw即可。

5. 问题五：界面是英文，无法切换中文

解决方法：检查OpenClaw版本，确保是2026.3.1及以上版本，输入“openclaw --version”查看，低于这个版本，重新安装最新版；如果版本符合，清除浏览器缓存，再刷新控制台页面，即可切换中文。

另外，还有一个新手常见的误区：安装过程中，看到屏幕上出现一些警告信息，就以为安装失败，直接关闭窗口。其实，警告信息不用管，只要不出现“error”报错，就说明安装在正常进行，耐心等待即可。

五、卸载方法（不想用了，彻底删除）

如果后续不想用OpenClaw了，想要彻底删除，避免占用电脑内存，步骤如下：

Windows用户：

打开管理员PowerShell，输入两个命令，依次回车：

npm uninstall -g openclaw

Remove-Item -Path $HOME\.openclaw -Recurse -Force

Mac/Linux用户：

打开终端，输入两个命令，依次回车：

npm uninstall -g openclaw

rm -rf ~/.openclaw

执行完成后，OpenClaw就彻底卸载干净了。

最后说几句心里话

写这篇教程，花了我整整一下午，就是因为看到太多新手被OpenClaw的安装难住，明明是个好用的工具，却因为安装问题，只能放弃。

其实OpenClaw的安装，并没有大家想象的那么难，只要做好前期的准备工作，跟着步骤一步步操作，耐心等待，基本都能一次成功。新手不要害怕命令行，我已经把所有命令都整理好了，直接复制粘贴就行，不用自己手动输入，避免输错。

如果大家按照教程操作，还是安装失败，或者遇到了其他问题，不用着急，可以在后台给我留言，说明你的电脑系统、遇到的报错信息，我会一一回复，帮大家解决问题。

另外，后续我还会分享OpenClaw的使用教程，比如如何对接微信公众号、如何设置AI技能、如何用它提高办公效率，大家可以关注我，避免错过干货。

最后，麻烦大家点个赞、在看，转发给身边需要的朋友，让更多新手少踩坑，高效用上OpenClaw这个实用工具～你们的支持，就是我持续分享的动力！

开发声明

我们只承接区块链，AI合规应用开发；面向海外市场的项目将主动屏蔽中国大陆IP，并做出相关风险提示，请遵守当地政策法规。技术合作微信：meta5201