夜雨聆风最近好多小伙伴后台私信，问「小龙虾OpenClaw」怎么安装，说找了不少教程要么太复杂，要么版本不对，踩了一堆坑。
今天就给大家整理一篇全平台保姆级安装指南，覆盖Windows、macOS、Linux三大系统，不管你是电脑小白，还是有基础的开发者，跟着步骤走，都能零踩坑完成安装，全程不用复杂操作，复制粘贴命令就能搞定✅
先跟新手科普下：OpenClaw俗称「小龙虾」，是一款可本地部署、能帮你干活的AI助手，能操作系统、处理文件、接入聊天平台，实用性拉满，关键是安装起来没有想象中难～
安装前必看｜前置准备（少走90%弯路）
在开始安装前，先确认你的设备符合要求，提前备齐必备工具，避免安装到一半卡壳。
1. 设备配置要求（最低标准，大部分电脑都满足）
操作系统：Windows 10+ / macOS 12+ / Linux（Ubuntu 20.04+、Debian 11+）
内存：最低2GB，推荐4GB+（运行更流畅）
硬盘：预留500MB以上空间（安装包+依赖）
网络：稳定联网（调用AI API需联网，本地模型可离线使用）
权限：Windows需管理员权限，macOS/Linux需开机密码（用于提升权限）
2. 必备工具（全平台通用，附加速方案）
OpenClaw基于Node.js开发，核心工具只有1个，其他可选工具可根据需求安装，所有工具均提供官方地址，避免第三方渠道的安全风险👇
工具名称 | 作用 | 版本要求 | 补充说明 |
|---|---|---|---|
Node.js | 核心依赖，必装 | v20.0.0+，推荐v22 LTS稳定版 | 全平台适配，安装后自动配置环境变量 |
Git | 可选，用于源码克隆、版本更新 | 最新稳定版 | 新手可暂不装，后续更新或源码安装时需用到 |
pnpm | 可选，替代npm的包管理工具，安装更快 | 最新稳定版 | 无需单独下载，用npm命令即可安装 |
Docker | 可选，用于容器部署、多环境隔离 | Docker Engine 20+ 或 Docker Desktop | 适合服务器部署，新手可跳过 |
国内用户必看加速技巧：如果下载工具或安装时速度慢，可切换国内镜像源，执行命令：npm config set registry https://registry.npmmirror.com（永久生效）。
重点来了｜分平台安装步骤（新手首选一键安装）
OpenClaw提供4种安装方式，新手直接冲「官方一键安装」，全程自动化，不用手动配置；有基础的用户可按需选择其他方式，所有方式最终效果一致。
方式1：官方一键安装（新手首选，3-8分钟完成）
最适合零基础用户，脚本会自动检测环境、安装缺失依赖（比如未装Node.js会自动安装），全程不用手动干预，跟着做就行。
✅ Windows系统（必看：管理员权限是关键）
打开管理员PowerShell：点击左下角搜索框，输入「PowerShell」，右键选择「以管理员身份运行」，弹出提示时点击「是」（没有管理员权限会报错）；
执行安装命令：复制下方命令，完整粘贴到PowerShell窗口，按回车键（不要修改任何字符）： iwr -useb https://openclaw.ai/install.ps1 | iex
国内加速（可选）：如果执行命令卡顿、下载慢，替换为国内加速命令： iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
等待安装：全程3-8分钟，期间不要关闭窗口、不要断网，出现「OpenClaw installed successfully」字样，就说明安装完成啦✅
✅ macOS / Linux系统
打开终端：macOS按「Command + 空格」调出搜索，输入「Terminal」回车；Linux按「Ctrl+Alt+T」快速打开；
执行安装命令：复制下方命令，粘贴到终端，按回车键： curl -fsSL https://openclaw.ai/install.sh | bash
权限验证：macOS会提示输入开机密码（输入时不显示字符，输完直接回车）；Linux若提示「权限不足」，在命令前加「sudo」（sudo curl -fsSL https://openclaw.ai/install.sh | bash）；
等待安装：脚本自动完成配置，出现成功提示后，关闭终端即可。
方式2：npm手动安装（已装Node.js v20+用户）
如果已经提前安装了Node.js v20.0.0及以上版本，可直接用这种方式，步骤更简洁，适合有基础的用户。
验证Node.js版本：打开终端/PowerShell，输入命令「node -v」，输出版本号≥v20.0.0即可（版本过低需先升级）；
国内镜像加速（强烈推荐）：输入命令「npm config set registry https://registry.npmmirror.com」，回车确认；
执行安装命令：全平台通用命令「npm install -g openclaw@latest」，回车执行；
权限补充：macOS/Linux若提示「权限不足」，执行「sudo npm install -g openclaw@latest」；macOS若出现sharp依赖安装失败，执行「SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest」；
安装验证：输入「openclaw --version」，输出版本号（如v2026.3.2），即安装成功。
方式3：其他可选安装（适合有基础用户）
如果是服务器部署、开发者二次开发，可选择以下方式（新手跳过即可）：
Docker部署：需提前安装Docker，执行命令「docker pull openclaw/openclaw:latest」拉取镜像，再执行启动命令即可（具体命令可后台回复「Docker」获取）；
源码安装：需提前安装Git、pnpm，克隆源码后编译部署，适合想自定义修改的开发者。
安装后必做｜初始化配置（否则无法正常使用）
无论哪种安装方式，安装完成后都要进行简单初始化，配置管理员密码、AI服务等，步骤全平台通用，新手可全程按回车默认配置👇
打开新的终端/PowerShell（关闭之前的安装窗口）；
输入命令「openclaw onboard」，按回车键启动配置向导；
按提示完成3步配置： ① 设置管理员密码（输入时不显示，输完回车，记住密码，后续登录需用到）； ② 选择AI服务（新手选「云端API」即可，无需本地部署大模型）； ③ 配置端口（默认18789，无需修改，直接回车）；
配置完成后，发送测试消息，能收到AI回复，就说明全部搞定啦！
避坑指南｜常见问题快速解决
安装过程中遇到问题不用慌，这几个高频坑帮你提前规避，快速解决：
❌ 权限不足报错：Windows必须以管理员身份运行PowerShell；macOS/Linux在安装命令前加sudo提升权限；
❌ Node.js版本过低：执行「node -v」查看版本，需升级到v20.0.0+，推荐v22 LTS稳定版；
❌ 下载速度慢：优先使用国内加速命令，或配置npm国内镜像源；
❌ 端口被占用：默认端口18789或3000，可在配置文件中修改端口，或关闭占用端口的程序；
❌ 杀毒软件拦截：安装期间临时关闭杀毒软件，安装完成后再开启（避免误杀核心文件）。
最后总结
其实小龙虾OpenClaw的安装一点都不复杂，新手首选「官方一键安装」，全程复制命令、等待完成，再做简单初始化，10分钟就能搞定。
安装完成后，你就拥有了一款能帮你干活的AI助手，后续如果需要升级、修改配置，或者遇到其他问题，都可以后台私信我哦～
觉得有用的话，记得点赞、在看、转发，分享给身边需要的小伙伴，一起解锁AI助手的便捷用法❤️
「互动福利」：后台回复「OpenClaw」，获取安装命令合集、国内加速包，还有详细配置教程，帮你少走弯路！
