> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/zh/messenger-channels/telegram.md).

# Telegram

将 Crew 连接到 Telegram，创建你自己的专属 AI 助手 Bot。

## 设置指南

### 第一步：在 Telegram 上创建 Bot

1. 打开 Telegram，搜索 **@BotFather**
2. 发送命令 `/newbot`
3. 按照提示操作：
   * 为你的 Bot 取一个**名称**（如"我的 Crew 助手"）
   * 选择一个以 `bot` 结尾的**用户名**（如 `my_crew_assistant_bot`）
4. BotFather 会给你一个 **API Token**——复制下来（格式类似 `123456789:ABCdef...`）

### 第二步：将 Bot 连接到 Crew

1. 进入 Crew 网页端的**通讯渠道**
2. 点击 Telegram 旁边的**连接**
3. 将你的 **机器人令牌** 粘贴到输入框
4. 点击**连接**

Crew 会验证 Token 并自动配置 Bot 的 Webhook。

### 第三步：开始对话

1. 打开 Telegram，搜索你创建的 Bot 用户名
2. 点击 **Start** 或发送任意消息
3. 你的 Crew 助手现在已经在 Telegram 上线了！

## 为什么用自己的 Bot？

与其他渠道共享 Crew Bot 不同，Telegram 使用**个人 Bot 模式**：

* **你的 Bot，你的品牌**：自由选择名字和头像
* **完全私密**：这个 Bot 完全属于你
* **自定义用户名**：方便在不同设备上找到

## 使用示例

> "帮我总结一下今天的未读邮件。"

> "帮我创建一份 PDF 报告，内容要点如下：\[你的内容]"

> "今天科技圈有什么大事？给我列举前5条。"

> \[发送语音消息] "提醒我明天下午3点给牙医打电话。"

## 功能特点

* **文字消息**：完整的富文本格式回复
* **文件收发**：发送和接收图片、文档和音频文件
* **语音消息**：自动将语音转写为文字
* **输入指示器**：看到 Crew 正在处理你的请求
* **长消息**：超过 Telegram 4,096 字符限制时自动分段

## 常见问题

### Bot 没有响应？

* 确认你已按下 **Start** 或发送了 `/start`
* 在通讯渠道页面检查连接状态——应显示"已连接"
* 尝试断开再用同一 Token 重新连接

### Token 丢了？

* 在 Telegram 上找到 @BotFather
* 发送 `/mybots`，选择你的 Bot，然后点击 **API Token** 查看

## 断开连接

断开方法：

1. 进入 Crew 网页端的**通讯渠道**
2. 点击 Telegram 旁边的**断开**

Bot 将停止响应。你可以随时用同一个或不同的机器人令牌重新连接。
