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.sh
echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc

如果你之前从 scripts/shell-helpers/clawdock-helpers.sh 安装了 ClawDock，请从新的 scripts/clawdock/clawdock-helpers.sh 路径重新安装。旧的 raw GitHub 路径已被移除。

# 你会获得什么

# 基本操作

命令	说明
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 网关令牌
clawdock-update	拉取、重新构建并重启
clawdock-rebuild	仅重新构建 Docker 镜像
clawdock-clean	移除容器和卷

# 实用工具

命令	说明
clawdock-health	运行 Gateway 网关健康检查
clawdock-token	打印 Gateway 网关令牌
clawdock-cd	跳转到 OpenClaw 项目目录
clawdock-config	打开 ~/.openclaw
clawdock-show-config	打印配置文件并隐藏敏感值
clawdock-workspace	打开工作区目录

# 首次流程

clawdock-start
clawdock-fix-token
clawdock-dashboard

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

clawdock-devices
clawdock-approve <request-id>

# 配置和密钥

ClawDock 使用与 Docker 中描述的相同 Docker 配置拆分：

• <project>/.env 用于 Docker 专用值，例如镜像名称、端口和 Gateway 网关令牌
• ~/.openclaw/.env 用于由环境变量支持的提供商密钥和机器人令牌
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json 用于存储的提供商 OAuth/API key 凭证
• ~/.openclaw/openclaw.json 用于行为配置

当你想快速检查 .env 文件和 openclaw.json 时，请使用 clawdock-show-config。它会在打印输出中隐藏 .env 值。

# 相关