OpenClaw 平台支持全景运行时可选、跨平台配套应用与 Gateway 服务安装指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawOpenClaw 是一套以 Gateway 为核心的 AI 代理运行时核心由 TypeScript 编写面向多操作系统与多种托管环境交付。本文以官方平台总览文档 docs/platforms/index.md 为骨架系统梳理运行时的选择策略Node 与 Bun、各操作系统与云主机的支持路径、桌面配套应用的差异以及将 Gateway 安装为系统服务的完整 CLI 流程与各平台的服务形态帮助你根据实际环境快速选定部署方案并完成落地。运行时Node 是主运行时的原因OpenClaw 核心采用 TypeScript 编写Node 是主要、默认且官方推荐的运行时。这一选择贯穿 CLI、Gateway 与受管节点宿主managed node host三条链路源码仓库中的核心实现src 目录下 1.8 万余个 TypeScript 文件全部围绕 Node 生态构建docs/start/getting-started.md 明确要求 Node.js 24.16 或 26.1且 Node 26 为推荐版本。Node 之所以被优先推荐主要基于两点工程考量SQLite 兼容性OpenClaw 依赖node:sqlite提供状态存储对 SQLite 库版本有硬性要求SQLite 3.51.3或 3.50.x 系列中的 3.50.7或 3.44.x 系列中的 3.44.6。Node 内置实现与这一要求完全匹配。进程与文件句柄稳定性以 Bun 1.4.2 为例官方文档指出其可能在 close 之后仍保留 SQLite 句柄与 WAL/shared-memory 文件——当提示词文件释放这类场景敏感时应优先使用 Node。详见 docs/install/bun.md。Bun显式选择的可选运行时Bun 1.4 中提供 WAL-reset-safenode:sqlite的构建版本可以作为显式 opt-in 运行 CLI、Gateway 与受管节点宿主。所谓显式意味着需要明确指定运行时参数例如bun openclaw.mjs onboard --install-daemon --daemon-runtime bun bun openclaw.mjs node install --runtime bun第一条命令在 Bun 下执行 onboarding 并以 Bun 运行时安装受管 Gateway第二条为受管节点宿主单独选择 Bun 运行时。需要留意的限制出自 docs/install/bun.md依赖安装应使用pnpm install当前 Bun 版本无法解析本仓库的pnpm-workspace.yaml布局bun install会在工作区解析阶段失败Bun 会默认阻止依赖的生命周期脚本必要时通过bun pm trust baileys protobufjs显式信任本仓库中这两个脚本并非必需仅作兜底部分包脚本内部硬编码了pnpm如check:docs、ui:*、protocol:check用bun run调用时仍会转交 pnpm 执行直接以 pnpm 运行更省事macOS 上进行原生向量搜索需先执行brew install sqlite。配套应用矩阵每个平台的桌面体验除 CLI 之外OpenClaw 为各平台提供配套应用形态与职责各不相同平台配套形态定位LinuxTauri 桌面应用Rust Web 前端本地/远程 Gateway 选择、系统托盘、Quick Chat 快捷聊天WindowsWindows Hub原生 WinUI 应用桌面应用 Windows 节点模式 本地 MCP 服务器模式macOS菜单栏应用菜单栏状态、本地 Gateway 配套iOS / Android移动端节点应用将手机注册为节点提供设备能力Windows 是选择最丰富的平台Windows Hub提供完整的桌面应用体验安装向导、托盘状态、聊天、Command Center 诊断、Windows 节点能力原生 PowerShell 安装适合终端优先的使用方式WSL2则提供与 Linux 最一致的 Gateway 运行时。三种路径的详细操作见 docs/platforms/windows.md。Linux 配套应用具备一套完整的首启向导引导用户选择本地 Gateway、发现的远程 Gateway、手动输入的 Gateway URL 或 SSH 隧道在本地场景下可自动在私有受管运行时中安装 CLI 与 Node而非强制全局安装还能通过 Bonjour 发现附近的多台 Gateway 并各自打开独立窗口的 Control UI。详见 docs/platforms/linux.md。选择你的操作系统官方平台索引按操作系统划分了完整入口Androiddocs/platforms/android.mdChromeOSCrostinidocs/platforms/chromeos.mdiOSdocs/platforms/ios.mdLinuxdocs/platforms/linux.mdmacOSdocs/platforms/macos.mdOmarchydocs/platforms/omarchy.mdWindowsdocs/platforms/windows.mdVPS 与云托管从单机到服务器Gateway 是无状态可横向扩展的服务端组件官方为服务器场景提供了从传统 VPS 到云主机、再到容器化一键部署的多种路径场景入口VPS 综合指南含服务商选择器docs/vps.mdAzureLinux VMdocs/install/azure.mdDaytona云沙箱docs/install/daytona.mdEasyRunnerPodman Caddydocs/platforms/easyrunner.mdexe.devVM HTTPS 代理docs/install/exe-dev.mdFly.iodocs/install/fly.mdGCPCompute Enginedocs/install/gcp.mdHetznerDockerdocs/install/hetzner.md选用云主机时docs/gateway/configuration.md 提示了几个关键配置关注点监听地址公网需配合 HTTPS/wss 与反向代理、认证方式token 或 password对应gateway.auth.mode、以及OPENCLAW_CONFIG_PATH等环境变量确保 Gateway 在无桌面环境中安全启动。Gateway 服务安装四条 CLI 路径将 Gateway 安装为开机自启的系统服务官方提供四种方式全部受支持# 1. 向导方式推荐onboarding 流程中直接安装守护进程 openclaw onboard --install-daemon # 2. 直接安装 openclaw gateway install # 3. 配置流程交互式向导中选择 Gateway service openclaw configure # 4. 修复/迁移doctor 会检测并主动提出安装或修复服务 openclaw doctor其中openclaw doctor的价值在于自我修复它能识别 Gateway 服务缺失、配置损坏等状态并给出安装或修复建议结合openclaw gateway status可随时确认服务健康度参考 docs/start/getting-started.md 中的openclaw gateway status验证步骤健康基线为 Gateway 监听 18789 端口。需要说明的是--install-daemon同样适用于 Bun 运行时场景见上文--daemon-runtime bun并兼容 npm/pnpm 的全局安装流程例如npm install -g openclawlatest --allow-scriptsopenclaw之后即可执行openclaw onboard --install-daemon详见 docs/install/index.md。各平台的服务形态LaunchAgent、systemd 与 Scheduled TaskGateway 服务的安装目标随操作系统不同而采用不同的守护机制平台服务形态单元/任务名macOSLaunchAgentai.openclaw.gateway命名 profile 时为ai.openclaw.profileLinux / WSL2systemd 用户服务openclaw-gateway[-profile].service原生 WindowsScheduled Task计划任务OpenClaw Gateway或OpenClaw Gateway (profile)Windows 有一个值得注意的降级策略若计划任务的创建被系统拒绝例如组策略限制OpenClaw 会回退到按用户级 Startup 文件夹登录项保证 Gateway 依然能随登录自启。从源码结构看各平台的服务生命周期管理分散在 Gateway 的宿主引导模块中例如 src/gateway/desktop/host-guidance.ts 负责桌面场景的宿主引导提示src/gateway/auth-token-source-conflict.ts 处理认证凭据来源冲突检测——这从侧面印证了服务安装 认证引导是 Gateway 上线的完整闭环。Linux systemd 单元参考对于自定义部署场景docs/platforms/linux.md 给出了手写 systemd用户级单元的极简示例默认路径~/.config/systemd/user/openclaw-gateway[-profile].service[Unit] DescriptionOpenClaw Gateway (profile: profile) Afternetwork-online.target Wantsnetwork-online.target StartLimitBurst10 StartLimitIntervalSec300 [Service] ExecStart/usr/local/bin/openclaw gateway --port 18789 Restartalways RestartSec5 RestartPreventExitStatus78 TimeoutStopSec330 TimeoutStartSec30 SuccessExitStatus0 143 OOMPolicycontinue KillModemixed [Install] WantedBydefault.target需要强调的是手写单元不会继承openclaw gateway install为受管服务写入的自适应堆大小调整adaptive heap sizing官方建议优先使用受管安装器只有在自定义部署时才手写单元并在自定义 supervisor 中显式设置堆上限。TimeoutStopSec330覆盖 Gateway 五分钟的合作式排空cooperative drain及收尾预留时间。安装后启用systemctl --user enable --now openclaw-gateway[-profile].service查看当前受管单元内容systemctl --user cat openclaw-gateway.service命名 profile 时对应openclaw-gateway-profile.service。Windows 计划任务的实现细节Windows 原生路径中计划任务保留可读的gateway.cmd脚本于 OpenClaw 状态目录但通过生成的gateway.vbsWScript 包装器启动从而让后台 Gateway 不弹出可见的控制台窗口。该隐藏启动器拥有受监督的 Gateway 进程树若需结束任务可用schtasks /end /tn OpenClaw Gateway或Stop-ScheduledTask它们会终止 Gateway 及其所有子进程详见 docs/platforms/windows.md。WSL2 的完整开机链路对于无头 WSL 部署需要保证无人登录 Windows 时完整启动链依然生效docs/platforms/windows.md# 在 WSL 内 sudo apt-get install -y dbus-x11 sudo loginctl enable-linger $(whoami) openclaw gateway install# 在 Windows 管理员 PowerShell 中 schtasks /create /tn WSL Boot /tr wsl.exe -d Ubuntu --exec dbus-launch true /sc onstart /ru $env:USERNAME两条关键经验一是用dbus-launch true而非/bin/true规避 WSL ≥ 2.6.1.0 的闲置终止回归二是用/ru $env:USERNAME而非/ru SYSTEM因为按用户安装的 WSL 发行版对 SYSTEM 账户不可见。服务状态验证安装完成后用下面命令确认服务状态与连通性openclaw gateway status # 查看 Gateway 运行状态与监听端口 openclaw status # 汇总状态 openclaw logs --follow # 跟踪日志 openclaw gateway status --json # Windows 等场景的结构化输出Gateway runbook 给出的健康基线是Runtime: running、Connectivity probe: ok且Capability行符合预期如需只读 RPC 级别的证明可加--require-rpc。小结OpenClaw 的平台策略可以概括为一套核心、多端外壳TypeScript 核心以 Node 为默认运行时Bun 作为显式 opt-in桌面配套应用负责把 Gateway 的能力带到 Linux、Windows、macOS 与移动端而无论在哪一端Gateway 服务都能以 LaunchAgent、systemd 用户服务或 Windows 计划任务的形式常驻后台。结合 docs/install/index.md 的安装总览与 docs/start/getting-started.md 的快速上手你可以从五分钟本地跑通平滑过渡到服务器常驻 移动端接入的生产形态。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考