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

이전에 scripts/shell-helpers/clawdock-helpers.sh에서 ClawDock을 설치했다면, 새 scripts/clawdock/clawdock-helpers.sh 경로에서 다시 설치하세요. 기존 원시 GitHub 경로는 제거되었습니다.

# 제공되는 기능

# 기본 작업

명령	설명
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-start
clawdock-fix-token
clawdock-dashboard

브라우저에서 페어링이 필요하다고 표시되면:

clawdock-devices
clawdock-approve <request-id>

# 구성 및 비밀

ClawDock은 Docker에 설명된 것과 동일한 Docker 구성 분리를 사용합니다.

• 이미지 이름, 포트, Gateway 토큰 같은 Docker 전용 값은 <project>/.env
• 환경 변수 기반 제공자 키와 봇 토큰은 ~/.openclaw/.env
• 저장된 제공자 OAuth/API 키 인증은 ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• 동작 구성은 ~/.openclaw/openclaw.json

.env 파일과 openclaw.json을 빠르게 검사하고 싶을 때 clawdock-show-config를 사용하세요. 출력된 결과에서 .env 값은 마스킹됩니다.

# 관련 항목