ClawDock

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 路径重新安装。旧的原始 GitHub 路径已被移除。

功能介绍

基本操作

命令	描述
clawdock-start	启动网关
clawdock-stop	停止网关
clawdock-restart	重启网关
clawdock-status	检查容器状态
clawdock-logs	跟踪网关日志

容器访问

命令	描述
clawdock-shell	在网关容器内打开 shell
clawdock-cli <command>	在 Docker 中运行 OpenClaw CLI 命令
clawdock-exec <command>	在容器中执行任意命令

Web UI 和配对

命令	描述
clawdock-dashboard	打开控制 UI 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-start
clawdock-fix-token
clawdock-dashboard

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

clawdock-devices
clawdock-approve <request-id>

配置和密钥

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

• <project>/.env 用于 Docker 特定的值，如镜像名称、端口和网关令牌
• ~/.openclaw/.env 用于提供商密钥和机器人令牌
• ~/.openclaw/openclaw.json 用于行为配置

当您想要快速检查这些文件时，请使用 clawdock-show-config。它会在打印输出中编辑 .env 值。

相关页面

• Docker
• Docker VM Runtime
• 更新