Containers
ClawDock
ClawDock 是一層小型 Shell 輔助工具，適用於以 Docker 為基礎的 OpenClaw 安裝。
它提供 clawdock-start、clawdock-dashboard 和 clawdock-fix-token 等簡短命令，取代較長的 docker compose ... 呼叫。
如果尚未設定 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 |
啟動閘道 |
clawdock-stop |
停止閘道 |
clawdock-restart |
重新啟動閘道 |
clawdock-status |
檢查容器狀態 |
clawdock-logs |
持續追蹤閘道日誌 |
容器存取
| 命令 | 說明 |
|---|---|
clawdock-shell |
在閘道容器內開啟 Shell |
clawdock-cli <command> |
在 Docker 中執行 OpenClaw 命令列介面命令 |
clawdock-exec <command> |
在容器中執行任意命令 |
網頁介面與配對
| 命令 | 說明 |
|---|---|
clawdock-dashboard |
開啟控制介面網址 |
clawdock-devices |
列出待處理的裝置配對 |
clawdock-approve <id> |
核准配對請求 |
設定與維護
| 命令 | 說明 |
|---|---|
clawdock-fix-token |
將閘道權杖寫入容器設定 |
clawdock-update |
提取、重新建置並重新啟動 |
clawdock-rebuild |
僅重新建置 Docker 映像 |
clawdock-clean |
移除容器與磁碟區 |
公用工具
| 命令 | 說明 |
|---|---|
clawdock-health |
執行閘道健康狀態檢查 |
clawdock-token |
輸出閘道權杖 |
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 會讀取兩個獨立的 .env 檔案，與 Docker 中說明的分離方式一致：
- 位於
docker-compose.yml旁的專案.env：包含 Docker 專用值，例如映像名稱、連接埠和OPENCLAW_GATEWAY_TOKEN。clawdock-token會從此處讀取權杖。 ~/.openclaw/.env（掛載至容器中）：OpenClaw 本身管理且由環境變數提供的密鑰，與openclaw.json和agents/<agentId>/agent/auth-profiles.json放在一起。
clawdock-fix-token 會將權杖從專案 .env 複製到容器的 gateway.remote.token 與 gateway.auth.token 設定值，然後重新啟動閘道。
使用 clawdock-show-config 可快速檢查 openclaw.json 和兩個 .env 檔案；它會在輸出內容中遮蔽 .env 的值。
相關內容
Was this useful?
