ClawDock

ClawDock 是专为 Docker 部署 OpenClaw 设计的 Shell 辅助工具层，让你用短命令代替冗长的 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-start	启动 Gateway
clawdock-stop	停止 Gateway
clawdock-restart	重启 Gateway
clawdock-status	检查容器状态
clawdock-logs	实时跟踪日志

容器访问

命令	说明
clawdock-shell	进入 Gateway 容器 Shell
clawdock-cli <command>	在 Docker 内运行 OpenClaw CLI
clawdock-exec <command>	在容器内执行任意命令

Web UI 与配对

命令	说明
clawdock-dashboard	打开控制台 URL
clawdock-devices	列出待审批设备配对
clawdock-approve <id>	批准指定配对请求

设置与维护

命令	说明
clawdock-fix-token	在容器内配置 Gateway Token
clawdock-update	拉取更新、重建镜像并重启
clawdock-rebuild	仅重建 Docker 镜像
clawdock-clean	删除容器和卷

实用工具

命令	说明
clawdock-health	运行 Gateway 健康检查
clawdock-token	打印 Gateway Token
clawdock-cd	跳转到 OpenClaw 项目目录
clawdock-config	打开 ~/.openclaw 目录
clawdock-show-config	打印脱敏后的配置文件内容
clawdock-workspace	打开 Workspace 目录

首次配置流程

clawdock-start
clawdock-fix-token
clawdock-dashboard

如果浏览器提示需要配对：

clawdock-devices
clawdock-approve <request-id>

配置与密钥

ClawDock 沿用 Docker 安装的双文件配置模式：

• <project>/.env：Docker 专用配置（镜像名、端口、Gateway Token）
• ~/.openclaw/.env：Provider API Key、Bot Token 等环境变量
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json：存储的 Provider OAuth/API Key
• ~/.openclaw/openclaw.json：行为配置

使用 clawdock-show-config 可快速查看 .env 和 openclaw.json 内容（.env 中的值会自动脱敏）。

延伸阅读

• Docker 安装
• Docker VM Runtime
• 更新 OpenClaw