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`	启动网关
`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/agents/<agentId>/agent/auth-profiles.json 用于存储的提供商 OAuth/API 密钥认证
~/.openclaw/openclaw.json 用于行为配置

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