OpenClaw ClawDock 설치 및 단축 명령어 가이드

매번 긴 Docker 명령어를 입력하느라 고생하고 계신가요? 컨테이너 이름을 일일이 기억하거나 복잡한 플래그를 조합하는 일은 개발 흐름을 방해하곤 하죠. 이런 번거로움을 줄이고 더 효율적으로 작업하고 싶은 분들을 위해 ClawDock을 소개할게요.

ClawDock

ClawDock은 Docker 기반 OpenClaw 설치를 위한 작은 shell-helper 레이어예요.

긴 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.sh
echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc

이전에 scripts/shell-helpers/clawdock-helpers.sh 경로에서 ClawDock을 설치했다면, 새로운 scripts/clawdock/clawdock-helpers.sh 경로로 다시 설치해 주세요. 기존의 raw GitHub 경로는 삭제되었어요.

제공되는 기능

기본 작업

명령어	설명
clawdock-start	Gateway 시작
clawdock-stop	Gateway 중지
clawdock-restart	Gateway 재시작
clawdock-status	컨테이너 상태 확인
clawdock-logs	Gateway 로그 확인 (follow)

컨테이너 접속

명령어	설명
clawdock-shell	Gateway 컨테이너 내부에서 shell 열기
clawdock-cli <command>	Docker 내에서 OpenClaw CLI 명령어 실행
clawdock-exec <command>	컨테이너 내에서 임의의 명령어 실행

웹 UI 및 페어링

명령어	설명
clawdock-dashboard	Control UI URL 열기
clawdock-devices	대기 중인 장치 페어링 목록 확인
clawdock-approve <id>	페어링 요청 승인

설정 및 유지보수

명령어	설명
clawdock-fix-token	컨테이너 내부의 Gateway 토큰 설정
clawdock-update	Pull, rebuild 및 재시작
clawdock-rebuild	Docker 이미지 빌드만 수행
clawdock-clean	컨테이너 및 볼륨 삭제

유틸리티

명령어	설명
clawdock-health	Gateway 상태 점검 실행
clawdock-token	Gateway 토큰 출력
clawdock-cd	OpenClaw 프로젝트 디렉토리로 이동
clawdock-config	~/.openclaw 열기
clawdock-show-config	민감한 정보를 가린 상태로 설정 파일 출력
clawdock-workspace	workspace 디렉토리 열기

처음 시작하기

clawdock-start
clawdock-fix-token
clawdock-dashboard

브라우저에서 페어링이 필요하다고 표시되면 다음 명령어를 사용하세요:

clawdock-devices
clawdock-approve <request-id>

설정 및 시크릿

ClawDock은 Docker 문서에서 설명한 것과 동일한 Docker 설정 분할 방식을 사용해요:

• <project>/.env: 이미지 이름, 포트, Gateway 토큰 같은 Docker 전용 값
• ~/.openclaw/.env: provider 키 및 봇 토큰
• ~/.openclaw/openclaw.json: 동작 설정

이 파일들을 빠르게 확인하고 싶을 때는 clawdock-show-config를 사용해 보세요. 출력 결과에서 .env의 민감한 값들은 자동으로 가려져서 보여요.

관련 문서

• Docker
• Docker VM Runtime
• Updating

다음 단계

• Docker 설정 가이드 확인하기
• 최신 버전으로 업데이트하는 방법

설정 중에 도움이 필요하다면 AI Setup Assistant에게 물어보세요!