ClawdBot完整指南：Telegram Bot Token申请与channel配置实操

本文介绍了如何在星图GPU平台自动化部署ClawdBot镜像，快速搭建个人AI助手。该镜像支持智能对话和多语言翻译功能，用户可轻松配置Telegram频道，实现消息实时翻译和群聊自动处理，提升跨语言沟通效率。

芦苇毛

240人浏览 · 2026-02-23 00:36:20

芦苇毛 · 2026-02-23 00:36:20 发布

ClawdBot完整指南：Telegram Bot Token申请与channel配置实操

1. 项目概述

ClawdBot是一个可以在个人设备上运行的人工智能助手，它使用vllm提供后端模型能力，为用户提供智能对话和多种实用功能。这个开源项目让每个人都能拥有属于自己的AI助手，无需复杂的配置就能快速部署使用。

MoltBot是2025年开源的"多语言、多平台、零配置"Telegram翻译机器人。它能够将用户消息实时翻译成100多种语言，支持群聊自动识别、语音转写、图片OCR翻译，并内置汇率、天气、维基快捷查询功能。只需一条Docker命令就能快速上线使用。

核心特点：

实时翻译：支持LibreTranslate和Google Translate双引擎
多模态处理：语音转文字、图片文字识别都能离线完成
快捷命令：内置天气查询、汇率换算、维基搜索功能
零配置部署：300MB镜像大小，树莓派4也能流畅运行
隐私保护：默认不存储消息，支持阅后即焚模式

2. 环境准备与快速部署

2.1 系统要求

在开始配置之前，请确保你的系统满足以下基本要求：

操作系统：Linux、macOS或Windows（建议使用Linux服务器）
内存：至少4GB RAM（推荐8GB以上）
存储空间：至少10GB可用空间
网络：稳定的互联网连接

2.2 安装步骤

ClawdBot提供多种安装方式，这里介绍最常用的Docker部署方法：

# 拉取最新镜像
docker pull moltbot/moltbot

# 运行容器
docker run -d \
  --name moltbot \
  -p 7860:7860 \
  -v ~/.clawdbot:/app \
  moltbot/moltbot

等待容器启动后，你就可以通过浏览器访问 http://localhost:7860 来使用ClawdBot了。

3. Telegram Bot Token申请指南

3.1 创建Telegram Bot

要使用ClawdBot的Telegram频道功能，首先需要申请一个Bot Token：

打开Telegram：搜索并联系 @BotFather
创建新Bot：发送 /newbot 命令
设置名称：为你的Bot起一个名字
设置用户名：设置唯一的用户名（必须以bot结尾）
获取Token：创建成功后，BotFather会提供API Token

重要提示：妥善保管这个Token，它相当于你的Bot的密码。如果泄露，别人就可以控制你的Bot。

3.2 Token安全注意事项

不要将Token分享给他人
不要在代码中直接硬编码Token
建议使用环境变量或配置文件存储Token
定期检查Bot的权限设置

4. Channel配置详细步骤

4.1 基础配置

配置Telegram频道需要在ClawdBot的配置文件中进行设置。配置文件通常位于 ~/.clawdbot/clawdbot.json：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing",
      "botToken": "你的Bot_Token_在这里",
      "groupPolicy": "allowlist",
      "streamMode": "partial"
    }
  }
}

4.2 配置参数详解

enabled: 设置为true启用Telegram频道
dmPolicy: 私聊策略，推荐使用"pairing"
botToken: 填写你从BotFather获取的Token
groupPolicy: 群组策略，"allowlist"表示只允许特定群组
streamMode: 流模式设置，"partial"提供更好的响应体验

4.3 配置验证

完成配置后，需要验证设置是否正确：

# 检查频道状态
clawdbot channels status --probe

如果配置正确，你会看到Telegram频道显示为"enabled, configured"状态。

5. 常见问题解决方案

5.1 无法访问控制面板

如果无法通过浏览器访问控制面板，可以尝试以下方法：

# 查看待处理的设备请求
clawdbot devices list

# 批准待处理请求
clawdbot devices approve [request_id]

# 获取带token的访问链接
clawdbot dashboard

5.2 模型配置问题

如果需要修改默认模型配置：

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

5.3 网络连接问题

在某些网络环境下，可能需要额外的网络配置：

{
  "channels": {
    "telegram": {
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

6. 高级功能配置

6.1 多语言支持配置

ClawdBot支持多语言实时翻译，可以通过以下配置优化翻译体验：

{
  "translation": {
    "defaultEngine": "libretranslate",
    "fallbackEngine": "google",
    "autoDetect": true,
    "supportedLanguages": ["zh", "en", "ja", "ko", "fr", "de", "es"]
  }
}

6.2 隐私保护设置

为了保护用户隐私，可以启用阅后即焚模式：

{
  "privacy": {
    "messageRetention": "ephemeral",
    "ephemeralTimeout": 300,
    "dataStorage": "none"
  }
}

6.3 性能优化配置

针对不同硬件环境，可以进行性能调优：

{
  "performance": {
    "maxConcurrent": 4,
    "subagents": {
      "maxConcurrent": 8
    },
    "compaction": {
      "mode": "safeguard"
    }
  }
}