> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ClawDock

ClawDock 是一个用于基于 Docker 的 OpenClaw 安装的小型 shell 辅助层。

它提供 `clawdock-start`、`clawdock-dashboard` 和 `clawdock-fix-token` 等短命令，替代更长的 `docker compose ...` 调用。

如果你尚未设置 Docker，请从 [Docker](/zh-CN/install/docker) 开始。

## 安装

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 路径已被移除。

这些辅助命令会在首次使用时自动检测你的 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 命令    |

## 首次使用流程

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawdock-start
clawdock-fix-token
clawdock-dashboard
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawdock-devices
clawdock-approve <request-id>
```

## 配置和密钥

ClawDock 会读取两个独立的 `.env` 文件，与 [Docker](/zh-CN/install/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` 值。

## 相关内容

<CardGroup cols={2}>
  <Card title="Docker" href="/zh-CN/install/docker" icon="docker">
    OpenClaw 的规范 Docker 安装方式。
  </Card>

  <Card title="Docker VM 运行时" href="/zh-CN/install/docker-vm-runtime" icon="cube">
    由 Docker 管理的 VM 运行时，用于强化隔离。
  </Card>

  <Card title="更新" href="/zh-CN/install/updating" icon="arrow-up-right-from-square">
    更新 OpenClaw 包和托管服务。
  </Card>
</CardGroup>