OpenClaw 基于 TypeScript 构建，运行在 Node.js 之上，天然具备跨平台能力。无论你使用的是 macOS、Linux 还是 Windows，无论你想在本地桌面还是云端服务器运行，都有对应的部署方案。本文将系统梳理各平台的安装方式和云端托管选项，帮助你找到最适合自己的部署路径。
技术基础
OpenClaw 的核心——Gateway（网关服务）——使用 TypeScript 编写，依赖 Node.js 运行时。这意味着只要能运行 Node.js 的环境，理论上都可以部署 OpenClaw。
有一点需要特别注意：不要使用 Bun 来运行 Gateway。虽然 Bun 兼容大部分 Node.js API，但在处理 WhatsApp 和 Telegram 连接时存在已知 Bug，会导致消息收发异常。请务必使用官方 Node.js 运行时。
支持的客户端平台
除了核心的 Gateway 服务，OpenClaw 还提供了多端伴侣应用（Companion App），方便你在不同设备上管理和监控：
| 平台 | 状态 | 说明 |
|---|---|---|
| macOS | 已发布 | 菜单栏常驻工具，可快速查看状态和管理服务 |
| iOS | 已发布 | 移动端管理，随时随地查看消息和配置 |
| Android | 已发布 | 同 iOS，支持通知推送 |
| Windows | 开发中 | 桌面客户端，即将推出 |
| Linux | 开发中 | 桌面客户端，即将推出 |
需要明确的是，伴侣应用是用来管理和监控 Gateway 的，Gateway 本身才是处理消息的核心服务，需要单独部署并保持运行。
Gateway 安装方式
OpenClaw 提供了四种安装方式，从简单到灵活依次如下。
方式一：一键安装脚本（推荐）
官方提供了交互式安装向导，会自动完成环境检测、依赖安装和基础配置：
curl -fsSL https://openclaw.ai/install.sh | bash
这是最推荐的方式，适合大多数用户。脚本会引导你完成 Node.js 版本检查、Gateway 安装和初始化配置。
方式二：npm 全局安装
如果你已经有 Node.js 环境，可以直接通过 npm 安装：
npm install -g openclaw@latest
安装完成后，如果终端提示找不到 openclaw 命令，需要检查 npm 全局安装路径是否在系统 PATH 中：
npm prefix -g
将输出的路径下的 bin 目录添加到你的 PATH 环境变量即可。
方式三：从源码构建
适合需要定制或参与开发的用户：
git clone https://github.com/openclaw-ai/openclaw.git
cd openclaw
pnpm install
pnpm build
使用 pnpm 时，需要额外执行一步授权构建脚本的命令：
pnpm approve-builds -g
方式四：直接安装 Gateway
如果你只需要 Gateway 核心组件，不需要完整的工具链，也可以单独安装 Gateway 包。具体包名和方式请参考官方文档。
安装后的初始化
无论使用哪种方式安装，完成后都建议执行以下三个步骤：
# 1. 运行引导程序，完成初始配置并安装守护进程
openclaw onboard --install-daemon
# 2. 检查环境是否正常
openclaw doctor
# 3. 打开管理面板
openclaw dashboard
openclaw doctor 会检测 Node.js 版本、网络连接、配置文件等关键项，帮助你快速定位问题。
各操作系统部署要点
macOS
macOS 是 OpenClaw 的一等公民平台。安装 Gateway 后，可以通过 LaunchAgent 实现开机自启动和后台运行。openclaw onboard --install-daemon 会自动创建对应的 LaunchAgent 配置文件，无需手动编写 plist。
Linux
Linux 服务器是生产环境部署的首选。推荐使用 systemd user services 来管理 Gateway 进程，实现自动重启和日志管理。同样，openclaw onboard --install-daemon 会自动生成 systemd 服务文件。
创建服务后，可以用以下命令管理：
systemctl --user start openclaw
systemctl --user enable openclaw
systemctl --user status openclaw
Windows
Windows 用户推荐使用 WSL2（Windows Subsystem for Linux 2）来运行 Gateway。WSL2 提供了完整的 Linux 内核环境，避免了原生 Windows 上可能出现的兼容性问题。
# 在 WSL2 中安装
wsl
curl -fsSL https://openclaw.ai/install.sh | bash
WSL2 中的 Gateway 同样可以使用 systemd 来管理（需要 WSL2 启用 systemd 支持）。
云端托管方案
如果你希望 Gateway 7x24 小时稳定运行，部署到云端是更好的选择。以下是经过社区验证的托管方案：
| 方案 | 特点 | 适合场景 |
|---|---|---|
| VPS（Vultr、DigitalOcean 等） | 完全控制，灵活配置 | 有运维经验的用户 |
| Fly.io | 容器化部署，全球节点 | 追求低延迟的用户 |
| Hetzner + Docker | 高性价比欧洲机房 | 预算敏感的用户 |
| Google Cloud Compute Engine | 企业级基础设施 | 需要高可用的团队 |
| exe.dev | 提供 VM 并自带 HTTPS 代理 | 希望快速上线的用户 |
其中 VPS 是最通用的方案——你拥有完整的服务器控制权，可以按需配置环境。最低 1 核 2GB 内存即可流畅运行 OpenClaw Gateway。
部署建议
根据不同场景，以下是一些实用建议：
- 个人尝鲜：在本地 macOS 或 Linux 机器上用一键脚本安装，几分钟即可体验。
- 长期使用：选择一台 VPS 或 Fly.io，配合 systemd 或容器编排，确保服务持续在线。
- 多平台管理：部署好 Gateway 后，在手机上安装 iOS/Android 伴侣应用，随时查看运行状态。
- Windows 用户：不要在原生 Windows 上直接运行 Gateway，使用 WSL2 可以避免大量兼容性问题。
- 避免 Bun：无论在哪个平台，都请使用 Node.js 而非 Bun 运行 Gateway。
OpenClaw 的跨平台特性让你可以根据自身需求灵活选择部署方式。从树莓派到云服务器，从个人笔记本到企业级集群，总有一种方案适合你。