Containers
ClawDock
ClawDock 是用於 Docker 型 OpenClaw 安裝的小型 Shell 輔助工具層。
它讓你使用 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> |
在容器中執行任意命令 |
Web UI 與配對
| 命令 | 說明 |
|---|---|
clawdock-dashboard |
開啟控制介面 URL |
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：包含映像檔名稱、連接埠和OPENCLAW_GATEWAY_TOKEN等 Docker 專用值。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?
