跳转至

Upstash Box

在 Upstash Box 上运行持久化的 OpenClaw Gateway。Upstash Box 是一个托管 Linux 环境，支持 keep-alive 生命周期。

使用 SSH 隧道访问仪表盘。不要将 Gateway 端口直接暴露到公共互联网。

前提条件

  • Upstash 账户
  • 支持 keep-alive 的 Upstash Box
  • 本地机器上的 SSH 客户端

创建 Box

在 Upstash 控制台创建一个 keep-alive Box。记下 Box ID（例如 right-flamingo-14486）和你的 Box API 密钥。

Upstash 在其 OpenClaw Setup 页面维护了最新的 OpenClaw Box 操作指南。

使用 SSH 隧道连接

将 OpenClaw 仪表盘端口转发到本地机器。出现提示时，使用你的 Box API 密钥作为 SSH 密码：

ssh -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -L 18789:127.0.0.1:18789 <box-id>@us-east-1.box.upstash.com

keepalive 选项可减少引导配置过程中空闲隧道的断开。

安装 OpenClaw

首先检查 Box 的运行时版本，因为安装命令取决于 npm 版本：

node -v
npm -v

在 Box 内，当 npm 版本为 12 或 11.16+ 时使用以下命令。在 npm 11.15 及更早版本上，请省略 --allow-scripts=openclaw。

sudo npm install -g openclaw --allow-scripts=openclaw

运行引导配置

openclaw onboard --no-install-daemon

按照提示操作。引导配置完成后，复制仪表盘 URL 和令牌。

启动 Gateway

将 Gateway 配置为通过环回地址供 SSH 隧道使用，然后在后台启动一个不受监督的进程：

openclaw config set gateway.bind loopback
nohup openclaw gateway run > gateway.log 2>&1 &
openclaw doctor --json

在 SSH 隧道处于活动状态时，在本地打开仪表盘 URL：

http://127.0.0.1:18789/#token=<your-token>

自动重启

将此命令设置为 Box 的初始化脚本，以便 Gateway 在 Box 启动时自动重启：

nohup openclaw gateway run > gateway.log 2>&1 &

本指南中的引导配置刻意跳过了守护进程安装。Box 初始化脚本是 Gateway 启动的唯一所有者，因此不会有两个进程争用同一个锁和端口。

故障排除

如果在引导配置过程中 SSH 卡住，请使用干净的 SSH 配置和 keepalive 重新连接：

ssh -F /dev/null -o ControlMaster=no -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -L 18789:127.0.0.1:18789 <box-id>@us-east-1.box.upstash.com

这会绕过本地过期的 ~/.ssh/config 设置，并在网络空闲期间保持隧道活动。

后续步骤

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw