快速开始

Upstash Box

在 Upstash Box 上运行持久化的 OpenClaw Gateway 网关。Upstash Box 是一种支持保活生命周期的托管式 Linux 环境。

使用 SSH 隧道访问仪表板。切勿将 Gateway 网关端口直接暴露到公共互联网。

前置条件

  • Upstash 账户
  • 启用了保活的 Upstash Box
  • 本地计算机上的 SSH 客户端

创建 Box

在 Upstash Console 中创建一个启用了保活的 Box。记下 Box ID(例如 right-flamingo-14486)和你的 Box API 密钥。

Upstash 在以下页面维护其最新的 OpenClaw Box 操作指南: OpenClaw 设置

使用 SSH 隧道连接

将 OpenClaw 仪表板端口转发到本地计算机。出现提示时,使用你的 Box API 密钥作为 SSH 密码:

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

保活选项可以减少新手引导期间因空闲导致的隧道断开。

安装 OpenClaw

在 Box 内运行:

bash
sudo npm install -g openclaw

运行新手引导

bash
openclaw onboard --install-daemon

按照提示操作。新手引导完成后,复制仪表板 URL 和令牌。

启动 Gateway 网关

为 Box 网络配置 Gateway 网关,并在后台启动:

bash
openclaw config set gateway.bind lannohup openclaw gateway > gateway.log 2>&1 &

保持 SSH 隧道处于活动状态,然后在本地打开仪表板 URL:

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

自动重启

将以下命令设置为 Box 初始化脚本,以便 Box 启动时重启 Gateway 网关:

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

故障排查

如果 SSH 在新手引导期间卡住,请使用干净的 SSH 配置和保活选项重新连接:

bash
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 中过时的设置,并在网络空闲期间保持隧道处于活动状态。

相关内容

Was this useful?
On this page

On this page