第二篇 - OpenClaw 安装路线设计
为什么安装 OpenClaw 之前必须先规划。涉及 Node.js 环境、Gateway 服务、Plugin 系统、消息渠道及 AI 模型 Provider。
为什么安装 OpenClaw 之前必须先规划
很多人看到 OpenClaw 的第一反应是：
curl -fsSL https://install.openclaw.ai | bash然后直接执行安装
但实际上，OpenClaw 的安装并不是“一条命令就结束”
因为 OpenClaw 涉及：
- Node.js 运行环境
- Gateway 服务
- Plugin / Tools 系统
- 消息渠道接入
- AI 模型 Provider
同时，不同用户的环境差异非常大：
例如：
因此，在安装 OpenClaw 之前，需要先搞清楚三个问题
安装 OpenClaw 的三个关键问题
在开始安装之前，请先确定三件事。
你使用的操作系统
OpenClaw 支持三类系统：
其中：
- Linux 是 最推荐的运行环境
- Windows 更适合通过虚拟机运行
- macOS 更适合开发体验
你的网络环境
网络环境会直接影响安装方式。
通常可以分为三种
外网环境
可以访问：
- GitHub
- npm
- Docker Hub
这种环境安装最简单。
只需要执行官方安装脚本即可
国内网络环境
可以访问互联网，但部分国外网站不稳定
例如：
- GitHub 速度慢
- npm 下载慢
- Docker Hub 拉取慢
这种情况下需要：
- 使用镜像源
- 使用代理
- 使用国内 npm registry
纯内网环境
完全无法访问外网
例如：
- 企业内网
- 数据中心
- 安全隔离环境
这种情况下需要：
- 离线 Node 安装包
- 离线 npm 包
- Docker 离线镜像
安装复杂度最高
你的使用目标
不同目标，安装方式也不同。
OpenClaw 安装方式总览
OpenClaw 目前有四种安装方式
方式一：官方安装脚本（推荐）
这是官方推荐方式
安装命令：
curl -fsSL https://install.openclaw.ai | bash安装脚本会自动完成：
- Node.js 安装
- OpenClaw CLI 安装
- Gateway 服务安装
- 基础配置
优点：
- 最简单
- 官方支持
- 自动配置
适合：
- 外网环境
- Linux / macOS
方式二：手动 Node 安装
如果官方脚本无法运行，可以手动安装
步骤通常是：
1 安装 Node.js
2 安装 OpenClaw CLI
3 初始化配置
适合：
- 国内网络环境
- 自定义环境
方式三：Docker 安装
Docker 方式适合：
- 服务器环境
- 隔离运行环境
- 快速部署
优点：
- 环境隔离
- 易于迁移
- 易于升级
方式四：离线安装
离线安装适用于：
- 企业内网
- 无外网环境
通常需要：
- Node 离线安装包
- npm 离线依赖
- Docker 离线镜像
这是安装难度最高的方式
三种操作系统的推荐方案
根据不同系统，我整理了一份推荐路线
Windows 用户
Windows 不建议直接运行 OpenClaw
推荐方案：
VMware Workstation
+
Ubuntu 22.04 LTS
+
OpenClaw原因：
- Linux 环境更稳定
- systemd 支持更好
- 插件兼容性更好
因此建议：
在 Windows 上使用 VMware + Ubuntu
Linux 用户
Linux 是最推荐的运行环境
推荐系统：
Ubuntu 22.04
Ubuntu 24.04
Debian 12安装方式：
官方安装脚本如果是服务器环境，可以考虑：
Docker 部署macOS 用户
macOS 安装 OpenClaw 非常简单
步骤：
1 安装 Node.js
2 运行官方安装脚本
适合：
- 开发者
- 本地测试
不同网络环境的安装策略
下面是最关键的一部分
外网环境
最简单
安装步骤：
curl -fsSL https://install.openclaw.ai | bash然后执行：
openclaw onboard即可完成初始化
国内网络环境
需要解决三个问题：
npm 下载慢
解决方法：
使用国内 npm 镜像
例如：
npmmirrorGitHub 下载慢
可以使用：
- GitHub 加速
- 代理
- 镜像
Docker Hub 慢
可以使用：
- 国内 Docker 镜像
- 私有仓库
纯内网环境
纯内网安装步骤通常是：
1 外网机器下载依赖
例如：
- Node 安装包
- OpenClaw CLI
- npm 包
2 拷贝到内网服务器
3 手动安装
如果使用 Docker：
可以通过以下命令传输镜像：
docker save
docker load最终推荐安装矩阵
下面是我总结的一份安装矩阵
安装 OpenClaw 前的准备
在下一篇文章开始安装之前，建议准备以下环境
推荐硬件配置
最低配置：
CPU：2 Core
内存：4GB
磁盘：20GB推荐配置：
CPU：4 Core
内存：8GB
磁盘：50GB推荐系统
推荐：
Ubuntu 22.04 LTS原因：
- 稳定
- 文档最多
- 社区支持好
推荐 Node 版本
OpenClaw 需要：
Node.js 22+建议使用：
Node.js 24 LTS下一篇文章
下一篇文章我们会正式开始安装
内容包括：
- VMware 安装 Ubuntu
- Linux 安装 OpenClaw
- macOS 安装 OpenClaw
以及：
- 国内网络环境配置
- 常见安装问题
上一篇
第二篇-Linux系统安装