clawdock-start、clawdock-dashboard 和 clawdock-fix-token 等短命令，替代更长的 docker compose ... 调用。
如果你尚未设置 Docker，请从 Docker 开始。
安装
scripts/shell-helpers/clawdock-helpers.sh 安装过 ClawDock，请从当前的 scripts/clawdock/clawdock-helpers.sh 路径重新安装；旧的 raw GitHub 路径已被移除。
这些辅助命令会在首次使用时自动检测你的 OpenClaw 检出目录（检查 ~/openclaw、~/projects/openclaw 等常见路径），并将结果缓存到 ~/.clawdock/config。如果你的检出目录位于其他位置，请自行设置 CLAWDOCK_DIR。
你会获得什么
基本操作
| 命令 | 说明 |
|---|---|
clawdock-start | 启动 Gateway 网关 |
clawdock-stop | 停止 Gateway 网关 |
clawdock-restart | 重启 Gateway 网关 |
clawdock-status | 检查容器状态 |
clawdock-logs | 跟踪 Gateway 网关日志 |
容器访问
| 命令 | 说明 |
|---|---|
clawdock-shell | 在 Gateway 网关容器内打开 shell |
clawdock-cli <command> | 在 Docker 中运行 OpenClaw CLI 命令 |
clawdock-exec <command> | 在容器中执行任意命令 |
Web UI 和配对
| 命令 | 说明 |
|---|---|
clawdock-dashboard | 打开 Control UI 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 | 打开工作区目录 |
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 配置值中，并重启 Gateway 网关。
使用 clawdock-show-config 可以快速检查 openclaw.json 和两个 .env 文件；它会在打印输出中遮盖 .env 值。
相关内容
Docker
OpenClaw 的规范 Docker 安装方式。
Docker VM 运行时
由 Docker 管理的 VM 运行时，用于强化隔离。
更新
更新 OpenClaw 包和托管服务。