Upstash Box
기준일: 2026-07-26
공식 기준: Upstash Box
Upstash Box 문서는 OpenClaw 공식 문서(install/upstash)를 한국어로 정리한 가이드입니다. Host OpenClaw on Upstash Box with keep-alive and SSH tunnel access 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
Host OpenClaw on Upstash Box with keep-alive and SSH tunnel access
한국어 가이드 범위: install/upstash 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- 사전 요구사항
- Create a Box
- Connect with an SSH tunnel
- Install OpenClaw
- Run onboarding
- Start the Gateway
- Auto-restart
- 트러블슈팅
- 관련 문서
상세 내용
본문
Run a persistent OpenClaw Gateway on Upstash Box, a managed Linux environment with keep-alive lifecycle support.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
사전 요구사항
주요 항목:
- 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 (for example right-flamingo-14486) and your Box API key.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
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:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
ssh -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -L 18789:127.0.0.1:18789 <box-id>@us-east-1.box.upstash.com
Install OpenClaw
sudo npm install -g openclaw
Run onboarding
Follow the prompts. Copy the dashboard URL and token when onboarding finishes.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw onboard --install-daemon
Start the Gateway
Configure the Gateway for the Box network and start it in the background:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw config set gateway.bind lan
nohup openclaw gateway > gateway.log 2>&1 &
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:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
nohup openclaw gateway > gateway.log 2>&1 &
트러블슈팅
If SSH freezes during onboarding, reconnect with a clean SSH config and keepalives:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
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
관련 문서
주요 항목:
- Remote access
- Gateway security
- Updating OpenClaw
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/install/upstash - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
ssh -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -L 18789:127.0.0.1:18789 <box-id>@us-east-1.box.upstash.com
sudo npm install -g openclaw
openclaw onboard --install-daemon
openclaw config set gateway.bind lan
nohup openclaw gateway > gateway.log 2>&1 &
http://127.0.0.1:18789/#token=<your-token>
nohup openclaw gateway > gateway.log 2>&1 &
관련 링크
- 공식 원문: install/upstash
- OpenClaw 문서 홈
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.