古法编程

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 安装的双文件配置模式：

  • &lt;project&gt;/.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 中的值会自动脱敏）。

延伸阅读