OpenClaw 企业定制 私人订制工作流 优化运维 openclaw记忆优化 问题咨询解决 请加微信交流
想让AI在Telegram上跟你对话？Telegram是最简单的消息平台配置，5分钟搞定。通过Telegram，你可以在手机上随时访问你的AI助手，查询信息、管理任务、设置提醒。
这是最推荐的入门级消息平台。这篇讲清楚怎么配置、怎么用、以及实际体验。
为什么首选Telegram
Telegram配置最简单，支持最全面：
- 语音消息输入和回复
- 图片和文件收发
- Thread对话支持
- 打字提示显示
- 流式消息更新
相比Discord，Telegram不需要创建Server、设置Channel。直接跟Bot私聊就行。
快速配置
第一步：创建Bot
- 在Telegram搜索@BotFather
- 发送
/newbot - 给Bot起名字（显示名）
- 给Bot起用户名（必须以bot结尾）
- BotFather给你一个Token，格式：
123456789:ABCdefGhIJKlmNoPQRstuVWXyz
第二步：配置Hermes
# 在config.yaml里配置
telegram:
bot_token: "你的Bot Token"
allowed_users:
- 你的Telegram用户ID
voice_reply: true # 是否支持语音回复
stream: true # 是否启用流式消息第三步：交互式配置（推荐）
hermes gateway setup选择Telegram，填入Bot Token，向导会引导完成剩余配置。
第四步：获取你的Telegram用户ID
- 搜索@userinfobot
- 给它发任意消息
- 它返回你的用户ID（数字）
把用户ID加到allowed_users里。
安全配置
默认情况下，所有Telegram用户都能访问Bot。强烈建议配置白名单：
telegram:
bot_token: "${TELEGRAM_BOT_TOKEN}"
allowed_users:
- 123456789 # 你的用户ID
- 987654321 # 其他授权用户或者用环境变量：
TELEGRAM_ALLOWED_USERS=123456789,987654321常用设置
语音回复
telegram:
bot_token: "${TELEGRAM_BOT_TOKEN}"
voice_reply: true
voice_transcribe: true # 把收到的语音转成文字流式消息
telegram:
bot_token: "${TELEGRAM_BOT_TOKEN}"
stream: true # AI回复时逐字显示，类似ChatGPT群组模式
Bot也可以加到群组里，但需要@提及才回复：
telegram:
bot_token: "${TELEGRAM_BOT_TOKEN}"
group_mode: true
group_trigger: "@你的bot用户名"Telegram内命令
在Telegram里跟Bot对话时，这些命令有用：
/new # 开始新对话
/reset # 重置当前对话
/model [name] # 切换模型
/retry # 重试上一条
/stop # 停止正在运行的AI
/status # 查看当前状态
/compress # 压缩对话上下文
/usage # 查看Token使用量
/insights # 查看使用统计
/voice on # 开启语音回复
/voice off # 关闭语音回复
/help # 显示帮助会话管理
会话持久化
每个Telegram对话有独立会话。AI记住你们的对话历史，不需要每次重新说明。
重置策略
可以配置自动重置：
{
"reset_by_platform": {
"telegram": {
"mode": "idle",
"idle_minutes": 240
}
}
}240分钟无活动后自动重置会话。
多用户
每个用户有独立的会话和上下文。Bot记住每个用户的偏好和历史。
实际使用场景
个人助手
最基础的用法：把Bot当个人助手用。
帮我总结一下今天的工作
设置明天下午3点提醒开会
查一下北京现在的天气
语音输入
不方便打字时，直接发语音：
（语音）帮我查一下从北京到上海的高铁
AI识别语音，处理后文字或语音回复。
文件处理
发文件给Bot处理：
帮我分析这个CSV文件，提取关键数据
支持发送PDF、图片、文档等各种文件类型。
群组助手
加Bot到群组，提供群组AI助手功能。需要@提及才回复。
和Gateway配合
Telegram是Gateway支持的多个平台之一。可以同时配置多个平台：
telegram:
bot_token: "${TELEGRAM_BOT_TOKEN}"
allowed_users:
- 123456789
discord:
bot_token: "${DISCORD_BOT_TOKEN}"
allowed_users:
- 987654321
slack:
bot_token: "${SLACK_BOT_TOKEN}"一个Gateway进程服务所有平台，每个平台独立会话。
常见问题
Bot不回复消息？
检查：allowed_users是否包含你的ID、Bot Token是否正确、Gateway是否在运行。
如何知道Bot是否在线？
发送/status命令给Bot，它会回复当前状态。
语音消息无法识别？
检查：voice_transcribe是否开启、STT引擎是否配置。
如何限制Bot只能一个人用？
配置allowed_users，只包含你自己的用户ID。
Bot回复很慢？
跟模型响应速度有关。可以换更快的模型，或者检查网络延迟。
进阶配置
自定义Bot命令菜单
可以在Telegram里设置Bot的命令菜单，让用户点按钮而不是打字：
telegram:
bot_token: "${TELEGRAM_BOT_TOKEN}"
commands:
- command: "/new"
description: "开始新对话"
- command: "/status"
description: "查看状态"
- command: "/help"
description: "获取帮助"Webhook vs Long Polling
默认用Long Polling，如果需要更低的延迟，可以切换到Webhook：
telegram:
bot_token: "${TELEGRAM_BOT_TOKEN}"
webhook:
enabled: true
url: "https://your-domain.com/telegram"
secret: "${TELEGRAM_WEBHOOK_SECRET}"总结
Telegram是接入Hermes Agent最简单的方式，5分钟搞定。
核心价值：
- 配置最简单，5分钟搞定
- 支持语音、图片、文件
- 移动端随时访问
- 独立会话，多用户支持
- 安全白名单保护
建议作为第一个接入的消息平台。
暂无评论内容