메인 콘텐츠로 건너뛰기

​
Linux 서버

어떤 Linux 서버나 클라우드 VPS에서든 OpenClaw Gateway를 실행할 수 있습니다. 이 페이지에서는 provider를 선택하는 방법, 클라우드 배포가 어떻게 동작하는지, 그리고 어디서나 적용되는 일반적인 Linux 튜닝을 설명합니다.

​
provider 선택

Railway

원클릭, 브라우저 설정

Northflank

원클릭, 브라우저 설정

DigitalOcean

간단한 유료 VPS

Oracle Cloud

Always Free ARM 티어

Fly.io

Fly Machines

Hetzner

Hetzner VPS에서 Docker

Hostinger

원클릭 설정이 있는 VPS

GCP

Compute Engine

Azure

Linux VM

exe.dev

HTTPS 프록시가 있는 VM

Raspberry Pi

ARM 셀프 호스팅
AWS (EC2 / Lightsail / free tier) 도 잘 작동합니다. 커뮤니티 동영상 안내는 x.com/techfrenAJ/status/2014934471095812547 에서 볼 수 있습니다 (커뮤니티 자료이므로 사용할 수 없게 될 수 있습니다).

​
클라우드 설정이 작동하는 방식

  • Gateway는 VPS에서 실행되며 상태와 워크스페이스를 관리합니다.
  • 노트북이나 휴대폰에서 Control UI 또는 Tailscale/SSH 를 통해 연결합니다.
  • VPS를 신뢰할 수 있는 원본으로 간주하고 상태와 워크스페이스를 정기적으로 백업하세요.
  • 기본적으로 안전한 방식은 Gateway를 loopback에 유지하고 SSH 터널 또는 Tailscale Serve를 통해 접근하는 것입니다. lan 또는 tailnet에 바인드하는 경우 gateway.auth.token 또는 gateway.auth.password를 요구하세요.
관련 페이지: Gateway 원격 액세스, 플랫폼 허브.

​
VPS의 공용 회사 에이전트

모든 사용자가 동일한 신뢰 경계 안에 있고 에이전트가 업무 전용이라면, 팀을 위해 단일 에이전트를 실행하는 것은 유효한 설정입니다.
  • 전용 런타임(VPS/VM/컨테이너 + 전용 OS 사용자/계정)에서 유지하세요.
  • 해당 런타임을 개인 Apple/Google 계정이나 개인 브라우저/비밀번호 관리자 프로필에 로그인시키지 마세요.
  • 사용자들이 서로에게 적대적일 수 있다면 gateway/호스트/OS 사용자 단위로 분리하세요.
보안 모델 상세: 보안.

​
VPS와 함께 Node 사용하기

클라우드에 Gateway를 유지하면서 로컬 장치 (Mac/iOS/Android/headless)에서 Node 를 페어링할 수 있습니다. Node는 로컬 screen/camera/canvas와 system.run 기능을 제공하고, Gateway는 클라우드에 유지됩니다. 문서: Node, Node CLI.

​
소형 VM 및 ARM 호스트를 위한 시작 튜닝

저전력 VM(또는 ARM 호스트)에서 CLI 명령이 느리게 느껴진다면, Node의 module compile cache를 활성화하세요: 
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
  • NODE_COMPILE_CACHE는 반복 실행되는 명령의 시작 시간을 개선합니다.
  • OPENCLAW_NO_RESPAWN=1은 self-respawn 경로에서 발생하는 추가 시작 오버헤드를 피합니다.
  • 첫 번째 명령 실행은 캐시를 예열하며, 이후 실행은 더 빨라집니다.
  • Raspberry Pi 관련 세부 내용은 Raspberry Pi를 참고하세요.

​
systemd 튜닝 체크리스트 (선택 사항)

systemd를 사용하는 VM 호스트에서는 다음을 고려하세요:
  • 안정적인 시작 경로를 위해 서비스 환경 변수를 추가합니다:
    • OPENCLAW_NO_RESPAWN=1
    • NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
  • 재시작 동작을 명시적으로 유지합니다:
    • Restart=always
    • RestartSec=2
    • TimeoutStartSec=90
  • 상태/캐시 경로의 랜덤 I/O 콜드 스타트 페널티를 줄이기 위해 SSD 기반 디스크를 선호하세요.
표준 openclaw onboard --install-daemon 경로의 경우 사용자 유닛을 편집하세요: 
systemctl --user edit openclaw-gateway.service

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90
의도적으로 system unit을 설치한 경우에는 대신 sudo systemctl edit openclaw-gateway.service를 통해 openclaw-gateway.service를 편집하세요. Restart= 정책이 자동 복구에 도움이 되는 방식: systemd can automate service recovery.