OpenClaw 第三篇：环境准备 + 本地部署，5 分钟拉起来
OpenClaw 第三篇：环境准备 + 本地部署，5 分钟拉起来
前两篇我们搞懂了OpenClaw的概念、定位与核心架构，相信大家已经迫不及待想上手实操了。这一篇主打零基础纯实操，没有复杂原理、没有晦涩代码，跟着步骤一步步走，5分钟就能完成本地部署，让你的专属AI智能体正式上线。全程适配Windows、macOS、Linux三大系统，附复制即用命令+避坑指南，新手零失败。
一、部署前必读：系统要求与核心前提
OpenClaw主打轻量化本地运行，对设备配置要求极低，日常办公电脑、笔记本都能轻松带动，无需高端显卡，普通集显、无独显均可运行，先确认设备基础条件：
系统支持：Windows 10/11（64位）、macOS 12+、Linux全主流发行版（Ubuntu、CentOS等）
硬件门槛：内存≥4GB（推荐8GB，运行更流畅）、剩余存储空间≥2GB、常规网络环境
核心前提：无需提前安装大模型，初期接入通用API即可；无需公网IP，纯本地局域网运行，数据完全不外泄
关键提示：部署全程建议使用管理员/root权限，避免因权限不足导致安装失败、命令无法执行等问题；网络保持畅通，无需科学上网，国内常规网络即可正常拉取资源。
二、前置环境：一键安装必备依赖
OpenClaw仅依赖Node.js这一个核心工具，作为运行基础，安装过程超简单，各系统操作如下，全程5分钟内搞定：
1. 安装Node.js（必装）
OpenClaw依托Node.js环境运行，建议安装LTS长期稳定版，兼容性最强，避免踩版本坑。
下载渠道：官网直达（https://nodejs.org/），选择对应系统的LTS版本，无脑下一步安装即可
安装校验：安装完成后，打开终端（Windows用CMD/PowerShell，macOS/Linux用自带终端），输入以下命令，出现版本号即安装成功：
node -vnpm -v
如果命令无响应，重启终端即可；若仍报错，检查Node.js是否添加至系统环境变量，默认安装会自动配置，无需手动修改。
2. Git安装（可选，推荐）
Git用于拉取OpenClaw开源源码，后续更新、二次开发更方便，没安装的话直接下载压缩包也能部署，推荐新手顺手安装：
Windows/macOS：官网（https://git-scm.com/）下载安装，默认配置即可
Linux：终端直接执行
sudo apt install git（Ubuntu）/sudo yum install git（CentOS）
三、本地部署：两种极简方案，任选其一
这里提供两种部署方式，方案一Git拉取（推荐，后续易更新）、方案二压缩包部署（纯新手，零命令），按需选择，操作都超简单。
方案一：Git克隆源码（推荐，省心更新）
打开终端，进入想要存放OpenClaw的文件夹（比如桌面、D盘、文稿文件夹），示例命令：
# Windows示例（进入D盘OpenClaw文件夹）d: && mkdir OpenClaw && cd OpenClaw# macOS/Linux示例（进入文稿文件夹）cd ~/Documents && mkdir OpenClaw && cd OpenClaw执行克隆命令，拉取官方开源源码，等待几秒完成：
git clone https://github.com/openclaw/openclaw.git .安装项目依赖，核心命令，耐心等待1-2分钟：
npm install
方案二：压缩包解压（零命令新手版）
前往OpenClaw GitHub仓库（https://github.com/openclaw/openclaw），点击右上角【Code】→【Download ZIP】，下载源码压缩包
解压压缩包到指定文件夹（路径不要含中文、空格，避免报错，比如D:\OpenClaw）
打开终端，进入解压后的文件夹路径，执行
npm install命令安装依赖即可
四、核心配置：API密钥与基础参数
依赖安装完成后，只需简单配置API密钥，OpenClaw就能调用大模型“思考干活”，全程复制粘贴，无难度。
进入项目文件夹，找到.env.example示例文件，复制一份并重命名为.env（注意文件名前有个点，Windows系统直接重命名即可）
打开.env文件，找到
OPENAI_API_KEY=字段，填入你的OpenAI API密钥（也支持Claude、Gemini等主流大模型API，按需替换对应字段即可）基础参数默认即可，无需修改；若需自定义端口、日志路径，可按需调整，新手建议保持默认
避坑重点：.env文件切勿泄露，API密钥关乎账号安全；路径严禁中文、特殊字符，否则会出现配置读取失败、程序无法启动的问题。
五、启动运行：一键启动，验证部署成功
配置完成后，只需一行命令即可启动OpenClaw，见证你的AI智能体上线！
终端执行启动命令，保持终端窗口开启（关闭即停止运行）：
npm start等待启动加载，出现“OpenClaw started successfully”类提示，即为启动成功
本地访问验证：打开浏览器，输入
http://localhost:3000（默认端口3000），能正常访问控制台，说明部署完全成功
六、常见报错&极速解决（新手必看）
报错1：npm install失败/网络超时：切换国内npm镜像，执行
npm config set registry https://registry.npmmirror.com/后重新安装报错2：权限不足：Windows右键终端“以管理员身份运行”，macOS/Linux命令前加sudo
报错3：端口占用：修改.env文件中PORT字段，换成3001、8080等未占用端口
报错4：API密钥无效：检查密钥是否正确、是否有余额、模型权限是否开启
七、本篇小结与下一篇预告
到这里，你的OpenClaw本地部署就圆满完成了，全程无复杂操作，真正实现5分钟快速上手。相比于其他AI智能体，OpenClaw轻量化、无门槛、本地可控的优势尽显，零基础小白也能轻松驾驭。
启动成功只是第一步，下一篇我们将进入基础指令实战环节，讲解文件操作、终端执行、浏览器自动化等高频场景，教你用自然语言指挥AI干活，彻底解放双手，敬请期待。
实操总结：装Node.js→拉源码/解压→装依赖→配API→启动运行，四步走完，专属AI智能体即刻就位！