我就知道会是这样。OpenClaw提供了三种安装方式,我在三种之间反复横跳了一整天,最后还是把每种都试了一遍。如果你跟我一样纠结,这篇对比应该能帮到你。
先看全局:三种方式一览
| 一键脚本 | npm全局安装 | 源码安装 | |
|---|---|---|---|
| 适合谁 | 新手 | 普通用户 | 开发者 |
| 前置条件 | 几乎不需要 | Node.js 22+ | Node.js 22+ / Git / pnpm |
| 安装时间 | 3~5分钟 | 2~3分钟 | 5~15分钟 |
| 可定制性 | 低 | 中 | 高 |
| 出错概率 | 最低 | 中 | 最高 |
| 更新方式 | 重新执行脚本 | npm update | git pull + rebuild |
好了,列完表了。但我知道你看完还是不知道选哪个,因为我当时也是这样。来,我把每种方式的优缺点都掰碎了说。
方案一:一键脚本安装
macOS/Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows:
iwr -useb https://openclaw.ai/install.ps1 | iex
优点——说服我选它的理由:
- 会自动检测系统环境,Node.js没装它帮你装
- 全程自动化,几乎不需要人工干预
- 出错概率最低,官方优化过的流程
- 新手友好,不需要懂命令行
缺点——差点让我放弃它的理由:
- 自动安装的Node.js版本你控制不了,万一跟其他项目冲突呢?
- 脚本做了什么、装了什么,你看不太清楚,我有点不放心
- 如果你已经有了Node.js环境,它可能会重复安装,虽然不影响使用但……总觉得不干净
犹豫指数:6/10。好用是好用,但那种"我不知道它到底干了什么"的感觉让我有点焦虑。
方案二:npm全局安装
npm install -g openclaw@latest
openclaw onboard --install-daemon
优点——说服我选它的理由:
- 命令清晰,做了什么一目了然
- 用npm管理,后续更新方便(npm update -g openclaw)
- 不会乱动你的系统环境,就是个普通的npm包
- 速度最快,因为跳过了环境检测那一堆
缺点——差点让我放弃它的理由:
- 前提是你得先装好Node.js 22+,对新手来说这本身就是个门槛
- npm有时候安装会莫名卡住,尤其不配镜像源的时候
- 偶尔会遇到权限问题,得加sudo或者改npm全局路径
犹豫指数:4/10。其实这个方案我最满意,但我一直在想"要不要试试源码安装,万一以后想改代码呢"。
方案三:源码安装
# 用官方脚本的 git 模式
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
# 或者手动来
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm openclaw onboard --install-daemon
优点——说服我选它的理由:
- 完全掌控,想改哪里改哪里
- 支持实时重载开发模式,改了代码马上看效果
- 对理解OpenClaw的架构很有帮助
- 有一种"我从源码编译了这个项目"的成就感(好吧这不算正经优点)
缺点——差点让我放弃它的理由:
- 需要pnpm,又多了一个依赖
- 编译过程可能出各种奇怪的错,尤其是pnpm版本不对的时候
- 更新不是一条命令的事,得git pull再rebuild
- 其实我根本不会去改源码,我在骗自己
犹豫指数:8/10。说实话这个方案最让我纠结,明知道没必要但就是想选。
安装完之后(三种方式都一样)
不管你选了哪种,安装完之后都要跑初始化向导:
openclaw onboard --install-daemon
加上--install-daemon这个参数很重要,它会帮你配置开机自启动和后台守护,省得每次开机都要手动启动。
所以到底选哪个?
纠结了一天之后,我的最终建议是:
- 你从来没用过命令行 → 一键脚本,闭着眼选,不会错
- 你日常写代码或做技术工作 → npm全局安装,干净利落
- 你是OpenClaw贡献者或想参与开发 → 源码安装,不二之选
- 你跟我一样什么都想试 → 三种都装一遍吧,反正也花不了多少时间(别学我)
其实三种方式的最终效果完全一样,差别只在安装过程和后续维护方式。你花在纠结上的时间,可能比三种方式加起来的安装时间还长。
好了我说完了。选一个,装,不要再纠结了。
……但如果你还是拿不定主意,选方案二。这是我最终的推荐。应该是。大概。