#6 OpenClaw 接入 Telegram：Bot 配置指南

Telegram 是 OpenClaw 最受欢迎的消息渠道之一。本文将手把手教你如何创建 Telegram Bot 并接入 OpenClaw。

为什么选择 Telegram？

Telegram 作为 OpenClaw 的消息渠道有以下优势：

• 免费开放：Bot API 完全免费，无使用限制
• 富媒体支持：支持图片、语音、视频、文件等多种消息类型
• 群聊支持：支持在群组中与 AI 互动
• 隐私友好：端到端加密，不需要绑定手机号
• 跨平台：iOS、Android、桌面端、网页端全平台支持

第一步：创建 Telegram Bot

在 Telegram 中搜索 @BotFather，这是 Telegram 官方的 Bot 管理机器人。发送以下命令：

/newbot — 创建新的 Bot
然后按照提示输入 Bot 的名字和用户名（必须以 bot 结尾）。

创建成功后，BotFather 会给你一个 Bot Token，格式类似：123456789:ABCdefGHIjklMNOpqrSTUvwxYZ。这个 Token 非常重要，妥善保管。

第二步：配置 OpenClaw

在 openclaw.json 的 channels 部分添加 Telegram 配置：

设置 channel 类型为 telegram，在 token 字段填入你的 Bot Token。如果需要在群聊中使用，还需要配置群组相关参数。

配置完成后重启 Gateway，你的 Telegram Bot 就上线了。

私聊和群聊配置

私聊：直接给 Bot 发消息即可。Bot 默认会对所有私聊消息做出回应。

群聊：在群组中使用时，可以通过以下方式触发 Bot：
• @Bot 直接提及
• 回复 Bot 的消息
• 设置 requireMention 为 true 时，需要 @Bot 才会响应

建议在群聊中开启 requireMention，避免 Bot 对所有消息都响应造成干扰。

主题绑定（Thread）

Telegram 的论坛式群组支持主题（Topic/Thread）。OpenClaw 可以将不同的 Agent 绑定到不同的主题，实现：

• 主题 A 由 Agent 1 处理（比如翻译）
• 主题 B 由 Agent 2 处理（比如代码审查）
• 其他消息由默认 Agent 处理

这在团队协作场景中非常实用。

富媒体支持

OpenClaw 的 Telegram 通道支持：

• 图片：发送和接收图片
• 语音：发送语音消息（支持 TTS）
• 文件：发送和接收各类文件
• Markdown 格式：支持粗体、斜体、代码块等格式

常见问题排查

Q: Bot 收不到消息？
检查 Token 是否正确，确认 Gateway 已启动，查看日志是否有错误。

Q: 群聊中 Bot 不响应？
确认 Bot 已加入群组，检查 requireMention 设置，确认 Bot 有群组消息读取权限。

Q: 消息延迟？
可能是 LLM 响应慢，尝试切换更快的模型。

总结

接入 Telegram 是使用 OpenClaw 的最佳入门选择之一。只需一个 Bot Token，几分钟就能让你的 AI 助手上线 ✈️