clawdock-start、clawdock-dashboard 和 clawdock-fix-token 這樣的短指令，取代較長的 docker compose ... 呼叫。
如果你尚未設定 Docker，請先從 Docker 開始。
安裝
scripts/shell-helpers/clawdock-helpers.sh 安裝 ClawDock，請從目前的 scripts/clawdock/clawdock-helpers.sh 路徑重新安裝；舊的 GitHub raw 路徑已移除。
這些輔助工具會在首次使用時自動偵測你的 OpenClaw checkout（檢查常見路徑，例如 ~/openclaw、~/projects/openclaw），並將結果快取在 ~/.clawdock/config。如果你的 checkout 位於其他位置，請自行設定 CLAWDOCK_DIR。
你會得到什麼
基本操作
| 指令 | 說明 |
|---|---|
clawdock-start | 啟動閘道 |
clawdock-stop | 停止閘道 |
clawdock-restart | 重新啟動閘道 |
clawdock-status | 檢查容器狀態 |
clawdock-logs | 追蹤閘道日誌 |
容器存取
| 指令 | 說明 |
|---|---|
clawdock-shell | 在閘道容器內開啟 shell |
clawdock-cli <command> | 在 Docker 中執行 OpenClaw 命令列介面指令 |
clawdock-exec <command> | 在容器中執行任意指令 |
Web 介面與配對
| 指令 | 說明 |
|---|---|
clawdock-dashboard | 開啟 Control UI URL |
clawdock-devices | 列出待處理的裝置配對 |
clawdock-approve <id> | 核准配對請求 |
設定與維護
| 指令 | 說明 |
|---|---|
clawdock-fix-token | 將閘道 token 寫入容器設定 |
clawdock-update | 拉取、重新建置並重新啟動 |
clawdock-rebuild | 只重新建置 Docker 映像 |
clawdock-clean | 移除容器與 volume |
工具
| 指令 | 說明 |
|---|---|
clawdock-health | 執行閘道健康檢查 |
clawdock-token | 印出閘道 token |
clawdock-cd | 跳至 OpenClaw 專案目錄 |
clawdock-config | 開啟 ~/.openclaw |
clawdock-show-config | 印出已遮蔽值的設定檔 |
clawdock-workspace | 開啟工作區目錄 |
clawdock-help | 列出所有 ClawDock 指令 |
首次使用流程
設定與密鑰
ClawDock 會讀取兩個獨立的.env 檔案，對應 Docker 中描述的分工：
- 專案中位於
docker-compose.yml旁的.env：Docker 專用值，例如映像名稱、連接埠和OPENCLAW_GATEWAY_TOKEN。clawdock-token會從這裡讀取 token。 ~/.openclaw/.env（掛載到容器中）：OpenClaw 自身管理、由環境變數支援的密鑰，與openclaw.json和agents/<agentId>/agent/auth-profiles.json並存。
clawdock-fix-token 會將 token 從專案 .env 複製到容器的 gateway.remote.token 和 gateway.auth.token 設定值，並重新啟動閘道。
使用 clawdock-show-config 可快速檢查 openclaw.json 和兩個 .env 檔案；它會在印出的輸出中遮蔽 .env 的值。
相關
Docker
OpenClaw 的標準 Docker 安裝。
Docker VM runtime
由 Docker 管理的 VM 執行階段，用於強化隔離。
Updating
更新 OpenClaw 套件與受管理服務。