OpenClaw Linux VPS 部署教程，长期在线运行配置指南

如果你的目标不是“在本机试一下”，而是让 OpenClaw 真正长期在线、稳定接渠道、能重启恢复、方便远程排障，那么 Linux 几乎就是默认答案。官方平台页也非常明确：Gateway 在 Linux 上完全支持，Node 是推荐运行时，长期运行时不建议用 Bun 承载 Gateway。

为什么 Linux 是最稳的选择#

Linux 适合作为 OpenClaw 主平台，不只是因为它便宜，而是因为它天然适合下面这些需求：

• 24/7 长期运行
• SSH 远程管理
• systemd 服务化
• 与 Tailscale、反向代理、日志工具整合
• 在服务器、迷你主机、NAS、Raspberry Pi 和 VPS 之间迁移

一旦你开始接 Telegram、WhatsApp、Google Chat 或远程工具，这些能力都会变得很重要。

官方对运行时的建议#

官方 Linux 文档有两个核心结论：

• 推荐 Node 24
• Node 22.16+ 也仍然可用
• 不建议用 Bun 跑 Gateway，因为目前仍有 WhatsApp / Telegram 相关已知问题

如果你只是偶尔在本地做实验，Bun 当然可以尝试；但如果你的目标是长期在线，就不要主动选一条已知会增加不稳定性的路径。

最快的新手 VPS 路径#

官方给出的最短上手步骤非常适合第一次部署：

npm i -g openclaw@latest
openclaw onboard --install-daemon

然后在你自己的电脑上创建 SSH 隧道：

ssh -N -L 18789:127.0.0.1:18789 <user>@<host>

最后在本地浏览器打开：

http://127.0.0.1:18789/

这条路径的意义在于：

• Gateway 保持只监听服务器本地地址
• Dashboard 不需要直接暴露公网
• 你可以先把主链路跑通，再决定是否引入 Tailscale、反向代理或公网 webhook

一台全新 Linux / VPS 的推荐安装顺序#

如果你从零开始搭机器，我建议按下面顺序来：

1. 升级系统软件包
2. 安装 Node 24
3. 安装 OpenClaw CLI
4. 运行 onboarding
5. 让 Gateway 以 daemon / service 方式运行
6. 用 SSH 隧道验证 Dashboard
7. 最后再接渠道、代理或远程访问

这个顺序能明显减少变量数量。很多人一上来就想同时做安装、接渠道、开公网、接模型，结果一个地方出错，整条链路都看不清。

安装 Node 和 OpenClaw#

OpenClaw 在 Linux 上的核心依赖很简单：

• 一个稳定的 Node 运行时
• 全局可调用的 openclaw CLI

安装 CLI：

npm i -g openclaw@latest

装完先检查：

openclaw --version
openclaw doctor

如果这两步都正常，再继续后面的 onboarding。

onboarding 为什么值得优先使用#

在 OpenClaw 里，openclaw onboard 不只是安装向导，它会顺手帮你处理几件麻烦事：

• 初始化本地配置
• 选择模型认证方式
• 引导接渠道
• 检查 Gateway 运行状态
• 询问是否安装守护进程

在 Linux 上，官方给出的推荐命令就是：

openclaw onboard --install-daemon

如果你已经有部分配置，也可以用下面这些入口补装服务：

openclaw gateway install
openclaw configure

当 CLI 询问安装类型时，选择 Gateway service 即可。

Gateway 服务安装与运行#

Linux 的真正优势，是可以把 Gateway 做成稳定服务，而不是靠你手动开着一个终端窗口。

官方文档给出的服务安装入口有三种：

openclaw onboard --install-daemon
openclaw gateway install
openclaw configure

如果后面服务行为不对，官方建议先跑：

openclaw doctor

这通常比盲猜配置问题有效得多，因为它会直接检查一些常见环境错误。

systemd 在这里的意义#

当 Gateway 以 systemd 服务运行时，你会得到几个非常关键的能力：

• 开机自动启动
• 崩溃后自动重启
• 日志可追踪
• 不依赖当前 shell 会话

这也是为什么 Linux 比本地桌面系统更适合做主机。

一个典型的最小 unit 类似：

[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

启用时通常会看到类似：

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

具体名字可能因 profile 不同而略有变化，但思路是一致的。

Linux 上访问 Dashboard 的推荐方式#

阶段一：先用 SSH 隧道

这是最适合新手的方式，因为它安全、简单、变量少：

ssh -N -L 18789:127.0.0.1:18789 <user>@<host>

然后本地打开：

http://127.0.0.1:18789/

阶段二：再决定是否做远程访问

当你需要下面这些能力时，再考虑：

• 手机或多端访问
• 渠道 webhook
• 公网入口
• 多设备统一访问

这时再看 Tailscale、反向代理或 Cloudflare Tunnel，会比一开始就暴露公网稳很多。

Linux 平台最常见的适用场景#

个人长期在线助手

Gateway 挂在家里主机、迷你 PC 或低配 VPS 上，平时通过 SSH 和 Dashboard 管理。

团队消息中枢

OpenClaw 接入 Telegram、Discord、飞书或 Google Chat，在固定主机上长期运行，避免个人电脑下线导致机器人失联。

工具与自动化节点

当你需要浏览器、命令执行、插件和长期日志追踪时，Linux 是最容易把这些能力拼在一起的平台。

什么时候不建议把 Linux 机器直接暴露公网#

很多人一拿到 VPS 就想直接把 18789 端口开出去，这通常不是好主意。更稳妥的做法是：

• Dashboard 先只通过 SSH 隧道访问
• 真正需要 webhook 的路径，再单独暴露
• 尽量只暴露必要端点，不是整个服务

这样做的好处是，安全边界更清晰，排障也更简单。

Linux 上最常见的三个坑#

1. Node 版本太旧

现象通常是：

• 安装阶段就报错
• 某些依赖无法构建
• CLI 行为不稳定

优先检查：

node --version

2. 用 Bun 跑长期 Gateway

如果你接了 WhatsApp / Telegram，又刚好用 Bun 承载 Gateway，遇到不稳定时不要先怀疑渠道，先回到官方推荐的 Node 路线。

3. 服务已经启动，但 Dashboard 打不开

优先检查：

• Gateway 是否只绑定本地地址
• 你是否正确建立了 SSH 隧道
• 端口是否真的在监听 18789

不要一上来就怀疑配置文件损坏，很多时候只是访问路径不对。

推荐的长期演进路线#

如果你现在刚起步，可以按这个节奏往上走：

1. 本地或 VPS 安装 OpenClaw
2. 跑通 openclaw onboard --install-daemon
3. 用 SSH 隧道验证 Dashboard
4. 接一个最简单的模型
5. 接一个消息渠道
6. 再决定是否做公网 webhook、Tailscale 或更复杂的权限策略

Linux 真正的价值，不是“它看起来专业”，而是它让 OpenClaw 的安装、运行、恢复、日志和远程访问都能落在一套成熟稳定的运维习惯上。只要你准备长期使用 OpenClaw，Linux 基本都会成为最后的主平台。