Upstash Box
先看人话
这页用于补齐 OpenClaw 官方最新文档里的新增内容。先按命令和字段原样理解；如果你只是普通用户，优先看本页的标题、小节和示例命令，不需要一口气读完所有维护者细节。
Run a persistent OpenClaw Gateway on Upstash Box, a managed Linux environment with keep-alive lifecycle support.
Use an SSH tunnel for dashboard access. Do not expose the Gateway port directly to the public internet.
Prerequisites
- Upstash account
- Keep-alive Upstash Box
- SSH client on your local machine
Create a Box
Create a keep-alive Box in the Upstash Console. Note the Box ID, such as right-flamingo-14486, and your Box API key.
Upstash maintains its current OpenClaw Box walkthrough at OpenClaw Setup.
Connect with an SSH tunnel
Forward the OpenClaw dashboard port to your local machine. Use your Box API key as the SSH password when prompted:
ssh -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -L 18789:127.0.0.1:18789 <box-id>@us-east-1.box.upstash.comThe keepalive options reduce idle tunnel drops during onboarding.
Install OpenClaw
Inside the Box:
sudo npm install -g openclawRun onboarding
openclaw onboard --install-daemonFollow the prompts. Copy the dashboard URL and token when onboarding finishes.
Start the Gateway
Configure the Gateway for the Box network and start it in the background:
openclaw config set gateway.bind lan
nohup openclaw gateway > gateway.log 2>&1 &With the SSH tunnel active, open the dashboard URL locally:
http://127.0.0.1:18789/#token=<your-token>Auto-restart
Set this command as the Box init script so the Gateway restarts when the Box starts:
nohup openclaw gateway > gateway.log 2>&1 &Troubleshooting
If SSH freezes during onboarding, reconnect with a clean SSH config and keepalives:
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.comThis bypasses stale local ~/.ssh/config settings and keeps the tunnel active through idle network periods.