平台概览

Linux 应用

Gateway 网关在 Linux 上受到完全支持，并且需要 Node。Bun 仍可用作依赖安装程序或软件包脚本运行器，但不能运行 OpenClaw，因为它不提供 node:sqlite。

桌面配套应用

OpenClaw Linux 配套应用是用于本地 Gateway 网关的 Tauri 桌面应用。它可以：

在 OpenClaw CLI 和托管的 Node 运行时缺失时安装它们
在尝试更改服务之前连接到健康的 Gateway 网关
将安装、启动、停止和重启操作委托给由 CLI 管理的 systemd 用户服务
使用解析出的身份验证 URL 打开由 Gateway 网关提供的 Control UI
窗口关闭后仍可从系统托盘访问

从 main 构建的稳定版本会将 .deb 和 AppImage 软件包作为对应标签的 GitHub 版本资产发布，文件名为 OpenClaw-<version>-amd64.deb 和 OpenClaw-<version>-amd64.AppImage，旁边还会提供 SHA256SUMS.linux-app.txt 校验和文件。下载 .deb 并使用 sudo apt install ./OpenClaw-<version>-amd64.deb 安装，或者将 AppImage 标记为可执行文件并直接运行。AppImage 运行时需要 FUSE 2（sudo apt install libfuse2，在 Ubuntu 24.04+ 上则为 libfuse2t64）；如果没有 FUSE 2，请使用 APPIMAGE_EXTRACT_AND_RUN=1 运行 AppImage。

也可以从源码检出构建相同的软件包：

bash

cd apps/linux/src-tauripnpm dlx @tauri-apps/cli@2.11.4 build --bundles deb,appimage

Linux App CI 工作流会针对涉及该应用的拉取请求和手动运行，上传相同的软件包作为 openclaw-linux-companion 工件。有关 Linux 构建依赖项和开发命令，请参阅仓库中的 apps/linux/README.md。

CLI 和 SSH 替代方案

对于无头服务器、VPS 或远程 Gateway 网关，CLI 仍是最简单的选择：

安装 Node 24.15+（推荐）、Node 22.22.3+（LTS）或 Node 25.9+。
npm i -g openclaw@latest
openclaw onboard --install-daemon
在你的笔记本电脑上：ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
打开 http://127.0.0.1:18789/，并使用已配置的共享密钥进行身份验证（默认使用令牌；如果 gateway.auth.mode 为 "password"，则使用密码）。

完整服务器指南：Linux 服务器。VPS 分步示例： exe.dev。

节点能力

内置的 Linux 节点插件让 CLI 无需桌面应用即可获得 openclaw node 服务设备能力。仅当相应能力已启用且所需的本地工具存在时，命令才会公布给 Gateway 网关。

能力	默认值	要求
桌面通知（`system.notify`）	开启	libnotify 提供的 `notify-send` 和桌面通知会话
相机照片和短片（`camera.*`）	关闭	FFmpeg、V4L2 相机访问权限，以及用于短片音频的 PulseAudio 或 PipeWire
位置（`location.get`）	关闭	GeoClue2 及其 `where-am-i` 演示程序

在 openclaw.json 中配置插件：

json5

{  plugins: {    entries: {      "linux-node": {        config: {          notify: { enabled: true },          camera: { enabled: true },          location: { enabled: true },        },      },    },  },}

更改这些设置后，请重启节点服务。可用性在每个进程中仅判定一次，节点公布信息会在重启时重新构建。

Gateway 网关会将节点的命令和能力范围与设备配对分开审批。首次启动或启用更多能力后，请批准待处理的范围：

bash

openclaw nodes pendingopenclaw nodes approve <requestId>

节点可以保持已连接和已完成设备配对，但其有效的 caps 和 commands 在完成此审批之前仍可能为空。

相机设备必须可由服务用户读取，通常通过 video 组授予权限。当 includeAudio 为 true 时，相机短片使用默认的 PulseAudio 或 PipeWire 音源；麦克风音频仅作为该短片的音轨存在，不提供独立命令。位置功能要求主机的 GeoClue 策略允许节点服务用户访问。

camera.snap 和 camera.clip 还需要通过 gateway.nodes.allowCommands 在 Gateway 网关中明确启用。有关载荷、限制和错误，请参阅相机捕获和位置命令。

安装

Gateway 网关服务（systemd）

使用以下任一方式安装：

bash

openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # 出现提示时选择 "Gateway service"

修复或迁移现有安装：

bash

openclaw doctor

openclaw gateway install 默认生成 systemd 用户单元。完整的服务指南（包括适用于共享主机或常开主机的系统级单元变体）位于 Gateway 网关运行手册中。

仅在自定义设置中才应手动编写单元。最小用户单元示例（~/.config/systemd/user/openclaw-gateway[-<profile>].service）：

ini

[Unit]Description=OpenClaw Gateway（配置文件：<profile>，v<version>）After=network-online.targetWants=network-online.targetStartLimitBurst=5StartLimitIntervalSec=60 [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5RestartPreventExitStatus=78TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.target

启用该单元：

bash

systemctl --user enable --now openclaw-gateway[-<profile>].service

内存压力和 OOM 终止

在 Linux 上，当主机、虚拟机或容器 cgroup 耗尽内存时，内核会选择一个 OOM 终止对象。Gateway 网关并不适合作为终止对象，因为它负责长期运行的会话和渠道连接，因此 OpenClaw 会尽可能优先终止临时子进程。

对于符合条件的 Linux 子进程启动，OpenClaw 会使用一个简短的 /bin/sh 垫片包装命令，将子进程自身的 oom_score_adj 提高到 1000，然后通过 exec 运行实际命令。此操作不需要特权：进程始终可以提高自身的 OOM 分数。

涵盖的子进程范围：

由监督器管理的命令子进程
PTY shell 子进程
MCP stdio 服务器子进程
由 OpenClaw 启动的浏览器/Chrome 进程（通过插件 SDK 进程运行时）

该包装器仅适用于 Linux，并会在 /bin/sh 不可用时，或子进程环境将 OPENCLAW_CHILD_OOM_SCORE_ADJ 设置为 0、false、no 或 off 时跳过。

验证子进程：

bash

cat /proc/<child-pid>/oom_score_adj

涵盖的子进程预期值为 1000；Gateway 网关进程本身保持正常分数（通常为 0）。

当 OOM 终止程序选择临时子进程时，systemd 单元的 OOMPolicy=continue 会让 Gateway 网关服务继续运行，而不是将整个单元标记为失败并重启所有渠道；失败的子进程/会话会报告自身的错误。

这不能替代正常的内存调优。如果 VPS 或容器反复终止子进程，请提高内存限制、降低并发量，或添加更严格的资源控制（systemd MemoryMax=、容器内存限制）。

Linux 应用

桌面配套应用

CLI 和 SSH 替代方案

节点能力

安装

Gateway 网关服务（systemd）

内存压力和 OOM 终止

相关内容

On this page

Molty