EasyRunner

EasyRunner는 Caddy 프록시 뒤에서 작은 컨테이너화된 앱으로 OpenClaw Gateway를 호스팅할 수 있습니다. 이 가이드는 Podman 호환 Compose 앱을 실행하고 Caddy를 통해 HTTPS를 노출하는 EasyRunner 호스트를 가정합니다.

시작하기 전에

• 도메인이 라우팅된 EasyRunner 서버.
• 빌드되었거나 게시된 OpenClaw 컨테이너 이미지.
• /home/node/.openclaw용 영구 설정 볼륨.
• /workspace용 영구 작업 공간 볼륨.
• 강력한 Gateway 토큰 또는 비밀번호.

가능하면 기기 인증을 활성화해 두세요. 리버스 프록시 배포가 기기 ID를 올바르게 전달할 수 없다면 먼저 신뢰할 수 있는 프록시 설정을 수정하세요. 위험한 인증 우회는 완전히 비공개이고 운영자가 제어하는 네트워크에서만 사용하세요.

Compose 앱

다음과 같은 형태의 Compose 파일로 EasyRunner 앱을 만드세요.

services:  openclaw:    image: ghcr.io/openclaw/openclaw:latest    restart: unless-stopped    environment:      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}      OPENCLAW_HOME: /home/node      OPENCLAW_STATE_DIR: /home/node/.openclaw      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json      OPENCLAW_WORKSPACE_DIR: /workspace    volumes:      - openclaw-config:/home/node/.openclaw      - openclaw-workspace:/workspace    labels:      caddy: openclaw.example.com      caddy.reverse_proxy: "{{upstreams 1455}}"    command: ["openclaw", "gateway", "--bind", "lan", "--port", "1455"] volumes:  openclaw-config:  openclaw-workspace:

openclaw.example.com을 Gateway 호스트 이름으로 바꾸세요. OPENCLAW_GATEWAY_TOKEN은 앱 정의에 커밋하지 말고 EasyRunner의 시크릿/환경 관리자에 저장하세요.

OpenClaw 구성

영구 설정 볼륨 안에서는 Gateway가 프록시를 통해서만 도달 가능하게 유지하고 인증을 요구하세요.

{  gateway: {    bind: "lan",    port: 1455,    auth: {      token: "${OPENCLAW_GATEWAY_TOKEN}",    },  },}

Caddy가 Gateway의 TLS를 종료하는 경우, 인증 검사를 전역으로 비활성화하지 말고 정확한 프록시 경로에 대해 신뢰할 수 있는 프록시 설정을 구성하세요. 신뢰할 수 있는 프록시 인증을 참조하세요.

확인

작업용 컴퓨터에서:

openclaw gateway probe --url https://openclaw.example.com --token <token>openclaw gateway status --url https://openclaw.example.com --token <token>

EasyRunner 호스트에서 앱 로그를 확인하여 Gateway가 수신 중이고 시작 시 SecretRef, Plugin 또는 채널 인증 실패가 없는지 확인하세요.

업데이트 및 백업

• 새 OpenClaw 이미지를 가져오거나 빌드한 다음 EasyRunner 앱을 다시 배포하세요.
• 업데이트 전에 openclaw-config 볼륨을 백업하세요.
• 에이전트가 지속 가능한 프로젝트 데이터를 openclaw-workspace에 쓰는 경우 이를 백업하세요.
• 주요 업데이트 후에는 openclaw doctor를 실행하여 설정 마이그레이션과 서비스 경고를 확인하세요.

문제 해결

• gateway probe가 연결할 수 없음: Caddy 호스트 이름이 앱을 가리키고 컨테이너가 0.0.0.0:1455에서 수신하는지 확인하세요.
• 인증 실패: EasyRunner 시크릿의 토큰과 로컬 클라이언트 명령을 함께 교체하세요.
• 복원 후 파일이 root 소유임: 컨테이너 사용자가 /home/node/.openclaw와 /workspace에 쓸 수 있도록 마운트된 볼륨을 수정하세요.
• 브라우저 또는 채널 Plugin 실패: 필요한 외부 바이너리, 네트워크 송신, 마운트된 자격 증명을 컨테이너 내부에서 사용할 수 있는지 확인하세요.