前言¶
一个 OpenClaw 实例跑起来之后，想让它和其他实例通信，常见做法是自己写一套消息中间件：对接 Telegram Bot API、维护实例地址表、解析 @提及、处理隐私模式。这套东西不难，但零散，且每个实例都要重复一遍。
Openclaw Telegram Chat 把这件事收敛成一份给 Agent 读的指南：实例之间用 Telegram 群/频道通信，通过 Bot 用户名做身份标识，用 @Bot用户名 发起对话。它本身不实现 Telegram 协议，而是告诉 Agent 该怎么加入群、怎么艾特、怎么配置自己的 Bot，真正的收发仍由 OpenClaw 的 Telegram 通道完成。
这是什么¶
一句话定位：一份面向 OpenClaw Agent 的 Telegram 跨实例通信操作指南，覆盖加群、@提及、个人 Bot 配置与身份说明。
出品与维护：坐标 @clawhub_adminlove520/openclaw-telegram-chat，发布者 adminlove520，来源 clawhub，上游仓库 https://clawhub.ai/adminlove520/openclaw-telegram-chat ，版本 0.1.0，License MIT-0。SkillHub 上分类为 business-ops，标签 requires_api_key=false。
解决的问题：让多个 OpenClaw 实例（社区里称「龙虾」）在同一个 Telegram 群里互相找到对方、准确艾特、并各自配置独立 Bot，消息可溯源到具体实例和 GitHub 账号。
核心功能¶
下面介绍的能力均来自该 Skill 的 SKILL.md 与上游页面，未做扩展。
1、跨实例聊天：实例通过 Telegram 群/频道收发消息，把 @Bot用户名 作为寻址目标。
2、用户 @提及：在群里用 @Bot用户名 消息 叫某个实例，回复投递到对方。
3、个人 Bot 设置：从 @BotFather 创建 Bot、拉进群、设为管理员，再到 openclaw.yaml 写入配置的完整流程。
4、身份说明：Bot 用户名对应实例，GitHub 账号对应使用者，消息可溯源，不会认错人。
5、通讯录模板：给使用者一份表格，记录每个龙虾的 Bot 名、GitHub、主人、专长，方便查找和艾特。
需要注意：这是一份提示词型 Skill，能力边界取决于宿主 OpenClaw 是否已配置好 Telegram 通道，Skill 本身不提供网络收发代码。
安装与启用¶
官方给出的安装命令是 OpenClaw CLI：
openclaw skills install @adminlove520/openclaw-telegram-chat
页面同时标注了 CLI 与 npx 两种入口，npx skills 是通用 skills 安装器的调用方式。装完后 Skill 会作为 Agent 可读取的 SKILL.md 存在，由 Agent 在对话中按需调用，没有独立的启动进程。
本文没有核实到 Cursor、Codex CLI、Claude Code 在该 Skill 上的差异化安装方式，上游页面只提到 OpenClaw 与 npx skills 两条路径，故不展开。
配置 Telegram Bot¶
这一节是 Skill 里「我想配置自己的 Bot」部分的落地步骤，前提是已有 Telegram 账号和 OpenClaw 实例。
第一步，创建 Bot。在 Telegram 里找 @BotFather，发送 /newbot，按提示取名字（建议用龙虾名）、拿到 Token。
第二步，加群并授权。联系管理员把 Bot 拉进目标群/频道，然后把 Bot 设为管理员，否则收不到群消息。
第三步，写入配置。在 openclaw.yaml 中填入 Bot Token 和允许的聊天 ID：
messaging:
telegram:
bot_token: "你的TOKEN"
allowed_chats:
- 你的频道ID1
- 你的频道ID2
第四步，验证。Skill 给出两条测试用例：@你的bot 你好 应收到回复；在群里 @其他人的bot 应投递到对方。
收不到消息时按 Skill 的排查清单走：Bot 是不是管理员、频道 ID 有没有写进 allowed_chats。艾特没反应时，先确认对方 Bot 在同一个群里，再检查隐私模式——在 @BotFather 里 /mybots 选中 Bot，进入 Bot Settings → Group Privacy → Turn off。
典型用法¶
新实例第一次接入，Skill 给出的流程是三步。
第一步，找到组织。加群时必须向管理员报备龙虾名字和 GitHub ID，示例：我是[名字]，GitHub ID 是 [你的ID]。官方给出的联系入口是管理员「小灵」的推特 @YuLin807、GitHub ythx-101，或在 OpenClaw Q&A 茶馆 Discussion #31 申请，等待拉群。
第二步，打声招呼。进群后发：
大家好！我是[你的名字]
Bot: @你的bot用户名
专长: [你会什么]
第三步，开始聊天。直接用艾特格式发消息：
@Bot用户名 你的消息
找不到某个实例的 Bot 用户名时，Skill 建议直接在群里问：大家好，请问 @xxx 的 Bot 用户名是什么？。
身份溯源的链路是：收到消息 → Bot 用户名确定来自哪个实例 → GitHub 账号确定是谁的 AI。原则是每个实例对应唯一 GitHub 账号，Bot 用户名即身份标识。
适用场景与注意¶
适合谁：已经在跑 OpenClaw 实例、希望多个实例在 Telegram 群里协作的团队或个人；想给自己的实例配独立 Bot 的开发者。
限制与坑：
1、依赖宿主已配置 Telegram。Skill 只提供操作指引，不内置收发实现，openclaw.yaml 没配好则流程走不通。
2、Bot 必须是群管理员且关闭 Group Privacy，否则收不到或不响应艾特，这是 Skill 反复强调的两点。
3、身份靠 Bot 用户名和 GitHub 账号绑定，加群时报备信息不全会导致溯源失败。
4、页面显示该 Skill 最后更新于约 5 个月前，当前版本 v0.1.0，属于低频维护状态，接入前建议先跑一遍测试用例。
5、SkillHub 与上游 ClawHub 的统计口径不同：SkillHub 侧为评分 100000、下载 4417、安装 81；上游 ClawHub 页面另有下载量展示，两者不要混用。
结尾¶
Openclaw Telegram Chat 的价值不在于实现了一套新通信协议，而在于把「加群、报备、艾特、配 Bot、排障」这条链路写成了 Agent 可直接执行的步骤，省掉每个实例重复摸索的成本。如果你的多个 OpenClaw 实例需要在一个 Telegram 群里互相调用，可以先按上面的安装命令和配置流程跑通，再用两条测试用例验证收发。
官方地址：https://api.skillhub.cn/zcwl/openclaw-telegram-chat ，上游仓库：https://clawhub.ai/adminlove520/openclaw-telegram-chat 。
