ClawdBot保姆级部署指南：从Docker启动到Telegram机器人上线

1. 项目概述

ClawdBot是一个基于vllm后端的个人AI助手，可以轻松部署在本地设备上。它源自MoltBot项目——一个开源的"多语言、多平台、零配置"Telegram翻译机器人。这个工具能够实时翻译100+种语言，支持群聊自动识别、语音转写、图片OCR翻译，并内置汇率、天气、维基百科快捷查询功能。

1.1 核心功能亮点

• 实时翻译：采用LibreTranslate和Google Translate双引擎，支持自动回退机制
• 多模态处理：语音转文字(Whisper)和图片文字识别(PaddleOCR)全部本地离线完成
• 快捷命令：内置天气查询、汇率转换和维基百科搜索功能
• 轻量部署：Docker镜像仅300MB，树莓派4可支持15用户并发
• 隐私保护：默认不存储消息，支持"阅后即焚"模式

2. 环境准备

2.1 系统要求

• 操作系统：Linux/Windows/macOS(推荐Linux)
• Docker：版本20.10.0或更高
• 硬件配置：
  • 最低：2核CPU，4GB内存
  • 推荐：4核CPU，8GB内存(处理语音/图片更流畅)

2.2 安装Docker

如果系统尚未安装Docker，可执行以下命令：

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install docker.io docker-compose
sudo systemctl enable --now docker

# CentOS/RHEL
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io
sudo systemctl enable --now docker

验证安装：

docker --version
docker-compose --version

3. 快速部署指南

3.1 获取Docker镜像

执行以下命令拉取最新镜像：

docker pull moltbot/moltbot:latest

3.2 启动容器

使用以下命令启动基础服务：

docker run -d \
  --name clawdbot \
  -p 7860:7860 \
  -v ~/.clawdbot:/app \
  moltbot/moltbot

3.3 访问控制面板

容器启动后，执行以下命令获取访问链接：

docker exec -it clawdbot clawdbot dashboard

输出将显示类似以下内容：

Dashboard URL: http://127.0.0.1:7860/?token=23588143fd1588692851f6cbe9218ec6b874bb859e775762

在浏览器中打开该链接即可访问控制面板。

4. 配置详解

4.1 基础配置文件

主配置文件位于/app/clawdbot.json(容器内路径)，对应宿主机上的~/.clawdbot/clawdbot.json。基础配置如下：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "vllm/Qwen3-4B-Instruct-2507"
      },
      "workspace": "/app/workspace",
      "maxConcurrent": 4
    }
  },
  "models": {
    "providers": {
      "vllm": {
        "baseUrl": "http://localhost:8000/v1",
        "apiKey": "sk-local",
        "models": [
          {
            "id": "Qwen3-4B-Instruct-2507",
            "name": "Qwen3-4B-Instruct-2507"
          }
        ]
      }
    }
  }
}

4.2 模型配置调整

如需更换模型，可通过以下方式修改：

1. 直接编辑配置文件： 修改clawdbot.json中的models.providers.vllm部分

2. 通过控制面板：

   • 登录控制面板(通常为http://localhost:7860)
   • 导航至"Config" → "Models" → "Providers"
   • 修改相应参数并保存

验证模型是否生效：

docker exec -it clawdbot clawdbot models list

正常输出应包含配置的模型信息。

5. Telegram机器人集成

5.1 获取Bot Token

1. 在Telegram中搜索@BotFather
2. 发送/newbot并按提示操作
3. 获取形如123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11的token

5.2 配置Telegram通道

编辑clawdbot.json，添加以下内容：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的BotToken",
      "proxy": "http://127.0.0.1:7890"  // 国内用户需要配置代理
    }
  }
}

5.3 重启服务使配置生效

docker restart clawdbot

6. 功能验证与使用

6.1 基础功能测试

1. 文本翻译：

   • 私聊或群聊中@机器人并发送任意文字
   • 机器人应自动回复翻译结果

2. 语音翻译：

   • 发送语音消息给机器人
   • 机器人将先转写文字再翻译

3. 图片翻译：

   • 发送包含文字的图片
   • 机器人将识别图中文字并翻译

6.2 快捷命令

• /weather 北京：查询北京天气
• /fx 100USD：100美元换算为人民币
• /wiki AI：查询维基百科AI词条

7. 常见问题解决

7.1 控制面板无法访问

如果无法访问控制面板，尝试以下步骤：

1. 检查容器是否正常运行：

   docker ps
   

2. 查看容器日志：

   docker logs clawdbot
   

3. 重新获取访问令牌：

   docker exec -it clawdbot clawdbot dashboard
   

7.2 翻译功能不工作

如果翻译功能异常：

1. 检查模型服务是否正常：

   docker exec -it clawdbot curl http://localhost:8000/v1/models
   

2. 验证网络连接：

   docker exec -it clawdbot ping google.com
   

3. 检查配置文件路径和权限：

   docker exec -it clawdbot ls -l /app/clawdbot.json
   

8. 总结与进阶建议

通过本指南，您已经完成了ClawdBot的基础部署和配置。这个强大的工具不仅能作为个人AI助手，还能为Telegram群组提供智能翻译服务。

进阶建议：

1. 性能优化：

   • 对于高频使用场景，考虑升级硬件配置
   • 调整maxConcurrent参数控制并发数

2. 功能扩展：

   • 集成自定义知识库
   • 开发专属快捷命令

3. 安全加固：

   • 定期更新Docker镜像
   • 配置HTTPS访问控制面板

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。