各平台说明

OpenClaw 核心以 TypeScript 编写，推荐使用 Node.js 运行时（Bun 不推荐用于 Gateway，WhatsApp/Telegram 存在已知问题）。

平台支持矩阵

平台	Gateway	伴生 App	备注
macOS	✅ 完整支持	✅ 菜单栏 App	首选平台
Linux	✅ 完整支持	计划中	含 WSL2
Windows	✅ 支持（推荐 WSL2）	计划中	原生支持有限
iOS	—	✅ Node 伴生 App	移动端节点
Android	—	✅ Node 伴生 App	移动端节点

macOS

macOS 提供最完整的支持，包括菜单栏 App 和 Tailscale 集成。

安装方式：

1. 参考 安装指南，使用推荐的安装脚本
2. 或使用 macOS 伴生 App（下载 .dmg）

系统服务（Gateway 自动启动）：

openclaw gateway install    # 安装为 LaunchAgent
openclaw gateway start      # 启动服务
openclaw gateway status     # 查看状态

• LaunchAgent 标识：ai.openclaw.gateway（或 ai.openclaw.<profile>）
• 日志：~/.openclaw/logs/gateway.log

Linux

安装：

# 推荐：通过安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

# 或通过 npm
npm install -g openclaw

系统服务（systemd）：

openclaw gateway install    # 安装为 systemd 用户服务
systemctl --user enable openclaw-gateway
systemctl --user start openclaw-gateway
systemctl --user status openclaw-gateway

• 服务名：openclaw-gateway.service（或 openclaw-gateway-<profile>.service）

无头服务器：

# 直接运行（tmux/screen 保活）
openclaw gateway

# 或使用系统服务
openclaw gateway install --daemon

Windows

Windows 推荐通过 WSL2 运行 Gateway，原生 Windows 支持有限（伴生 App 在计划中）。

WSL2 方式（推荐）：

1. 安装 WSL2（Ubuntu 22.04+）
2. 在 WSL2 中按 Linux 方式安装 OpenClaw
3. Gateway 运行于 WSL2，通过 Tailscale 或端口转发访问

Windows 原生注意事项：

• exec 工具在 Windows 上优先使用 PowerShell 7（pwsh），回退到 PowerShell 5.1
• 路径分隔符：配置中可使用正斜杠（/），OpenClaw 会自动处理
• WhatsApp 渠道：在 WSL2 中运行效果最佳

iOS（移动端 Node）

iOS 伴生 App 作为**节点（Node）**与 Gateway 配对，扩展 Agent 能力：

• 相机拍照、屏幕录制
• 系统通知推送
• 位置信息
• 本地浏览器操作

配对步骤：

1. 在 Gateway 主机上运行 openclaw qr
2. 在 iOS App 中扫描 QR 码配对
3. 审批配对请求：openclaw pairing approve <id>

配对后，Agent 可通过 nodes 工具控制 iOS 节点。

Android（移动端 Node）

功能与 iOS 相似，通过伴生 App 与 Gateway 配对。

服务器/VPS 部署

常用云服务商：

平台	部署方式
Fly.io	openclaw install fly 向导
Hetzner	Docker 容器
GCP Compute Engine	标准 Linux 安装
DigitalOcean	标准 Linux 安装
Oracle Cloud	免费 tier ARM 实例
Raspberry Pi	标准 Linux 安装（ARM）

通用建议：

• 使用 Tailscale Serve 提供 HTTPS 访问（无需公网 IP）
• 或使用 SSH 隧道：ssh -N -L 18789:127.0.0.1:18789 user@host
• 设置 gateway.auth.token 进行访问控制

快速选择指南

• 个人使用、开发调试：macOS 或 Linux 本机安装
• 7×24 小时在线：Linux 服务器 + systemd 服务 + Tailscale
• Windows 用户：WSL2 + Ubuntu 内运行 Gateway
• 多端联动：Gateway 跑在服务器，iOS/Android App 作为移动节点