ClawDock
ClawDock은 Docker 기반 OpenClaw 설치를 위한 작은 셸 헬퍼 계층입니다. 긴docker compose ... 호출 대신 clawdock-start, clawdock-dashboard, clawdock-fix-token 같은 짧은 명령을 제공합니다.
아직 Docker를 설정하지 않았다면 먼저 Docker에서 시작하세요.
설치
정식 헬퍼 경로를 사용하세요.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 로그 따라가기 |
컨테이너 액세스
| 명령 | 설명 |
|---|---|
clawdock-shell | gateway 컨테이너 안에서 셸 열기 |
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 | 가져오기, 재빌드, 재시작 |
clawdock-rebuild | Docker 이미지만 재빌드 |
clawdock-clean | 컨테이너와 볼륨 제거 |
유틸리티
| 명령 | 설명 |
|---|---|
clawdock-health | gateway 상태 점검 실행 |
clawdock-token | gateway 토큰 출력 |
clawdock-cd | OpenClaw 프로젝트 디렉터리로 이동 |
clawdock-config | ~/.openclaw 열기 |
clawdock-show-config | 값이 마스킹된 config 파일 출력 |
clawdock-workspace | 워크스페이스 디렉터리 열기 |
첫 실행 흐름
Config 및 시크릿
ClawDock은 Docker에 설명된 것과 동일한 Docker config 분리를 사용합니다.- 이미지 이름, 포트, gateway 토큰 같은 Docker 전용 값용
<project>/.env - env 기반 provider 키와 봇 토큰용
~/.openclaw/.env - 저장된 provider OAuth/API 키 auth용
~/.openclaw/agents/<agentId>/agent/auth-profiles.json - 동작 config용
~/.openclaw/openclaw.json
.env 파일과 openclaw.json을 빠르게 확인하고 싶다면 clawdock-show-config를 사용하세요. 출력 시 .env 값은 마스킹됩니다.