knowhunters/clawdeckx

ClawDeckX Docker镜像文档

镜像概述和主要用途

ClawDeckX是一款为https://github.com/openclaw/openclaw%E6%89%93%E9%80%A0%E7%9A%84%E5%BC%80%E6%BA%90Web%E5%8F%AF%E8%A7%86%E5%8C%96%E7%AE%A1%E7%90%86%E5%B9%B3%E5%8F%B0%E3%80%82%E5%85%B6%E6%A0%B8%E5%BF%83%E7%9B%AE%E6%A0%87%E6%98%AF%E9%99%8D%E4%BD%8EOpenClaw%E7%9A%84%E4%BD%BF%E7%94%A8%E9%97%A8%E6%A7%9B%EF%BC%8C%E9%80%9A%E8%BF%87%E7%9B%B4%E8%A7%82%E7%9A%84%E7%95%8C%E9%9D%A2%E7%AE%80%E5%8C%96%E5%AE%89%E8%A3%85%E3%80%81%E9%85%8D%E7%BD%AE%E3%80%81%E7%9B%91%E6%8E%A7%E5%92%8C%E4%BC%98%E5%8C%96%E6%B5%81%E7%A8%8B%EF%BC%8C%E4%B8%BA%E5%85%A8%E7%90%83%E7%94%A8%E6%88%B7%EF%BC%88%E5%B0%A4%E5%85%B6%E6%98%AF%E5%88%9D%E5%AD%A6%E8%80%85%EF%BC%89%E6%8F%90%E4%BE%9B%E6%9B%B4%E5%8F%8B%E5%A5%BD%E7%9A%84%E4%B8%8A%E6%89%8B%E4%BD%93%E9%AA%8C%E3%80%82

⚠️ 注意：当前版本为Beta预览版，尚未经过全面测试，请勿在生产环境中使用。

核心功能和特性

macOS级视觉体验

• 忠实还原macOS设计语言，包含精致的玻璃态效果、圆角卡片和流畅的动画过渡
• 管理AI代理如同使用原生桌面应用般自然直观

初学者友好设置

• 引导式向导和预构建模板，无需记忆命令即可完成OpenClaw初始配置和模型设置

深度配置能力

• 可视化编辑器支持微调OpenClaw所有参数：模型切换、内存管理、插件加载、通道路由等

实时可观测性

• 内置监控仪表盘，提供实时执行状态、资源消耗和任务历史，全面掌握每个代理行为

跨平台兼容性

• 单容器部署，支持多架构（amd64/arm64），兼容Windows、macOS（Intel/Apple Silicon）和Linux系统

响应式设计

• 全响应式布局，无缝适配从桌面显示器到平板和手机的各种设备，移动管理无功能妥协

多语言支持

• 完整国际化架构，内置13种语言，新增语言仅需翻译JSON文件和两行代码变更

本地与远程网关管理

• 无缝管理本地和远程OpenClaw网关，一键切换网关配置文件，适合开发、测试、生产等多环境设置

使用场景和适用范围

本地部署（推荐）

• 将ClawDeckX与OpenClaw安装在同一服务器，获得完整功能访问和直接命令执行能力
• 优势：全功能支持、低延迟、无网络依赖

远程网关管理

• 在本地机器安装ClawDeckX，通过WebSocket连接远程OpenClaw实例
• 限制：部分需直接命令执行的功能不可用，依赖稳定网络连接，操作延迟略高

适用用户

• OpenClaw初学者：通过可视化界面快速入门，无需命令行操作
• AI代理管理员：实时监控和管理多个代理的运行状态
• 多环境维护者：便捷切换开发、测试和生产环境的OpenClaw配置

详细使用方法和配置说明

Docker安装

推荐安装方式

使用一键安装脚本，选择Docker部署选项，自动处理下载、端口配置、镜像检测和凭据显示。

手动安装

1. 下载docker-compose配置文件：

bash
curl -fsSL https://raw.githubusercontent.com/ClawDeckX/ClawDeckX/main/docker-compose.yml -o docker-compose.yml

2. 启动容器：

bash
docker compose up -d

3. 更新镜像后重建容器（应用Dockerfile和入口点变更）：

bash
docker compose up -d --force-recreate

4. 访问Web界面：

• Docker部署：http://localhost:18700
• 首次运行将自动生成管理员账户，凭据显示在容器日志中：

bash
docker logs clawdeckx

Docker配置详情

端口映射

若需暴露网关端口，在docker-compose.yml的ports部分添加- "18789:18789"。注意：默认网关绑定到回环地址，需调整网关配置才能从外部访问。

环境变量

预装运行时工具

Docker镜像包含以下工具，确保多数OpenClaw技能可开箱即用：

• go
• python3
• uv
• ffmpeg
• jq
• ripgrep
• wget
• make

数据卷

提示：OpenClaw已预安装在镜像中，其配置通过Docker卷持久化。更新镜像并重建容器后，OpenClaw配置将保留。

容器健康检查与诊断

• 健康检查：通过/api/v1/health端点检查存活状态
• 详细诊断：访问/api/v1/health?detailed=true查看ClawDeckX、OpenClaw、网关和引导状态

资源限制

默认docker-compose.yml设置内存限制为2GB，CPU限制为2核，可通过调整deploy.resources.limits修改：

yaml
deploy:
  resources:
    limits:
      cpus: '2'
      memory: 2G

CLI命令

容器内支持以下ClawDeckX命令：

忘记凭据？ 运行docker exec -it clawdeckx ClawDeckX list-users查找用户名，然后docker exec -it clawdeckx ClawDeckX reset-password <username> <new_password>重置密码。密码包含特殊字符时需用单引号包裹：`ClawDeckX reset-password admin 'P@ss!w0rd#。

账户锁定：连续5次登录失败后，账户自动锁定15分钟。立即解锁：docker exec -it clawdeckx ClawDeckX unlock <username>。

安全提醒：首次运行未指定--user和--pass时，自动生成的管理员凭据将打印到控制台。登录后请立即在设置页面修改用户名和密码。`。

账户锁定：连续5次登录失败后，账户自动锁定15分钟。立即解锁：CODE_TOKEN_60。

安全提醒：首次运行未指定__CODE_TOKEN_61__和__CODE_TOKEN_62__时，自动生成的管理员凭据将打印到控制台。登录后请立即在设置页面修改用户名和密码。