保姆级教程|Win/Mac/Linux 全系统安装小龙虾(OpenClaw),小白也能一次成功

最近被问爆的「小龙虾」，其实是开源AI执行框架 OpenClaw 的昵称——它不是普通聊天机器人，而是能替你干活的“数字员工”，整理文件、写代码、管理日程、自动化办公全都行✅
很多朋友说“想装但怕复杂”“不同系统不知道怎么下手”，今天就整理了 Win、Mac、Linux 三大系统的喂饭级安装教程，全程复制命令、点击下一步，不用懂代码，新手也能10分钟搞定，建议先收藏再操作！
先划重点：小龙虾安装的核心前提是 Node.js ≥ 22版本 + 提前准备好 AI 模型 API Key（Kimi、DeepSeek、OpenAI、Ollama 等都可以），这两步做好，后续安装零卡顿👇
一、安装前必看（避坑关键！）
✅ 系统要求：Win10/11（64位）、MacOS 12+、Linux（Ubuntu 20.04+/CentOS 8+）
✅ 硬件要求：内存≥8GB（推荐16GB），磁盘空间≥10GB（存储技能和缓存）
✅ 必备物品：AI模型 API Key（提前在对应平台创建，复制保存好）
✅ 注意事项：全程联网，安装时关闭杀毒软件（避免拦截下载）
二、Windows 系统（最常用，原生部署无门槛）
全程原生部署，不用WSL、不用Docker，小白直接跟着点，步骤清晰不踩坑👇
步骤1：安装 Node.js 22+（基础环境，必做）
1. 打开 Node.js 官网：https://nodejs.org/（直接复制到浏览器打开）
2. 下载「22.x 最新 LTS 版」（官网首页直接显示，一定要≥22版本，低于22会报错）
3. 双击安装包，一路点击「Next」，所有选项默认即可（不用勾选额外插件）
4. 安装完成后，必须重启电脑（重点！不重启无法验证安装）
✅ 验证安装：重启后按 Win+R，输入「cmd」打开命令提示符，依次输入 node -v 和 npm -v，能显示版本号（node≥22）即为成功。
步骤2：一键安装小龙虾（官方脚本，最稳定）
1. 以管理员身份打开 PowerShell：在Windows搜索栏输入「PowerShell」，右键选择「以管理员身份运行」（必须管理员，否则权限不足）
2. 允许脚本执行：复制粘贴以下命令，回车后按「Y」确认（安全无风险，仅对当前用户生效）：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
3. 执行一键安装脚本：复制粘贴以下命令，回车后耐心等待3-5分钟（取决于网络速度，不要关闭窗口）：
iwr -useb https://openclaw.ai/install.ps1 | iex
步骤3：初始化配置（跟着向导走，不用动脑）
安装完成后会自动弹出配置向导，若未弹出，复制以下命令回车触发：
openclaw onboard --install-daemon
1. 弹出风险提示：直接选「Yes」（回车确认）
2. 选择模型平台：按你准备的 API Key 选择（比如 Kimi 选 Kimi，OpenAI 选 OpenAI）
3. 输入 API Key：粘贴提前准备好的 Key，回车即可（粘贴后看不到内容是正常的）
4. 网关端口：默认18789，不用修改，直接回车
5. 开机自启：选「Yes」（推荐，下次开机不用手动启动）
6. 安装基础技能：选「Yes」（必装，提升小龙虾实用性）
出现「Setup completed」，说明配置成功！
步骤4：启动并访问面板（最终一步）
1. 启动小龙虾：在 PowerShell 输入命令 openclaw gateway run，回车启动（不要关闭窗口，关闭会停止运行）
2. 访问面板：打开任意浏览器，输入 http://localhost:18789，回车即可看到可视化界面，安装完成🎉
三、Mac 系统（简洁高效，终端一键搞定）
Mac 系统核心依赖 Homebrew 和 Node.js，步骤比 Windows 更简洁，全程用终端操作，复制粘贴即可👇
步骤1：安装 Homebrew（软件包管理工具，必做）
1. 按 Command+空格，输入「终端」，回车打开终端
2. 输入命令 brew --version，若显示版本号，说明已安装；若提示“command not found”，复制以下命令回车安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. 安装过程中提示输入开机密码，输入时屏幕不显示字符，输入完成回车即可。
步骤2：安装 Node.js 22+
在终端输入以下命令，等待安装完成：
brew install node
✅ 验证安装：输入 node -v，显示版本≥22即为成功。
步骤3：配置国内镜像（可选，解决下载慢）
国内用户建议配置淘宝镜像，加速依赖下载，终端输入以下命令：
npm config set registry https://registry.npmmirror.com
验证配置：输入 npm config get registry，显示镜像地址即为成功。
步骤4：一键安装小龙虾
在终端输入以下命令，回车后等待安装完成（全程自动，不用手动操作）：
curl -fsSL https://clawd.org.cn/install.sh | bash
步骤5：启动与验证
1. 诊断环境：输入 openclaw-cn doctor，检查环境是否正常
2. 查看状态：输入 openclaw-cn status，确认服务正常运行
3. 打开面板：输入 openclaw-cn dashboard，会自动打开浏览器，进入小龙虾管理页面，安装完成🎉
四、Linux 系统（Ubuntu/CentOS 通用，命令行部署）
Linux 系统适合技术爱好者，全程命令行操作，稳定流畅，步骤如下（以 Ubuntu 为例，CentOS 操作类似）👇
步骤1：更新系统并安装基础工具
打开终端，输入以下命令，一键更新系统依赖并安装必备工具：
sudo apt update -y && sudo apt upgrade -y && sudo apt install -y git curl wget
步骤2：安装 Node.js 22+
1. 配置 Node.js 22 官方源：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
2. 安装 Node.js：
sudo apt-get install -y nodejs
3. ✅ 验证安装：输入 node -v 和 npm -v，显示版本号即为成功。
步骤3：安装 pnpm 并配置镜像（推荐，提升效率）
1. 安装 pnpm：
npm install -g pnpm
2. 配置国内镜像：
pnpm config set registry https://registry.npmmirror.com/
步骤4：一键安装小龙虾
输入官方一键安装脚本，回车后等待自动完成（会自动检测环境、安装依赖）：
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
步骤5：配置与启动
1. 启动配置向导：
openclaw onboard
2. 跟随向导完成 API Key 配置、端口设置（默认18789），步骤和 Windows 一致
3. 启动服务：
openclaw gateway run
4. 访问面板：在浏览器输入 http://localhost:18789，即可使用小龙虾🎉
五、全系统通用：常用命令+避坑指南（收藏备用）
常用命令（复制保存，后续必用）
• 查看版本：openclaw --version
• 重新配置：openclaw onboard（修改 API Key、端口时用）
• 启动服务：openclaw gateway run
• 重启服务：openclaw gateway restart
• 检查状态：openclaw status
常见问题（小白必看，快速解决）
1. 脚本无法运行、提示权限不足：重新以管理员/root身份打开终端，执行“允许脚本执行”命令。
2. 提示 Node 版本过低：卸载旧版 Node.js，重新安装≥22版本，安装后重启电脑/终端。
3. 安装卡住、超时：关闭杀毒软件/防火墙，重新运行安装脚本；国内用户建议配置国内镜像。
4. Web 面板打不开：确认已启动服务，检查端口18789是否被占用（关闭占用软件再试）。
5. 无法执行命令、创建文件：打开配置文件 ~/.openclaw/openclaw.json，将 tools 节点的值改为 full，重启服务即可。
六、最后总结
其实小龙虾（OpenClaw）的安装核心就3步：安装 Node.js 22+ → 执行一键安装脚本 → 配置 API Key 启动服务，不管哪个系统，跟着步骤来，小白也能一次成功✅
安装完成后，你就拥有了一个能替你干活的 AI 数字员工，后续可以安装各种技能包，解锁更多自动化功能～
如果操作中遇到其他问题，评论区留言，我会一一回复帮忙解决！觉得有用，记得点「在看」+「转发」，给更多需要的朋友呀❤️
💡 补充：小龙虾是开源工具，完全免费，无需花钱代装，大家谨防被骗哦～
|（注：文档部分内容可能由 AI 生成)