OpenClaw的安装

最近技术圈最火的话题，非OpenClaw（也就是大家俗称的“龙虾”）莫属了。这可不是一个普通的聊天机器人，它是一个能真正帮你干活的数字员工——可以替你读文件、搜网页，甚至操作电脑执行任务。

之前后台很多朋友留言，说虽然知道这东西很强，但安装教程太复杂，又是Node又是API的，看了就头大。今天，我就给大家整理了一份2026年最新版的“保姆级”安装教程。不管你是用Windows、Mac，还是想直接部署在云服务器上，跟着这篇文章走，保证你能在30分钟内，拥有一个属于自己的AI“打工人”。

第一步：准备工作（全平台通用）

在开始之前，我们先确认一下电脑的基本情况。OpenClaw目前对 Node.js 的版本要求很高，必须是 22.x 及以上。

操作系统：Windows 10/11（推荐使用WSL2）、macOS、Linux。
内存：建议4GB以上（Mac用户注意，M系列芯片请确保终端是原生arm64模式，不要在Rosetta下运行）。
网络：能够顺畅访问GitHub和NPM。

特别提示：如果你是Windows用户，强烈建议使用 WSL2 环境。如果不想装WSL，也可以直接使用“OpenClaw部署助手”这类图形化工具一键安装。

第二步：分系统安装实战

🪟 Windows系统（两种方式）

方式一：WSL2安装（推荐，兼容性最好）

以管理员身份打开PowerShell，输入以下命令安装Ubuntu子系统：
bash
```
wsl --install-d Ubuntu
```
重启电脑后，打开Ubuntu，设置用户名和密码。

进入Ubuntu环境后，更新软件源并安装Node.js：

bash

sudoapt updatecurl-fsSL https://deb.nodesource.com/setup_22.x |sudobash -sudoaptinstall-y nodejs git

使用官方脚本一键安装OpenClaw：

bash

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

方式二：原生Windows安装（适合不想装WSL的朋友）

去Node.js官网下载22.x版本，安装时记得勾选“Add to PATH”。
安装Git Bash。
打开PowerShell，运行一键安装命令：
powershell
```
iwr-useb https://openclaw.ai/install.ps1 |iex
```

🍎 macOS系统

Mac用户最简单，直接打开终端，输入以下命令即可。如果还没装Homebrew，脚本也会帮你搞定：

bash

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

注意：如果是M系列芯片，安装后如果遇到架构报错，请确保终端没有勾选“使用Rosetta打开”，并尝试用 arch -arm64 npm install -g openclaw 重装。

☁️ 阿里云/服务器部署（7x24小时运行）

如果你想拥有一个永不离线的AI员工，可以考虑部署在云服务器上。目前阿里云提供了非常友好的一键部署方案：

购买一台轻量应用服务器，在镜像选择时直接搜 OpenClaw 应用镜像（内存记得选2GB及以上）。
购买后，在控制台进入“应用详情”，一键放通18789端口。
配置API-Key：点击“一键配置”，把你后面要讲到的模型API Key填进去。
点击“执行命令”生成访问Token，然后通过公网IP加端口就能访问Web界面了。

第三步：初始化与模型配置

安装完成后，真正的配置才刚开始。我们需要让OpenClaw连上一个“大脑”（大模型）。

运行初始化命令：

bash

openclaw onboard --install-daemon

这个命令会启动一个交互式向导，它会问你几个问题，你只需要跟着选：

Gateway设置：选 QuickStart 就行。
选择模型服务商：

新手推荐选 Qwen（千问）：阿里云百炼的新用户有90天免费额度，完全够用了。
如果你有自己的API Key：选 Custom Provider 或 OpenAI。

输入API Key：这里会弹出一个链接，点进去登录授权，或者手动粘贴你的API Key。
Channel选择：这里可以先选 Skip for now，等安装完再慢慢配置钉钉或飞书。

配置完成后，系统会自动验证。如果看到 Verification successful，恭喜你，核心配置搞定了！

第四步：启动并验证

一切就绪后，运行以下命令启动服务：

bash

openclaw gateway start

然后再开一个终端窗口，运行健康检查：

bash

openclaw health

如果看到 OK 或者绿色的对勾，说明你的“龙虾”已经活过来了。

这时候，你可以在浏览器打开 http://127.0.0.1:18789，输入之前生成的Token，就能看到一个漂亮的Web控制台Dashboard。

常见问题排雷区

根据大家的反馈，新手最容易在以下几个地方卡住，我帮大家整理好了解决方案：

1. 提示 Node.js 版本过低（EBADENGINE）

原因：OpenClaw需要Node 22+，而你电脑里是旧版本。
解决：去官网下载最新的Node.js 22覆盖安装，或者用 nvm install 22 切换。

2. 端口被占用（EADDRINUSE）

原因：默认端口18789被别的程序占用了。
解决：杀掉占用的进程，或者改端口 openclaw config set gateway.port 18790。

3. 找不到 openclaw 命令（command not found）

原因：npm的全局路径没加到系统环境变量里。
解决：执行 echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc（Mac/Linux）然后重启终端。

4. Gateway启动后立刻消失

原因：可能是原生依赖下载不完整（比如matrix-sdk-crypto），或者内存不足。
解决：先运行 openclaw doctor 自检一下，看看报什么错。如果是内存问题，可以考虑开swap交换空间。

结语

到这里，你就拥有了一个属于自己的 OpenClaw。

接下来的事情就很有趣了，你可以让它帮你整理会议纪要，或者去钉钉/飞书里当你的专属助理。如果你在安装过程中遇到了上面没提到的问题，记得在评论区留言，我看到都会回复。

快去试试吧，养一只“龙虾”给自己打工，这感觉真的挺爽的。