第2章:OpenClaw 安装部署准备工作
——前置检查、工具下载、环境要求，一步到位避坑
AI+科研院 实操出品 | 零基础避坑指南，部署前必看核心提示：部署前的准备工作，直接决定后续能不能一次成功！本章按「前置自检→工具下载→分系统环境→报错速解→总结预告 」的逻辑梳理，全程精简不啰嗦，只留「硬件、环境、工具、避坑」核心要点，新手宝子们逐项对照着来，能避开80%的部署小报错～ 一、前置7项硬核自检（必做！不做易踩坑） 1. 硬件要求（核心，不用搞高端配置） 内存 ：最低2GB就够，推荐4GB（基础部署完全够用；如果要用到图像生成、本地嵌入功能，再适当加内存就好）；硬盘 ：系统盘留1GB空闲（官方最低要求，仅够装核心程序和依赖），后续加模型、插件记得多留空间，优先用SSD，部署和运行都会更丝滑；CPU ：x64双核及以上就OK，普通入门级CPU完全hold住；重点提醒：32位系统用不了，直接pass～✅ 检查方法超简单：右键「此电脑」→「属性」看内存，打开磁盘就能看空闲空间，不用复杂操作。 2. 系统版本（对照着来，不兼容会翻车） Windows：10/11 64位（专业版/企业版最稳，支持Hyper-V）；家庭版的宝子注意⚠️：不支持Hyper-V ，直接开启WSL2即可，不用白费功夫开Hyper-V哦； MacOS：13+（Ventura及以上，官方最低要求），不管是Intel还是M1/M2/M3芯片，都能正常用； Linux：Ubuntu 22.04 LTS及以上（首推22.04，官方重点适配，少走弯路），Ubuntu 20.04已不再优先支持。 补充：Windows专业版/企业版 Hyper-V 开启详细步骤（新手可直接照做）
方法一（图形化操作，推荐新手）：打开「设置」→「系统」→「高级」→「虚拟工作区」，找到Hyper-V相关选项，勾选「Hyper-V GUI 管理工具」「Windows PowerShell 的 Hyper-V 模块」「Hyper-V 虚拟机监控程序」「Hyper-V 服务」四个开关，点击确定后重启电脑，即可完成开启；
方法二（命令行快捷操作）：以管理员身份打开PowerShell，输入命令「Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All」，按回车执行，等待进度完成后，输入「Y」重启电脑，重启后Hyper-V自动生效；
避坑提醒：老版本Windows 10/11，可通过「控制面板」→「程序」→「启用或关闭Windows功能」，找到Hyper-V勾选全部选项，确定后重启即可；开启后若无法使用，检查电脑BIOS是否开启虚拟化（一般默认开启，无需手动操作）。
3. 系统权限（必开！不然会报权限错） Windows：登录管理员账号，打开终端/PowerShell时，右键选「以管理员身份运行」就好； Mac/Linux：执行命令前加个「sudo」，云服务器直接用root账号，省事不踩坑。 4. 网络与端口（必查！不然启动不了） 网络：必须联网（要下载依赖、调用模型），国内的宝子建议配置镜像源（注：npmmirror相关镜像网页当前解析失败，可暂时放弃镜像配置，直接用默认源下载，不影响使用），下载更快不卡顿； 必查端口：18789（OpenClaw核心端口）、2375/2376（Docker专用），别被其他程序占用啦；
Windows ：netstat -ano | findstr :18789 Mac /Linux：lsof -i :18789
5. 核心依赖预检 Node.js（所有部署模式必需，无例外）：v22.x.x+（官方最低强制要求） ，推荐v22.16+或v24最新稳定版，不支持v22以下版本；建议用NVM工具管理（避免版本冲突，后续切换版本更省心），具体安装步骤见下文工具下载部分； Python（仅源码部署/部分插件需要）：3.8+就可，推荐3.9-3.11，更稳定；Git只有源码部署才需要（2.30+）； 预检命令：node -v、python –version，输完没报错就合格；所有部署模式均需Node.js，无需额外区分客户端类型。 6. 软件冲突排查（提前弄，避免功亏一篑） 提前关掉/卸载这些：旧版Python/Node.js、杀毒软件（容易拦截程序）；虚拟机可以正常用，官方说不冲突哦。 7. 命令行自检（最后一步，零失误） Windows（管理员终端）、Mac/Linux（终端），依次输上面的预检命令，没报错就说明前期准备OK，可直接进入下一步「工具下载」环节啦！ 二、工具下载（精准版本+官方源，不踩坑） 完成前置自检后，咱们开始下载部署所需工具，所有工具都下最新稳定版，别下测试版、别找第三方源，直接复制官方地址下载，省时间还安全～ （补充：部分官方镜像链接解析失败，相关注意事项已在对应步骤标注） 1. OpenClaw 源码（极客必下！重点看这里） 官方地址：https://github.com/openclaw/openclaw/releases （当前最新测试版2026.4.23-beta.6，记得选非beta的稳定版哦）； 划重点：官方目前没有Windows.exe、Mac.dmg安装包，只有源码压缩包（全系统通用），下载后通过后续方式部署就好，不用找.exe啦！ 2. 必备依赖 （1）Node.js 推荐方式：用NVM（Node版本管理器）安装管理，避免版本冲突，后续切换、升级Node.js更便捷，适配所有部署场景，具体步骤如下（全系统通用，新手友好）： 1. 卸载旧版Node.js（重要 ！ 💖 ）：若已安装过Node.js，先卸载（控制面板→程序和功能→找到Node.js右键卸载），删除残留目录（C:\Program Files\nodejs、C:\Users\你的用户名\AppData\Local\npm），清理环境变量中含nodejs、npm的路径条目，重启终端验证（node -v提示“不是内部命令”即为成功）； （2）Python 版本：3.8+（官方最低要求，推荐3.9-3.11，兼容性最好）；官方地址：https://www.python.org/downloads/ ； 关键一步 ：勾选「Add to PATH」，安装完输「pip –version」验证下；仅源码部署/部分插件需要装，无需额外多装。3. Docker（新手首选，可选） 官方地址：https://www.docker.com/products/docker-desktop/ ； 避坑提醒：Windows宝子要开启Hyper-V（仅专业版/企业版支持）；家庭版直接开WSL2再装Docker，不用尝试开Hyper-V，装不上的～ 4. 辅助工具（推荐装，省事儿） 文本编辑器：VS Code（全系统通用，超好用）、Notepad++（Windows专属）；终端：PowerShell（Windows）、原生终端（Mac/Linux），后续改配置、输命令更方便，工具下载完成后，咱们对照自己的电脑系统，检查对应环境要求～ 三、分系统环境要求（对号入座，不瞎折腾） 1. Windows系统（最常用，多注意细节） 系统：10/11 64位（专业版/企业版），需要.NET Framework 4.8+、PowerShell≥5.1（系统一般都自带，没有就补装）；家庭版不支持此模式，需用WSL2部署； 2. Mac系统（最稳，几乎不用额外配置） 系统：13+（Ventura及以上，官方最低要求），终端输「xcode-select –install」，装个Xcode命令行工具就好； 优势：不用瞎配置，下载工具直接装，部署成功率最高，新手宝子优先选Mac～ 3. Linux系统（进阶宝子用，灵活度高） 系统：Ubuntu 22.04 LTS及以上，提前输命令：
sudo apt update && sudo apt install -y curl git gcc build-essential
4. Windows WSL2专项（家庭版最优解） Windows家庭版划重点⚠️：本身不支持Hyper-V ，不用费劲尝试开启！PowerShell管理员输「wsl –install」，重启电脑后，在Ubuntu终端里完成所有操作，完美避开权限、端口冲突，超省心～ （无需重复提醒，与前文系统版本说明呼应，不冗余） （图片占位3） ｜ 三大系统环境汇总图，公众号居中100%显示，对号入座超方便；确认自己的系统符合要求后，若部署中遇到问题，直接查看下方「常见报错速解」即可～四、常见报错速解（遇到问题不用慌，直接查这里） 结合前置自检、工具下载、环境配置的常见问题，整理了6个高频报错及解决方案，部署中遇到问题直接对照，不用反复查资料，高效避坑： ❌ node: command not found → 若用NVM管理，先输入「nvm use 22」切换版本；未安装NVM则重装Node.js并勾选Add to PATH；所有部署模式都需要处理哦； ❌ gyp: No Xcode → Mac宝子输xcode-select –install，装完就好； ❌ 端口18789占用 → 关掉占用这个端口的程序，再重新来； ❌ 权限不足EACCES → Windows用管理员终端，Mac/Linux输命令时加sudo； ❌ Node版本过低 → 用NVM执行「nvm install 22」安装最新v22版本，再用「nvm use 22」切换，低于v22无法部署（官方强制要求）； ❌ pip not found → 重装Python，一定要勾选Add to PATH；仅源码部署/部分插件需要处理。 五、总结+下章预告 ✅ 核心回顾：梳理本章核心要点，帮大家快速复盘：内存≥2GB（推荐4GB）、Node.js v22+（所有部署模式必需，官方强制要求，建议用NVM管理更省心）、Python 3.8+（仅源码部署/部分插件需要），没有端口冲突、权限够，就能顺利部署；Windows家庭版不支持Hyper-V，用WSL2部署最省心～ 想了解更多NVM高级用法和版本管理技巧，可查看我们的另一篇软文：（注：该链接当前解析失败，可后续关注推文更新获取有效链接）。 下一章预告 ：完成本章所有准备工作后，咱们就进入核心部署环节——《OpenClaw 从 0 到 1 实操合集 | 第3章：Docker部署——新手首选，一键部署零报错》，新手宝子必看，全程不用复杂操作，跟着走就能一次成功！💡 合集专属福利
回复关键词「OpenClaw准备」，就能领取：工具官方链接、安装步骤截图、报错速查表，省得大家到处找资源～ 关注「AI+科研院」，免费领福利，后续教程持续更新，陪大家一起搞定OpenClaw！
夜雨聆风
