> ## 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에서 지속 실행되는 OpenClaw Gateway를 실행합니다. Upstash Box는 keep-alive 수명 주기 지원을 제공하는 관리형 Linux 환경입니다.

대시보드 액세스에는 SSH 터널을 사용하세요. Gateway 포트를 공용 인터넷에 직접 노출하지 마세요.

## 필수 조건

* Upstash 계정
* keep-alive Upstash Box
* 로컬 머신의 SSH 클라이언트

## Box 만들기

Upstash Console에서 keep-alive Box를 만듭니다. `right-flamingo-14486` 같은 Box ID와 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
```

keepalive 옵션은 온보딩 중 유휴 터널 끊김을 줄입니다.

## 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가 시작될 때 Gateway가 재시작되도록 이 명령을 Box init 스크립트로 설정합니다.

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

## 문제 해결

온보딩 중 SSH가 멈추면 깨끗한 SSH 구성과 keepalive로 다시 연결합니다.

```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` 설정을 우회하고 유휴 네트워크 기간에도 터널을 활성 상태로 유지합니다.

## 관련 항목

* [원격 액세스](/ko/gateway/remote)
* [Gateway 보안](/ko/gateway/security)
* [OpenClaw 업데이트](/ko/install/updating)