> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Upstash Box

在 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo npm install -g openclaw
```

## 运行新手引导

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
```

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

## 启动 Gateway 网关

为 Box 网络配置 Gateway 网关，并在后台启动：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set gateway.bind lan
nohup openclaw gateway > gateway.log 2>&1 &
```

保持 SSH 隧道处于活动状态，并在本地打开仪表板 URL：

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
http://127.0.0.1:18789/#token=<your-token>
```

## 自动重启

将此命令设为 Box 初始化脚本，以便 Box 启动时重启 Gateway 网关：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
nohup openclaw gateway > gateway.log 2>&1 &
```

## 故障排查

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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` 设置，并使隧道在网络空闲期间保持活动状态。

## 相关内容

* [远程访问](/zh-CN/gateway/remote)
* [Gateway 安全](/zh-CN/gateway/security)
* [更新 OpenClaw](/zh-CN/install/updating)