夜雨聆风最近OpenClaw彻底火出圈了！GitHub星标狂涨至21.5万+，日增3800+星标，堪称效率控的“万能AI助手”✨
不同于普通聊天AI，OpenClaw是一款能“动手干活”的开源AI智能体——能通过聊天软件发指令、自动整理文件、处理邮件、运行脚本，甚至自定义技能拓展，把你从繁琐重复的工作里彻底解放出来，堪称永不疲倦的“数字员工”[2]。
但很多新手私信我，说刚上手就栽在安装部署上：Node.js版本不对、权限不足、路径含中文、API Key配置失败……各种坑让人没开始就想放弃！
今天这篇教程，专为小白定制，全程“照抄作业”即可！覆盖Windows、Mac、Linux全平台，优先推荐「一键脚本安装」（新手首选），同时补充进阶安装方式，每一步标红关键操作，每类报错直接给解决方案，哪怕你是纯电脑小白，跟着做也能10分钟搞定～
💡 前置必看：安装前准备（避免90%失败）
在开始安装前，先确认你的设备满足以下条件，提前排查问题，节省时间，小白直接对照表格检查即可[1][3]！
配置项 | 最低要求（小白达标即可） | 推荐配置（更流畅） |
|---|---|---|
操作系统 | Windows 10+/macOS 12+/Ubuntu 20.04+ | Windows 11/macOS 14+/Ubuntu 22.04 |
内存 | 2GB（勉强够用） | 4GB以上（推荐） |
存储空间 | 5GB（最低） | 10GB以上（避免后续不够用） |
网络 | 能访问GitHub和npm（必须达标） | 稳定的国际网络连接（国内用户可用加速镜像） |
核心依赖 | Node.js ≥ 22版本（必装） | Node.js 22.x LTS稳定版 |
重点提醒：Node.js版本过低是90%安装失败的根源！小白一定要先检查版本，下文会教大家如何安装/升级～
🚀 新手首选：一键脚本安装（全平台通用，零门槛）
这是官方推荐的最简单方式，脚本会自动检测系统环境、安装全量依赖、配置环境变量，全程无需手动干预，适合90%的小白用户[3]。
✅ 第一步：打开对应终端（关键！权限要够）
不同系统打开终端的方式不同，小白直接对照操作：
Windows用户：电脑左下角搜索“PowerShell”，右键点击「Windows PowerShell」，选择「以管理员身份运行」，弹出提示点击「是」（必须管理员权限，否则会报错权限不足）[3]。
Mac用户：按 Command + 空格，输入“Terminal”回车，打开终端即可[3]。
Linux用户：按 Ctrl + Alt + T 快捷键，直接打开终端[3]。
✅ 第二步：复制一键安装命令（直接抄）
根据自己的系统，复制对应的命令，完整粘贴到终端中，按下回车键执行即可。
Windows用户（优先推荐）： 国内网络下载较慢，可使用国内加速镜像命令（更稳）：
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex官方原版命令（适合网络较好的用户）：curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmdMac/Linux用户：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method gitMac用户执行时，会提示输入电脑开机密码（输入时不显示字符，属于正常现象），输入完成后回车即可[3]。
✅ 第三步：等待安装完成（耐心等就好）
脚本会自动完成系统环境检测、Node.js依赖安装、OpenClaw核心程序下载、环境变量全配置，全程无需手动操作，耗时3-8分钟（取决于网速），请勿中途关闭窗口[3]。
当终端出现「OpenClaw installed successfully」提示，即代表安装完成～
🔍 安装验证：确认安装成功（必做）
安装完成后，不要直接关闭终端，输入以下命令，验证是否安装成功：
输入命令
openclaw --version，按下回车，若显示版本号（如 v2026.3.2），说明安装成功[3][5]。输入命令
openclaw doctor，按下回车，可一键诊断系统环境、依赖、网络等全配置是否正常[3][5]。
⚙️ 后续配置：让OpenClaw正式“干活”
安装成功后，还需要简单配置一下，让OpenClaw连接AI模型、绑定聊天平台，才能正常接收指令干活～
Step 1：启动初始化配置向导
在终端输入命令 openclaw onboard，按下回车，进入交互式配置向导，按提示一步步操作即可[3][5]。
Step 2：核心配置步骤（小白直接照选）
选择AI供应商：支持 Claude、GPT、Gemini、国内大模型（如星火、通义千问）、本地Ollama模型等，新手推荐选国内大模型，无需科学上网[4][5]。
粘贴API Key：从对应AI供应商后台获取API Key（密钥仅存储在本地，不会上传），粘贴后按提示验证即可[3][5]。 ⚠️ 注意：目前Claude Pro/Max账号无法通过OAuth连接，需使用按量付费计划的API Key并绑定支付方式[1]。
接入聊天平台：支持飞书、钉钉、Telegram、Discord等，新手优先选飞书（国内使用最方便），按提示完成绑定即可[4][5]。
发送测试消息：通过已绑定的聊天软件给OpenClaw发一条消息（比如“你能做什么？”），收到AI回复即代表配置完成，可正常使用[5]。
权限设置提醒：OpenClaw具备系统级权限，可执行Shell命令、访问文件系统，建议仅勾选“文件系统访问”和“Shell访问”，禁止“网络访问”以提升安全性[4]。
🔧 进阶安装方式（适合有基础的用户）
如果小白觉得一键安装不够灵活，或想自定义功能、部署在服务器上，可以选择以下方式，步骤同样简单～
方式1：包管理器安装（npm/pnpm）
适合已安装Node.js 22+环境的用户，执行以下命令全局安装[3][5]：
npm安装（通用）：
npm i -g openclaw@beta安装完成后启动配置向导：openclaw onboardpnpm安装（更省空间、速度更快）：
pnpm add -g openclaw@beta安装完成后启动配置向导：openclaw onboard
方式2：Docker容器安装（适合服务器/隔离环境）
需提前安装Docker Engine 20+或Docker Desktop，执行以下命令拉取镜像并启动容器[3][5]：
拉取最新镜像：
docker pull openclaw/openclaw:latest启动容器（配置端口映射与数据持久化）：
docker run -d --name openclaw -p 3000:3000 -v ~/.openclaw:/root/.openclaw --env-file ~/.openclaw/.env openclaw/openclaw:latest
方式3：源码编译安装（适合开发者/自定义修改）
需提前安装Git、pnpm工具，执行以下命令克隆源码并编译部署[3][5]：
克隆官方源码：
git clone https://github.com/openclaw/openclaw.git进入目录安装依赖并编译：
cd openclaw && pnpm install && pnpm run build启动配置向导：
pnpm run openclaw onboard
❌ 常见报错&解决方案（小白直接抄）
整理了安装过程中最常出现的4类问题，不用懂原理，直接对照解决方案操作即可[1][3][5]！
报错1：Windows输入nvm命令提示“不是内部或外部命令”解决方案：重启电脑，重新打开PowerShell（管理员身份），若仍报错，卸载nvm重新安装（全程点下一步，别改路径）。
报错2：Mac/Linux输入命令提示“权限不足”解决方案：命令前加sudo，即
sudo 原命令，输入电脑开机密码（输入时不显示字符，正常），输完按回车。报错3：安装Node.js时卡住，提示“网络超时”解决方案：先复制命令
npm config set registry https://registry.npmmirror.com粘贴到终端按回车，再重新执行安装命令。报错4：端口被占用（提示“Port 3000 is in use”）解决方案：在本地 .openclaw/.env 配置文件中修改 PORT=自定义端口（如3001），或关闭占用端口的程序。
📌 最后提醒
OpenClaw是开源免费工具，所有操作全程免费，无需专业技术基础，跟着步骤“抄作业”就好[1]。
后续想升级OpenClaw，可根据安装方式执行对应升级命令（npm/pnpm用update命令，Docker用pull命令）[5]。
如果不想使用OpenClaw，直接在终端输入命令
npm uninstall -g openclaw（npm安装）或pnpm remove -g openclaw（pnpm安装），即可卸载[5]。
按照以上步骤操作，小白也能轻松搞定OpenClaw安装～ 安装完成后，试试让它帮你整理文件夹、生成报告，真正实现“一句话，帮你搞定”！
如果安装过程中还有其他问题，评论区留言，我会一一回复～
✨ 关注我，后续分享更多OpenClaw实用玩法，让AI帮你高效摸鱼～
