Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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>

​
配置与 secrets

ClawDock 使用与 Docker 中描述相同的 Docker 配置拆分：
  • <project>/.env 用于 Docker 专用值，例如镜像名称、端口和 Gateway 网关令牌
  • ~/.openclaw/.env 用于基于环境变量的提供商 key 和 bot token
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json 用于存储提供商 OAuth / API-key 认证
  • ~/.openclaw/openclaw.json 用于行为配置
当你想快速检查 .env 文件和 openclaw.json 时，请使用 clawdock-show-config。它会在打印输出中隐藏 .env 值。

​
相关页面