Skip to main content
GCP, Hetzner 및 유사한 VPS 제공업체의 VM 기반 Docker 설치에 공통으로 적용되는 런타임 단계입니다.

필수 바이너리를 이미지에 포함하기

실행 중인 컨테이너 내부에 바이너리를 설치하면 문제가 발생합니다. 런타임에 설치한 모든 항목은 재시작하면 사라집니다. Skills에 필요한 모든 외부 바이너리를 빌드 시 이미지에 포함하세요. 아래 예시에서는 알파벳순으로 세 가지 바이너리만 다룹니다.
  • Gmail 액세스용 gog(gogcli에서 제공)
  • Google Places용 goplaces
  • WhatsApp용 wacli
이는 예시일 뿐이며 전체 목록이 아닙니다. 동일한 패턴을 사용하여 Skills에 필요한 만큼 바이너리를 설치하세요. 나중에 새 바이너리가 필요한 Skills를 추가하는 경우:
  1. Dockerfile을 업데이트합니다.
  2. 이미지를 다시 빌드합니다.
  3. 컨테이너를 재시작합니다.
Dockerfile 예시
위 URL은 예시입니다. ARM 기반 VM에서는 arm64 자산을 선택하세요. 재현 가능한 빌드를 위해 버전이 지정된 릴리스 URL을 고정하세요.

빌드 및 실행

pnpm install --frozen-lockfile 실행 중 빌드가 Killed 메시지 또는 종료 코드 137과 함께 실패하면 VM의 메모리가 부족한 것입니다. 다시 시도하기 전에 더 큰 머신 클래스를 사용하세요. 바이너리를 확인합니다.
예상 출력:
Gateway가 실행 중인지 확인합니다.
/healthz가 200 응답을 반환하면 Gateway 프로세스가 요청을 수신 중이며 정상 상태임을 의미합니다. 이미지에 내장된 HEALTHCHECK도 동일한 엔드포인트를 폴링합니다.

항목별 영구 저장 위치

OpenClaw는 Docker에서 실행되지만, Docker가 기준 데이터 원본은 아닙니다. 모든 장기 상태는 재시작, 재빌드 및 재부팅 후에도 유지되어야 합니다.

업데이트

VM에서 OpenClaw를 업데이트하려면:

관련 문서