位置：AI门户网
> AI应用 > AI智能体 > OpenClaw安装到底难不难？
你是不是也听说了最近爆火的“小龙虾”OpenClaw？是不是看到网上有人说它能帮你自动处理文件、回消息、甚至操作电脑，心里痒痒的，结果一搜安装教程，满屏的命令行和报错信息，瞬间就感觉头大了？别急，这种感觉太正常了。很多人，包括一些有点基础的朋友，都在安装这一步被“劝退”了，甚至还有人花钱请人远程安装。今天这篇文章，就是专门为你——完全不懂技术的新手小白——准备的。咱们不用那些看不懂的黑话，就用大白话，一步一步地把OpenClaw请到你的电脑里。我会把最常见的坑都给你标出来，让你避开它们，顺利上车。
首先，咱们得搞清楚，安装失败，十有八九不是你的问题，而是环境没准备好。这就好比你要做菜，锅、灶、食材都没准备，光有菜谱肯定不行。所以，动手前，花几分钟做好下面这几项“体检”，能省去后面99%的麻烦。
第一步：准备好你的“厨房”——系统环境检查
打开你的电脑，咱们先看看“硬件”达标不。OpenClaw对系统有点要求，Windows 10或更高版本（64位）、macOS 12以上或者主流Linux系统都行。然后，是最最最关键的依赖：Node.js。你可以把它想象成运行OpenClaw的“发动机”。很多朋友失败，就是因为没装它，或者版本太旧。
怎么检查？很简单。在你的电脑上找到“命令提示符”（CMD）或者“PowerShell”（后面会常用到）。对于Windows用户，按Win键，直接搜索“PowerShell”就能找到。打开这个黑窗口，输入 `node -v` 然后按回车。如果屏幕上蹦出来一串像 `v22.14.0` 这样的数字，而且开头是v22或者v24，恭喜你，这一步过关了。如果显示“不是内部或外部命令”，那就说明没安装。
没安装怎么办？别慌，去Node.js官网（https://nodejs.org/zh-cn/download）下载那个标着“LTS”的版本安装就行，现在一般是v22.x。安装过程就是一路点“下一步”，跟装普通软件没区别。装完记得关掉刚才的PowerShell窗口，重新打开一个，再输入 `node -v` 确认一下。这个“重启”动作很重要，能让系统识别到新安装的东西。
另外，如果你是Windows用户，可能还需要一个“编译工具”。有时候安装会报一些看不懂的“gyp ERR!”错误，多半就是因为它。解决办法也不难，在PowerShell里（记得用管理员身份打开，后面会讲怎么操作）输入下面这个命令安装就行：
```
winget install --id Microsoft.VisualStudio.2022.BuildTools --force
```
输入后会提示你确认，按“Y”回车等着它自己完成就好。
第二步：选一条好走的路——安装方法选择
环境准备好了，现在可以正式安装OpenClaw了。方法有好几种，咱们选对新手最友好的。
方法A：一键安装脚本（最推荐新手）
这是官方提供的“懒人包”，特别适合Windows用户。你只需要做几个简单的动作：
1.用管理员身份打开PowerShell：这步是为了获得最高权限，避免因为权限不够导致安装失败。怎么操作？在搜索框找到“Windows PowerShell”，然后右键点击它，选择“以管理员身份运行”。弹出的窗口背景可能是蓝色，标题栏有“管理员”字样，这就对了。
2.设置执行策略：系统默认不让随便运行脚本，咱们得给它开个绿灯。在打开的管理员PowerShell里，粘贴下面这行命令回车：
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
然后会问你，输入字母“A”再回车（表示全部允许）。
3.运行安装命令：继续粘贴下面这行命令并回车：
```
iwr -useb https://openclaw.ai/install.ps1 | iex
```
或者，如果你觉得下载慢，可以用国内的镜像源试试：
```
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
```
接下来，泡杯茶，等着就行。脚本会自动下载所有需要的东西，包括Node.js（如果你没装的话）和OpenClaw本身。屏幕上会滚动很多信息，只要没出现红色的错误提示，就让它跑完。
方法B：npm命令安装（通用方法）
如果你的网络环境比较特殊，或者想更“手动”一点，可以用这个方法。同样，在管理员PowerShell里，输入：
```
npm install -g openclaw@latest
```
这个命令是通过Node.js的包管理器来安装。如果提示权限错误，可以在命令前加上 `sudo`（Mac/Linux）或者确保PowerShell是以管理员身份运行的。
第三步：第一次见面——初始配置向导
安装成功后，咱们来第一次启动和设置。在PowerShell里输入：
```
openclaw onboard
```
或者
```
openclaw onboard --install-daemon
```
这会启动一个配置向导，像玩游戏创建角色一样，问你几个问题。别紧张，大部分选默认的或者跟着下面建议选就行：
*Risk确认：问你是否了解风险，选 `yes` 继续。
*Onboarding mode：新手直接选 `QuickStart`，快速配置。
*Model/auth provider：这里问你要用哪个AI模型。你可以先选 `Skip for now` 跳过，等安装好后再去网页界面里配置。模型需要API Key，比如智谱GLM、阿里百炼等，这个需要你去对应平台申请。
*Configure skills：技能配置，可以先选 `Yes` 启用一些基础技能。
*是否开启Hooks：这个可能会卡住。注意，这里不是直接按回车，而是先按一下空格键，看到选项前面出现一个选中标记（比如`[?]`），然后再按回车确认。
向导走完，它通常会帮你启动服务，并自动打开一个网页，地址一般是 `http://localhost:18789`。如果没自动打开，你手动在浏览器输入这个地址也行。看到OpenClaw的网页界面，恭喜你，安装主体工程已经成功了！
第四步：对付那些“拦路虎”——常见问题自问自答
走到这里，你可能已经成功了。但如果中途遇到了问题，别担心，咱们来玩个自问自答，把常见的“老虎”都揪出来。
*问：命令输完了，提示“openclaw 不是内部或外部命令”，怎么办？
答：这是最常遇到的问题之一，俗称“命令找不到”。原因有几个：第一，Node.js没装或者没装对，请返回第一步检查 `node -v`。第二，环境变量没生效，关掉所有PowerShell或CMD窗口，重新以管理员身份打开一个再试，这招能解决大部分问题。第三，安装可能真的失败了，可以尝试用 `npm install -g openclaw@latest` 再装一次。
*问：安装脚本卡住不动了，或者下载特别慢，怎么办？
答：多半是网络问题。可以尝试清理缓存并换用国内的npm镜像源加速。在PowerShell里依次执行：
```
npm cache clean --force
npm config set registry https://registry.npmmirror.com
```
然后重新运行安装命令。
*问：打开 `localhost:18789` 网页显示无法连接，怎么办？
答：首先，确保服务真的启动了。在PowerShell输入 `openclaw gateway --port 18789 --verbose` 手动启动网关服务。其次，可能是端口被别的程序占用了。可以换一个端口试试，比如 `openclaw gateway --port 19001`，然后浏览器访问 `localhost:19001`。另外，如果你用的是WSL2（Windows下的Linux子系统），有时需要检查防火墙设置，或者确保服务绑定到了 `0.0.0.0` 而不仅仅是本地回环。
*问：配置模型API Key时总是失败，提示401、403错误？
答：这通常不是安装问题，而是模型配置问题。第一，检查你的API Key有没有复制全，前后有没有多余空格。第二，去对应的模型平台（比如阿里百炼控制台）看看这个Key是不是有效的，余额是否充足。第三，在OpenClaw的Web界面检查配置的模型名称（model ID）和基础地址（base URL）是否正确，最好和模型平台官方文档核对一下。
*问：我是Mac用户，或者我想用更“原生”的Linux环境，有别的推荐吗？
答：对于Mac和Linux用户，以及追求更稳定环境的Windows高级用户，非常推荐使用WSL2（Windows Subsystem for Linux）来安装。你可以在Windows上安装一个Ubuntu子系统，然后在里面用Linux命令安装OpenClaw。很多奇怪的兼容性问题（比如插件安装报spawn错误）在WSL2里都不会出现。安装命令通常是：
```
curl -fsSL https://openclaw.ai/install.sh | bash
```
或者国内镜像：
```
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
```
好了，啰啰嗦嗦说了这么多，其实核心流程就是：检查环境 -> 选对方法（一键脚本）-> 管理员运行 -> 耐心等待 -> 按向导配置。OpenClaw本身是个很棒的工具，安装过程虽然有些小门槛，但一旦跨过去，你会发现一个新世界。网上那些收费安装的，赚的就是信息差的钱。希望这篇超详细的指南，能帮你省下这笔钱，更重要的是，帮你建立起自己搞定技术问题的信心。如果还是卡在哪一步，别灰心，记住出错信息，多搜搜，或者看看官方文档，你遇到的问题，全世界可能已经有成千上万的人遇到并解决了。动手试试吧，你的“AI助理”正在等着你呢。
版权说明：
