本页内容

本页内容

托管

上传盒子

在 Upstash Box 上运行一个持久的 OpenClaw Gateway,这是一个支持保活生命周期的受管理 Linux 环境。

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

先决条件

  • Upstash 账户
  • 支持保活的 Upstash Box
  • 本地机器上的 SSH 客户端

创建 Box

在 Upstash Console 中创建一个 keep-alive Box。记下 Box ID(例如 right-flamingo-14486)以及你的 Box API key。

Upstash 在 OpenClaw Setup 上维护其当前的 OpenClaw Box 演练。

使用 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

keepalive 选项可减少在引导过程中因空闲而导致的隧道断开。

安装 OpenClaw

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

bash
node -vnpm -v

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

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

Run 入门

bash
openclaw onboard --no-install-daemon

按照提示操作。引导完成后,复制仪表盘 URL 和 token。

启动网关

使网关保持 SSH 隧道的环回状态,然后在后台启动一个无监督进程:

bash
openclaw config set gateway.bind loopbacknohup openclaw gateway run > gateway.log 2>&1 &openclaw doctor --json

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

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

自动重启

将此命令设置为 Box 初始化脚本,以便在 Box 启动时重新启动 Gateway:

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

本指南中的入门引导有意跳过守护程序安装。 Box 初始化脚本是网关启动的单一所有者,因此两个进程不会争用相同的锁和端口。

故障排查

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

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 设置,并在网络空闲期间保持隧道活动。

下一步

相关内容

本页有帮助吗?