Containers
ClawDock
ClawDock은 Docker 기반 OpenClaw 설치를 위한 소규모 셸 도우미 계층입니다.
긴 docker compose ... 호출 대신 clawdock-start, clawdock-dashboard, clawdock-fix-token 같은 짧은 명령을 사용할 수 있습니다.
아직 Docker를 설정하지 않았다면 Docker부터 시작하세요.
설치
mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.shecho 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc이전에 scripts/shell-helpers/clawdock-helpers.sh에서 ClawDock을 설치했다면 현재 경로인 scripts/clawdock/clawdock-helpers.sh에서 다시 설치하세요. 이전 GitHub 원시 파일 경로는 삭제되었습니다.
도우미는 처음 사용할 때 OpenClaw 체크아웃을 자동으로 감지하고(~/openclaw, ~/projects/openclaw 같은 일반적인 경로 확인) 결과를 ~/.clawdock/config에 캐시합니다. 체크아웃이 다른 위치에 있다면 CLAWDOCK_DIR을 직접 설정하세요.
제공 기능
기본 작업
| 명령 | 설명 |
|---|---|
clawdock-start |
Gateway 시작 |
clawdock-stop |
Gateway 중지 |
clawdock-restart |
Gateway 다시 시작 |
clawdock-status |
컨테이너 상태 확인 |
clawdock-logs |
Gateway 로그 실시간 확인 |
컨테이너 접근
| 명령 | 설명 |
|---|---|
clawdock-shell |
Gateway 컨테이너 내부에서 셸 열기 |
clawdock-cli <command> |
Docker에서 OpenClaw CLI 명령 실행 |
clawdock-exec <command> |
컨테이너에서 임의의 명령 실행 |
웹 UI 및 페어링
| 명령 | 설명 |
|---|---|
clawdock-dashboard |
제어 UI URL 열기 |
clawdock-devices |
대기 중인 기기 페어링 목록 표시 |
clawdock-approve <id> |
페어링 요청 승인 |
설정 및 유지보수
| 명령 | 설명 |
|---|---|
clawdock-fix-token |
컨테이너 구성에 Gateway 토큰 쓰기 |
clawdock-update |
가져오기, 다시 빌드 및 다시 시작 |
clawdock-rebuild |
Docker 이미지만 다시 빌드 |
clawdock-clean |
컨테이너 및 볼륨 제거 |
유틸리티
| 명령 | 설명 |
|---|---|
clawdock-health |
Gateway 상태 검사 실행 |
clawdock-token |
Gateway 토큰 출력 |
clawdock-cd |
OpenClaw 프로젝트 디렉터리로 이동 |
clawdock-config |
~/.openclaw 열기 |
clawdock-show-config |
민감한 값을 가린 구성 파일 출력 |
clawdock-workspace |
작업 공간 디렉터리 열기 |
clawdock-help |
모든 ClawDock 명령 목록 표시 |
최초 실행 절차
clawdock-startclawdock-fix-tokenclawdock-dashboard브라우저에 페어링이 필요하다고 표시되면 다음을 실행하세요.
clawdock-devicesclawdock-approve <request-id>구성 및 비밀 정보
ClawDock은 Docker에 설명된 분리 방식에 따라 두 개의 별도 .env 파일을 읽습니다.
docker-compose.yml옆에 있는 프로젝트.env: 이미지 이름, 포트,OPENCLAW_GATEWAY_TOKEN같은 Docker 전용 값입니다.clawdock-token은 여기에서 토큰을 읽습니다.~/.openclaw/.env(컨테이너에 마운트됨):openclaw.json및agents/<agentId>/agent/auth-profiles.json과 함께 OpenClaw 자체에서 관리하는 환경 변수 기반 비밀 정보입니다.
clawdock-fix-token은 프로젝트 .env의 토큰을 컨테이너의 gateway.remote.token 및 gateway.auth.token 구성 값에 복사하고 Gateway를 다시 시작합니다.
clawdock-show-config를 사용하면 openclaw.json과 두 .env 파일을 빠르게 확인할 수 있습니다. 출력할 때 .env 값은 가려집니다.
