Hetzner

기준일: 2026-07-26
공식 기준: Hetzner

Hetzner 문서는 OpenClaw 공식 문서(install/hetzner)를 한국어로 정리한 가이드입니다. Run OpenClaw Gateway 24/7 on a cheap Hetzner VPS (Docker) with durable state and baked-in binaries 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Run OpenClaw Gateway 24/7 on a cheap Hetzner VPS (Docker) with durable state and baked-in binaries

한국어 가이드 범위: install/hetzner 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• What you need
• Quick path
• Infrastructure as Code (Terraform)
• 다음 단계
• 관련 문서

상세 내용

본문

Run a persistent OpenClaw Gateway on a Hetzner VPS using Docker, with durable state, baked-in binaries, and safe restart behavior.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Company-shared agents are fine when everyone is in the same trust boundary and the runtime is business-only.
• Keep strict separation: dedicated VPS/runtime + dedicated accounts; no personal Apple/Google/browser/password-manager profiles on that host.
• If users are adversarial to each other, split by gateway/host/OS user.

What you need

주요 항목:

• Hetzner VPS with root access
• SSH access from your laptop
• Docker and Docker Compose
• Model auth credentials
• Optional provider credentials (WhatsApp QR, Telegram bot token, Gmail OAuth)
• ~20 minutes

Quick path

1. Provision Hetzner VPS 2. Install Docker 3. Clone the OpenClaw repository 4. Create persistent host directories 5. Configure .env and docker-compose.yml 6. Bake required binaries into the image 7. docker compose up -d 8. Verify persistence and Gateway access

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• .env
• HOME=/home/node
• NODE_ENV=production
• TERM=xterm-256color
• OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}
• OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}
• OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
• GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}
• XDG_CONFIG_HOME=${XDG_CONFIG_HOME}
• PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
• ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
• ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
• "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"
• Bake required binaries into the image
• Build and launch
• What persists where
• Updates

ssh root@YOUR_VPS_IP

apt-get update
    apt-get install -y git curl ca-certificates
    curl -fsSL https://get.docker.com | sh

docker --version
    docker compose version

git clone https://github.com/openclaw/openclaw.git
    cd openclaw

Infrastructure as Code (Terraform)

For teams preferring infrastructure-as-code workflows, a community-maintained Terraform setup provides:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Modular Terraform configuration with remote state management
• Automated provisioning via cloud-init
• Deployment scripts (bootstrap, deploy, backup/restore)
• Security hardening (firewall, UFW, SSH-only access)
• SSH tunnel configuration for gateway access
• Infrastructure: openclaw-terraform-hetzner
• Docker config: openclaw-docker-config

다음 단계

주요 항목:

• Set up messaging channels: Channels
• Configure the Gateway: Gateway configuration
• Keep OpenClaw up to date: Updating

관련 문서

주요 항목:

• Install overview
• Fly.io
• Docker
• VPS hosting

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/install/hetzner
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

ssh root@YOUR_VPS_IP

apt-get update
    apt-get install -y git curl ca-certificates
    curl -fsSL https://get.docker.com | sh

docker --version
    docker compose version

git clone https://github.com/openclaw/openclaw.git
    cd openclaw

mkdir -p /root/.openclaw/workspace

    # Set ownership to the container user (uid 1000):
    chown -R 1000:1000 /root/.openclaw

OPENCLAW_IMAGE=openclaw:latest
    OPENCLAW_GATEWAY_TOKEN=
    OPENCLAW_GATEWAY_BIND=lan
    OPENCLAW_GATEWAY_PORT=18789

    OPENCLAW_CONFIG_DIR=/root/.openclaw
    OPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace

    GOG_KEYRING_PASSWORD=
    XDG_CONFIG_HOME=/home/node/.openclaw

관련 링크

• 공식 원문: install/hetzner
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.