ClawdBot Telegram配置详解：从Bot创建到账号配对，实现聊天控制AI助手

1. 项目概述

ClawdBot是一个可以在本地设备上运行的个人AI助手，通过vllm提供后端模型能力。它支持通过Telegram等即时通讯工具进行交互，让用户能够随时随地通过聊天控制AI助手完成各种任务。

1.1 核心特点

• 本地运行：数据存储在用户自己的设备上，保障隐私安全
• 多平台支持：可通过Telegram、WhatsApp等主流通讯工具访问
• 强大模型支持：基于vllm后端，支持多种AI模型
• 简单配置：提供清晰的配置文件和UI界面进行管理

2. 环境准备

2.1 硬件要求

• 推荐使用云服务器确保24小时在线
• 最低配置：2核CPU，4GB内存，20GB存储空间
• 网络要求：稳定的互联网连接

2.2 软件依赖

• Docker环境（已预装在镜像中）
• Telegram账号（用于创建和管理Bot）
• 可选的代理设置（根据网络环境）

3. Telegram Bot创建

3.1 创建新Bot

1. 打开Telegram，搜索并进入@BotFather
2. 发送指令/newbot开始创建新机器人
3. 按照提示设置机器人名称和用户名
4. 成功创建后，@BotFather会返回一个bot token，请妥善保存

3.2 基础配置

• 建议为Bot设置描述和头像
• 可配置命令菜单，方便用户使用
• 确保Bot的隐私模式设置正确

4. ClawdBot配置

4.1 配置文件位置

主配置文件位于：

/app/clawdbot.json

或本地路径：

~/.clawdbot/clawdbot.json

4.2 基础配置示例

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "vllm/Qwen3-4B-Instruct-2507"
      },
      "workspace": "/app/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "vllm": {
        "baseUrl": "http://localhost:8000/v1",
        "apiKey": "sk-local",
        "api": "openai-responses",
        "models": [
          {
            "id": "Qwen3-4B-Instruct-2507",
            "name": "Qwen3-4B-Instruct-2507"
          }
        ]
      }
    }
  }
}

4.3 模型验证

执行以下命令验证模型配置是否成功：

clawdbot models list

预期输出应包含配置的模型信息。

5. Telegram通道配置

5.1 配置文件修改

在clawdbot.json中添加Telegram通道配置：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing",
      "botToken": "你的Bot Token",
      "groupPolicy": "allowlist",
      "streamMode": "partial",
      "proxy": "http://127.0.0.1:7890"  # 如需代理可配置此项
    }
  }
}

5.2 通道状态验证

执行以下命令检查通道状态：

clawdbot channels status --probe

6. 账号配对流程

6.1 启动配对模式

1. 确保服务已正常运行
2. 在Telegram中向你的Bot发送任意消息
3. Bot会回复一个配对码

6.2 批准配对请求

在服务器上执行：

clawdbot devices list

查看待处理的配对请求，然后执行：

clawdbot devices approve [request]

将[request]替换为实际的请求ID。

6.3 测试连接

配对成功后，在Telegram中发送测试消息验证连接是否正常。

7. 控制面板使用

7.1 访问控制面板

执行以下命令获取控制面板访问信息：

clawdbot dashboard

输出将包含带token的访问URL。

7.2 通过SSH隧道访问

如果直接访问受限，可建立SSH隧道：

ssh -N -L 7860:127.0.0.1:7860 用户名@服务器IP

然后在本地浏览器访问：

http://localhost:7860/

7.3 面板功能

• Config：修改模型和通道配置
• Devices：管理已配对的设备
• Models：查看和切换AI模型
• Logs：查看系统日志

8. 常见问题解决

8.1 无法访问控制面板

1. 检查服务是否正常运行：

systemctl --user status clawdbot-gateway.service

2. 确保端口未被占用
3. 检查防火墙设置

8.2 配对失败

1. 确认Bot Token正确
2. 检查网络连接，特别是代理设置
3. 查看日志获取详细信息：

journalctl --user -u clawdbot-gateway.service -n 30 --no-pager

8.3 模型不响应

1. 验证模型是否加载成功：

clawdbot models list

2. 检查vllm服务是否正常运行
3. 查看模型配置是否正确

9. 进阶配置

9.1 自定义模型

参考文档修改模型配置：

{
  "models": {
    "providers": {
      "vllm": {
        "baseUrl": "http://localhost:8000/v1",
        "apiKey": "sk-local",
        "api": "openai-responses",
        "models": [
          {
            "id": "your-model-id",
            "name": "Your Model Name"
          }
        ]
      }
    }
  }
}

9.2 多设备管理

1. 查看已配对设备：

clawdbot devices list

2. 撤销设备访问权限：

clawdbot devices revoke [device-id]

9.3 性能调优

根据硬件配置调整并发参数：

{
  "agents": {
    "defaults": {
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

---

获取更多AI镜像

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