# Upstash Box

> 在 Upstash Box 上托管 OpenClaw，并支持保活和 SSH 隧道访问

- 网址：https://funcoding.ai/agents/openclaw/install/upstash/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/install/upstash

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

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

## 前提条件

- Upstash 账户
- 支持保活的 Upstash Box
- 本地计算机上的 SSH 客户端

## 创建 Box

在 Upstash Console 中创建支持保活的 Box。记下 Box ID（例如
`right-flamingo-14486`）和 Box API 密钥。

Upstash 在以下页面维护其最新的 OpenClaw Box 操作指南：
[OpenClaw 设置](https://upstash.com/docs/box/guides/openclaw-setup)。

## 使用 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 lan
nohup 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` 设置，并使隧道在网络空闲期间保持活动状态。

## 相关内容

- [远程访问](https://funcoding.ai/agents/openclaw/gateway/remote/)
- [Gateway 安全](https://funcoding.ai/agents/openclaw/gateway/security/)
- [更新 OpenClaw](https://funcoding.ai/agents/openclaw/install/updating/)