19. 跨平台差异：macOS / Windows / Linux / 移动端

本节目标：看清 OpenClaw 在三大桌面系统和移动端上的安装运行差异，重点是 Node 版本、守护进程机制、权限坑，以及手机怎么接进来。

一个前提：Node 是硬要求

OpenClaw 核心用 TypeScript 写，且默认状态库用了 Node 的 node:sqlite。所以运行环境必须有 Node。

以本教程基准版本 2026.7.1-2（npm latest）为准，官方要求是这三档之一：

低于这些会跑不起来或行为异常。装之前先 node -v 看一眼版本。Bun 可以拿来装依赖、跑脚本，但运行时还是得用 Node。

Tip

版本别贪新也别太旧。最稳的是 22 LTS 或 24 的最新小版本。装完用 openclaw doctor 自检，它能指出环境不对劲的地方。

好消息是，配置目录在各系统上写法一样：

~ 在 Windows 上会被 OpenClaw 解析成你的用户目录（如 C:\Users\你\ .openclaw），你不用改写法。真正不一样的是”网关怎么常驻后台”。

网关（Gateway）得一直跑，消息才能随时进来。不同系统的”开机自启、后台常驻”实现不一样：

装守护进程有几条等价路径，任选其一：

# 向导（推荐）
openclaw onboard --install-daemon

# 直接装
openclaw gateway install

# 或走配置流程选"Gateway service"
openclaw configure

Note

Windows 若创建计划任务被拒，OpenClaw 会退而求其次，用”启动文件夹”的登录项来兜底自启。Linux/WSL2 走 systemd 用户服务，不需要 root。

macOS 有官方菜单栏应用，体验最顺：装好后在菜单栏常驻，自带节点运行时，还能申请”活跃电脑检测”等原生能力。

几个点：

Windows 有两条主流路线：

Windows Hub：桌面应用，最像 macOS 那套体验，适合不想碰命令行的用户。
PowerShell 原生安装或 WSL2：终端党用 PowerShell 最直白；想要最接近 Linux 的运行环境，就装 WSL2，在里头按 Linux 方式跑。

另外，Windows 上跑脚本偶尔会撞上执行策略限制。遇到”脚本被禁止”的提示，按官方建议放宽对应作用域的执行策略即可，别一刀切关掉所有保护。

Linux 的网关完全受支持，也是最常见的长期运行服务端。官方其实已经提供了桌面客户端 Companion（基于 Tauri，提供 .deb / AppImage），不过多数人还是用 systemd 用户服务把网关常驻后台，最省心。

Warning

在服务器上长期运行，记得用普通用户跑网关，别用 root。配合沙箱和工具白名单，能大幅缩小出事时的波及面。

手机不是”另一个装 OpenClaw 的电脑”，而是作为**节点（Node）**连回你已有的网关。iOS / Android 有官方节点应用，装上后配对，手机就成了网关的随身手脚——能收通知、报位置、承接浏览器任务。

具体的配对与命令授权，第 18 章已经讲过了。这里只强调一句：移动端没有”网关守护进程”的概念，它始终是被主网关指挥的那一端。

Tip

想让手机和桌面协同，最省事的拓扑是：在家里一台常开的设备（Mac/Windows/Linux 皆可）跑主网关，手机只装节点 App 配对。这样网关不依赖手机在线，手机只是延伸。

下一章我们看更”内在”的东西：长对话怎么管、记忆怎么存、上下文窗口又是什么。