位置：AI门户网
> AI应用 > AI智能体 > OpenClaw安装难吗？新手小白如何从零开始部署？
你是不是也刷到过那个叫“小龙虾”的AI工具？看着别人用它自动处理文件、回复消息，甚至帮你写代码，心里痒痒的，结果自己一搜安装教程，满屏的命令行和报错信息，瞬间就懵了——这第一步到底该怎么迈出去？别慌，这种感觉太正常了。今天这篇文章，就是为你这样的纯新手准备的。我们不谈高深概念，就一步步、手把手地带你走过安装OpenClaw的全过程，用最直白的话，把那些看似复杂的步骤拆解得明明白白。毕竟，再强大的工具，装不上也是白搭，对吧？
很多人一上来就复制粘贴安装命令，结果卡在第一步，99%的失败都源于基础环境没准备好。所以，咱们先别急，花两分钟检查一下，能避开后面99%的坑。
首先，你的电脑系统得是Windows 10或更高版本，或者是macOS 12以上，Linux的话主流发行版像Ubuntu 22.04也行。这个一般都没问题。
最关键的一步，是检查Node.js。OpenClaw完全跑在Node.js环境里，这是它唯一的硬依赖。怎么检查？很简单：
1. 在你的电脑上找到“命令提示符”（CMD）或者“PowerShell”（Windows用户），或者“终端”（Mac用户）。
2. 在里面输入 `node --version`，然后按回车。
3. 如果屏幕上显示了一个版本号，比如 `v22.14.0`，那就恭喜你，过关了。但注意，版本号必须大于等于22，低于这个版本是绝对跑不起来的。
如果啥也没显示，或者提示“不是内部或外部命令”，那就说明你还没安装Node.js。别担心，去它的官网（https://nodejs.org/zh-cn/download）下载那个标着“LTS”的版本安装就行，安装过程跟装普通软件没区别。装完记得重新打开一个命令提示符窗口，再输入 `node --version` 确认一下。
另外，最好保证你的C盘（或者你准备安装的磁盘）有至少500MB的可用空间，安装路径里别有中文和特殊符号。网络也要通畅，因为安装过程需要下载不少东西。
环境准备好了，咱们正式开始安装。这里给你推荐两种最主流、对新手最友好的方法，你可以挑一个你觉得顺手的。
方法一：一键安装脚本（最省心）
这是目前对小白最友好的方式，特别是Windows用户。它的思路是，用一个脚本自动帮你搞定所有事，包括检测环境、安装依赖、下载核心文件，你几乎不用动脑子。
具体操作：
1. 在Windows上，右键点击屏幕左下角的“开始”菜单，选择“Windows PowerShell（管理员）”或者“终端（管理员）”。这一步“以管理员身份运行”非常重要，能避免很多因权限不足导致的失败。
2. 在弹出的蓝色或黑色窗口里，复制粘贴下面这条命令，然后按回车：
```
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
```
这条命令用的是国内镜像源，下载速度会快很多，能有效解决网络卡顿的问题。
3. 接下来，你就看着屏幕上的提示走。脚本会自动干活，中间可能会问你一两个问题（比如是否继续），一般直接按回车或输入“Y”同意就行。
方法二：npm全局安装（更通用）
如果你的网络环境比较好，或者用的是Mac、Linux系统，这个方法也很直接。npm是Node.js自带的包管理工具，就像个软件商店。
具体操作：
1. 同样，打开管理员身份的PowerShell（Windows）或终端（Mac/Linux）。
2. 输入并执行下面这条命令：
```
npm install -g openclaw@latest
```
这个命令的意思是从npm的仓库里，下载并全局安装最新版的OpenClaw。
3. 等待安装完成。如果过程中报错，提示“EACCES”或“Permission denied”，这通常是权限问题。对于Mac或Linux用户，可以在命令前加上 `sudo`（注意：官方其实不太推荐长期用 `sudo` 安装npm包，可能会引发后续权限混乱，但首次安装临时使用可以解决）。对于Windows用户，请务必确认你是在管理员窗口里执行的命令。
安装完成后，可以输入 `openclaw --version` 来检查是否成功，如果显示了版本号，比如“2026.1.29”，那就大功告成了一半。
安装好只是把程序放到了你电脑里，接下来得进行初始化配置，它才能连接AI大脑为你工作。这里会有一个交互式的向导，别怕，跟着提示选就行。
在刚才的命令行窗口里，输入并执行：
```
openclaw onboard
```
或者
```
openclaw onboard --install-daemon
```
（后者会帮你把后台服务也安装好）。
然后向导会一步步问你：
*风险确认：它会提醒你这是一个有强大能力的AI助手，选择“yes”继续。
*配置模式：新手强烈建议选择“QuickStart”（快速开始）模式，它能用最少的配置让你先跑起来看看。
*模型提供商：这里就是关键了，OpenClaw需要一个AI大模型来提供智能。你可以选择像智谱GLM、阿里百炼、字节火山引擎这些国内的平台。选择后，它会引导你去对应的平台官网，注册并获取一个API Key（就像一把钥匙）。把获取到的Key复制粘贴过来就行。
*通讯平台：你想让OpenClaw在哪儿为你服务？是飞书、钉钉这些办公软件，还是就通过网页？初期为了测试，你可以先跳过，直接用它的Web界面。
*技能（Skills）和钩子（Hooks）：这些是高级功能，可以先选“No”跳过，以后有需要再在图形界面里配置。
配置完成后，程序通常会尝试自动打开一个浏览器页面，地址一般是 `http://localhost:18789`。如果没自动打开，你也可以手动在浏览器输入这个地址。看到OpenClaw的网页界面，就说明你的本地AI助手已经成功启动，可以开始对话了！
好了，流程走完了，但我知道你心里肯定还在打鼓：“万一我卡在中间某一步了怎么办？” 别急，咱们把新手最常遇到的几个问题掰开揉碎了说说。
问题一：命令执行完，提示“openclaw 不是内部或外部命令”，这是咋回事？
这通常是环境变量没生效。简单说，就是系统找不到你刚安装的OpenClaw程序在哪。解决起来不难：
1. 完全关闭你当前的命令行窗口。
2.重新打开一个新的管理员PowerShell或终端窗口。这一点非常关键，很多时候问题就这么解决了。
3. 再输入 `openclaw --version` 试试。
如果还不行，可能是Node.js的全局安装路径没在系统环境变量里。你可以试试运行 `npm config get prefix` 查看路径，然后手动把这个路径加到系统的“Path”环境变量里（具体操作可以搜索“Windows添加环境变量”）。
问题二：安装过程卡住不动，或者下载特别慢怎么办？
这就是网络问题了。可以尝试清理npm缓存并换成国内的镜像源，速度会快很多。在命令行里依次执行这两条命令：
```
npm cache clean --force
npm config set registry https://registry.npmmirror.com
```
执行完后，再重新运行安装命令 `npm install -g openclaw@latest` 。
问题三：安装时蹦出一堆红色错误，尤其是提到“sharp编译失败”或者“gyp ERR!”？
这通常是编译环境缺失。特别是在Windows上，OpenClaw的一些依赖需要C++编译环境。你需要安装“Visual Studio Build Tools”或者完整版的Visual Studio，并在安装时勾选“C++桌面开发”这一项。一个更简单的办法是，用Windows自带的包管理工具winget来安装：在管理员PowerShell里运行 `winget install --id Microsoft.VisualStudio.2022.BuildTools --force` 。对于Apple Silicon芯片的Mac用户，“sharp”模块编译失败也很常见，需要确保你的Xcode命令行工具是最新的。
问题四：一切就绪，但浏览器打不开 `localhost:18789` 这个页面？
首先，确认OpenClaw的服务真的在运行。检查方法是在命令行里输入 `openclaw gateway status` 看看。如果没运行，试试 `openclaw gateway start`。
其次，可能是端口被占用了。你可以换个端口启动，比如 `openclaw gateway --port 19001`，然后浏览器访问 `localhost:19001` 。
还有一种情况，如果你用的是Windows的WSL2（Linux子系统）安装的，那么可能需要确保WSL2里的服务绑定到了 `0.0.0.0`，并且在Windows防火墙里放行对应的端口（如18789）。
说到底，安装OpenClaw就像拼一个稍微复杂点的乐高，说明书（教程）有了，零件（环境）齐了，按部就班来，总能拼成。它最大的门槛不是技术，而是耐心和面对命令行时的那一点点勇气。别被那些英文字母吓到，大部分时候你只需要复制、粘贴、回车。遇到报错，别慌，把红色的错误信息完整地复制下来，去搜索引擎里贴一下，十有八九已经有前辈踩过同样的坑并留下了解决方法。技术社区的力量就在于此。当你第一次在浏览器里看到那个简洁的界面，并成功向你的“小龙虾”发出第一条指令时，那种亲手搭建出一个AI助手的成就感，会觉得前面所有的折腾都值了。现在，关掉这篇教程，打开你的命令行，开始行动吧。
版权说明：
