截至 2026 年 11 月 15 日,OpenClaw 官方文档列出的运行时门槛是 Node 24.16.0+ 或 Node 26.1.0+,并将 Node 26 列为推荐运行时、Node 24 LTS 用于 CI 和发布流程。新部署远程 Mac 常驻 Gateway,优先评估 Node 26;需要复现 CI 时,可选符合当前要求的 Node 24。两种选择都必须通过目标安装方式对应的 SQLite 检查,不能只看主版本号。(OpenClaw Node.js 文档)
正在远程 Mac 上部署常驻 OpenClaw Gateway 的开发者,可按场景确定 Node 基线。 维护 CI、发布流程或 Mac 主机运行时的工程师,可据此核对版本差异与验收证据。
最后更新于 2026 年 11 月 15 日;版本与兼容要求核实自 OpenClaw 官方 Node.js、兼容性、安装及 macOS 文档。
OpenClaw Node 26 还是 Node 24:按部署场景确定基线
Node 26 是常驻 Gateway 的默认优先评估项;Node 24 更适合需要和 OpenClaw CI、发布环境保持一致的团队。这里说的是 CLI 与 Gateway 使用的 Node 运行时,不是 OpenClaw 桌面应用的系统要求。官方说明当前 OpenClaw 支持 Node 24.16.0+ 或 26.1.0+,并将 Node 26 列为推荐、Node 24 列为 CI 使用的 LTS 线;安全补丁建议还应另行核对。
- 远程 Mac 常驻 Gateway:Node 26,优先评估。 前提是目标 Node 通过 OpenClaw 对实际 SQLite 绑定的检查,且部署与重启验收通过。官方文档说明 Node 26 为推荐运行时;不要把文档中的总体描述当成你这台主机的性能实测。
- CI 与发布一致性优先:Node 24,条件选用。 当团队需要复现官方 CI 所用运行时,或已有流水线明确固定 Node 24 时,先确认最低版本、安全补丁建议和 SQLite 检查均满足,再让远程 Gateway 使用同一基线。
- 运行环境要求不明确:暂缓固定版本。 先核对当前稳定版文档和安装器路径;不要沿用旧项目里的 Node 22、Node 24 或 Node 26 下限。兼容门槛与安全补丁建议可能变化,官方兼容说明也记录了历次调整。(OpenClaw Node.js 兼容说明)
常驻 Gateway 的运行时边界
远程 Mac 上的 OpenClaw macOS Gateway,需要先分清是独立管理的 CLI/Gateway,还是由桌面应用管理的 Gateway。前者依赖主机上被服务实际调用的 Node;后者可能由应用管理自己的运行时与生命周期,不能把它们混为一个安装条件。官方 macOS 文档明确区分应用、CLI 和 Gateway 的边界。(OpenClaw macOS 文档)
这一区分直接影响排错。你在 SSH 交互终端运行 node -v,显示的是当前 shell 找到的 Node;后台服务可能从另一个路径启动,使用不同的版本或环境变量。因而,终端版本只能作为一条线索,不能单独证明常驻服务的运行时。
主机系统也要分开核对。官方文档说明 Node 24 和 Node 26 的 macOS 二进制以 macOS 13.5 或更高版本为支持范围;桌面应用有自己的系统要求,不能因为 CLI/Gateway 能运行,就推断桌面应用也兼容。若你只运行 CLI/Gateway,按 Node 与 OpenClaw 的对应要求检查;若还要用桌面应用,再单独核对该应用版本的要求。
CI 与发布环境的一致性
如果团队的持续集成或发布流程已经锁定 Node 24,远程 Mac 采用 Node 24 能减少运行时版本差异,但不会自动保证构建结果一致。你还需要记录 OpenClaw 版本、Node 的完整版本、安装路径、SQLite 检查结果,以及 Gateway 的启动与重启结果。只记“Node 24”会漏掉补丁版本和服务路径这两个关键变量。OpenClaw 文档确认 CI 与发布流程使用 Node 24 LTS;具体部署仍须满足目标版本的要求。
若远程 Gateway 使用 Node 26、CI 使用 Node 24,应把这视为有意的环境差异,而不是默认无关紧要。为变更记录保留两边的版本信息、测试命令与结果;只要出现仅在某一侧复现的问题,就能先按运行时差异缩小排查范围。不要把官方对推荐运行时的描述当成你项目在两条运行时上行为完全相同的证明。
安装路径与后台服务的实际 Node
不同安装方式可能准备或复用不同的运行时。OpenClaw 官方安装说明区分常规安装与本地前缀安装;若已存在符合条件的 Node,安装器也可能复用它。macOS 安装器的默认准备行为不能推导成所有部署都强制使用同一版本。(OpenClaw 安装器说明)
自管 Node 时,建议把核查拆成三层:
- 安装选择: 记录你采用的 OpenClaw 安装方式、运行时来源,以及是否使用独立的本地前缀。不要只看安装器给出的默认值。
- 服务配置: 检查 Gateway 服务的启动配置与实际进程,确认它调用的 Node 可执行文件路径。若交互式 shell 与服务使用不同路径,以服务进程为准。
- 进程诊断: 在 Gateway 实际使用的运行环境下运行 OpenClaw 诊断。官方说明,安全审计报告的是运行审计命令的 Node,并不会自动推断另一个后台 Gateway 使用的 Node。
SQLite 兼容与安全补丁核查
Node.js SQLite 兼容不等于“Node 主版本在支持列表里”。OpenClaw 会检查实际加载的 SQLite 绑定,包括 WAL 安全性及数据读写行为;Node 自带的版本元数据不能证明系统实际链接的 SQLite 一定符合要求。兼容说明还区分了 Node 的 TEXT 解码问题与 WAL 安全检查:通过其中一项,不代表另一项也已通过。
安全补丁也要与“最低可接受版本”分开核对。官方 Node 文档同时列出运行时支持门槛和更高的安全补丁建议;在较低但仍符合兼容门槛的版本上,具体提示和处置方式应以当前文档及目标 OpenClaw 版本为准。旧主机系统则可能不在对应 Node 二进制的受支持范围内。发布前重新查阅官方要求,不要照抄旧部署记录中的下限。
若诊断报告 SQLite 问题,先保留完整输出、Node 路径和 Gateway 日志,再按官方兼容说明修复运行时或依赖。不要直接删除运行中的 -wal 或 -shm 文件:SQLite 官方说明,WAL 文件可能包含尚未并入主数据库的已提交事务,分离或删除不当会导致数据丢失或损坏。(SQLite WAL 文档)
远程 Mac 部署验收清单
按下面顺序执行;每一步都保存输出,避免把“安装成功”误判成“常驻服务可用”。
- [ ] 锁定目标: 记录部署的 OpenClaw 版本、用途是常驻 Gateway 还是 CI 复现,以及是否需要与发布环境保持 Node 24 一致。
- [ ] 核对当前门槛: 查阅目标 OpenClaw 版本对应的 Node 最低版本与安全补丁建议。以官方当前文档为准,不从旧脚本或历史截图推断。
- [ ] 确认安装方式: 记录安装器类型、是否复用已有 Node、是否采用本地前缀,并确认预期 Gateway 服务由哪个配置启动。
- [ ] 确认服务实际运行时: 检查后台 Gateway 的进程和启动配置,保存 Node 可执行文件路径及完整版本;不要用另一个交互式终端的版本代替。
- [ ] 运行兼容检查: 使用与 Gateway 相同的运行环境执行 OpenClaw 诊断,记录 SQLite 安全检查结果。注意审计命令报告的是审计进程本身所用 Node。
- [ ] 执行启停验收: 确认 Gateway 能启动、连接正常;按你的服务管理方式重启主机或服务,再次确认 Gateway 状态、实际 Node 路径与日志。
- [ ] 归档对照证据: 将远程 Mac 与 CI 的 Node 版本、OpenClaw 版本、诊断结果和测试输出放在同一变更记录中;存在版本差异时,明确记录原因及回退方案。
常见问题
远程 Mac 的新 Gateway 应该选哪个版本?
常驻 Gateway 优先评估 Node 26,因为 OpenClaw 当前文档将其列为推荐运行时。若团队需要与 CI、发布流程使用的 Node 24 LTS 一致,则选满足当前最低版本及安全要求的 Node 24。无论选择哪条线,都应检查 Gateway 实际使用的 Node 和 SQLite 兼容结果。
Node 24 会影响 Gateway 部署吗?
Node 24 并非天然不兼容;它是 OpenClaw 当前支持并用于 CI 的 LTS 线。影响部署的关键,是目标版本是否接受你安装的具体补丁版本、实际 SQLite 绑定是否通过检查,以及后台服务是否确实调用该 Node。建议记录完整诊断,而不是只保留主版本号。
如何判断 Node 与 SQLite 兼容?
以 OpenClaw 当前的 Node 兼容文档和目标版本诊断为准。检查对象是进程实际加载的 SQLite 绑定及其安全行为,不只是 Node 自报的 SQLite 版本。运行诊断时,确保它与 Gateway 使用相同的运行时;否则诊断通过也不能代表后台服务已通过。
如何让远程 Mac 和 CI 保持一致?
记录 CI 的 Node 完整版本与 OpenClaw 版本,在远程 Mac 的 Gateway 服务配置中确认实际使用的 Node,再分别保存诊断、启动和重启后的结果。如果 Mac 采用 Node 26、CI 采用 Node 24,应明确标注这一差异,并保留两边的测试证据供回归排查。
按验收结果决定是否迁移
如果你现在用普通 Linux 主机或本地机器运行,可能遇到 macOS 专属工具链无法执行、服务环境与交互终端不一致,或缺少独立环境验证空间等限制;但若当前环境稳定、没有 macOS 依赖,也不必为了更换 Node 而迁移。相反,需要隔离验证 OpenClaw macOS Gateway、运行时选择和重启流程时,远程 Mac 能提供真实 macOS 主机环境。先按MACGPU 远程 Mac 环境入口了解环境,再通过MACGPU Mac 选购与环境信息确认是否符合你的测试需求;若只是短期试验,可先租用独立环境验证,长期稳定负载或需要物理接口时则应评估自有主机。
下一步先根据常驻 Gateway 或 CI 对齐场景选定 Node,再跑完上面的验收清单。若现有主机不便试验,可在独立的 MACGPU 远程 Mac 环境里验证 Node、SQLite 与 Gateway 重启流程,通过后再决定是否纳入长期部署。