FoneClaw 连接 Telegram 机器人：BotFather 创建、私聊绑定与故障排查
用 BotFather 创建专用 Telegram 机器人，把它绑定到 FoneClaw 的私聊入口，再用一个无日期待办验证 Android 结果。本文说明令牌保护、十分钟绑定、常见错误、暂停恢复和删除连接。
- FoneClaw 连接 Telegram 机器人，适合把私聊消息作为入口发送给 FoneClaw；这不同于用语音直接操控 Telegram 应用。
- 先用官方 @BotFather 和 /newbot 创建专用机器人，妥善保存令牌；令牌用来认证机器人，不是你的 Telegram 登录码或账号密码。
- 在 FoneClaw 保存机器人令牌后，需要在当前配对提示给出的 10 分钟内打开自己的机器人并发送 hello；如果窗口过期，在手机上点 Connect this chat 后按新窗口重试。
- 连接成功只说明消息入口可用；Android 动作仍要按 FoneClaw 支持范围、权限和适用审批执行，并在手机上核对保存结果。
创建一个专用 Telegram 机器人
FoneClaw 连接 Telegram 机器人，是把一个 Telegram bot 作为你和 FoneClaw 对话的入口。它不是让 FoneClaw 读取你的所有 Telegram 聊天，也不是用语音去操作 Telegram 应用。如果你想了解语音操作 Telegram 的另一种流程，可以看语音控制Telegram：FoneClaw智能操控教程；本篇只讲机器人连接。
先在 Telegram 里打开官方 BotFather 教程中说明的 @BotFather。发送 /newbot，按 BotFather 的提示给机器人取名称和用户名。完成后，BotFather 会返回一个唯一 token，也就是机器人令牌。这个令牌用来认证你的机器人，它不是你的个人账号密码，也不是 Telegram 登录验证码。不要把它发给别人，也不要贴到公开群、截图或共享文档里。
建议为 FoneClaw 单独创建一个机器人。这样可以避免它和其他服务共用同一个机器人令牌，也更容易判断连接问题来自 FoneClaw、Telegram 还是另一个正在使用同一机器人的程序。创建完成后，先把令牌保存在安全的位置，接下来再回到 FoneClaw 里填写。
绑定你自己的私聊账号
在 FoneClaw 中打开 Telegram Connections，找到 BotFather token 输入框，也就是填写 BotFather 令牌的位置，粘贴刚才从 BotFather 获得的令牌，然后使用 Save bot token 保存。保存后，不要继续和 BotFather 对话；你需要打开自己刚创建的机器人，也就是用户名以 bot 结尾的那个 Telegram 机器人。
接下来，按 FoneClaw 当前配对提示，在提示给出的 10 分钟窗口内向自己的机器人发送字面内容 hello，然后等待绑定确认。这里有两个关键点：第一，必须打开你自己的机器人，而不是 BotFather；第二，连接会绑定第一个发来消息的 Telegram 账号。因此，如果你用错了 Telegram 账号，或者让别人先给这个机器人发了消息，连接对象就会不对。
如果配对窗口已经过期，请在手机上点 Connect this chat，也就是连接当前聊天的控制项，然后在新提示的 10 分钟窗口内向自己的机器人发送 hello 并等待确认。这个入口只用于私聊，不要把它当作群组或频道自动化工具。绑定完成并看到确认后，再开始发送任务。如果你还没有完成 FoneClaw 的基础安装和第一次检查，可以先参考FoneClaw 安卓安装设置：免费开始并完成第一次手机检查，确认手机端本身已经能处理一个简单任务。
检查一个受支持的 Android 结果
连接成功后，先发一个低风险、容易核对的任务。推荐从无日期待办开始，例如在 Telegram 机器人私聊里发送：“保存一个待办：整理露营装备清单，备注检查帐篷地钉和头灯。”这句话没有日期、星期或相对时间，FoneClaw 应把它保存为未排期的用户待办，而不是日历事件。
收到任务后，FoneClaw 会根据配置好的模型理解你的请求，并在 Android 手机上执行受支持动作。连接 Telegram 只说明消息已经能传到 FoneClaw；它不会自动授予 Android 权限，也不会把所有审批都搬到 Telegram 里完成。需要权限或确认时，仍要按手机上的提示处理。
完成后，请回到 FoneClaw 的待办位置核对结果：标题是否是“整理露营装备清单”，备注是否包含“检查帐篷地钉和头灯”，是否没有被排到某个日期。无日期待办的详细处理方式，可以继续读Android AI 待办无日期保存指南。这个核对很重要，因为“Telegram 能发消息”和“Android 动作已保存成功”是两件事。
按具体错误排查连接问题
连接失败时，不要重复粘贴令牌碰运气。先看 FoneClaw 给出的错误类型，再按对应原因处理。
| 现象 | 常见原因 | 建议处理 |
|---|---|---|
| 令牌被拒绝 | 复制不完整、混入空格，或不是 BotFather 返回的令牌 | 回到 @BotFather 重新复制完整令牌，再填写到 BotFather token |
| 保存后没有绑定 | 你给 BotFather 发了 hello，或错过了当前提示给出的 10 分钟窗口 | 在手机上点 Connect this chat，然后在新提示的 10 分钟窗口内打开自己的机器人并发送 hello |
| 提示机器人已连接 | 同一个机器人已有连接或正在被其他用途占用 | 优先创建专用新机器人；如果要继续使用原机器人，先确认现有连接是否应移除 |
| Telegram 无法连接 | 网络、Telegram 服务或设备连接状态异常 | 检查网络后再重试，避免同时更换多个条件 |
| 轮询或 webhook 冲突 | 同一个机器人可能正在被其他程序接收消息 | 优先创建新的专用机器人；只有确定要停止原服务时，才移除它的 webhook |
如果另一个服务正在使用 webhook，移除 webhook 会停止消息发送到原来的接收地址。这个操作会影响现有服务，所以更稳妥的做法通常是为 FoneClaw 创建一个新的专用机器人。除非你明确知道旧 webhook 属于哪个服务，并且决定停用它，否则不要随意清理。
暂停、恢复或移除连接
连接建立后，你可以根据需要暂停、恢复或移除。Pause connection 用于暂时停止这个 Telegram 入口接收任务；暂停后，如果还想继续使用，需要使用 Resume connection 恢复。暂停并不等于删除连接，它更适合临时停用。
如果你更新机器人令牌，FoneClaw 会保留配对关系和聊天历史，但前提是连接没有被移除，并且新的令牌可用。换令牌后仍应发一个简单请求确认入口正常，例如保存一个低风险待办。不要用重要任务作为第一次验证。
移除连接的影响更大：它会删除本地保存的令牌、排队请求和投递记录；本地聊天历史会保留。移除本地连接本身不会撤销已经泄露的 Telegram 机器人令牌。如果你怀疑令牌已经外泄，应在 Telegram/BotFather 侧处理这个令牌，同时在 FoneClaw 中移除旧连接并重新配置新的专用机器人。
Telegram 机器人只是 FoneClaw 的一个入口。能执行哪些 Android 动作，仍取决于 FoneClaw 当前支持范围、手机权限、应用状态和适用审批。你可以通过FoneClaw 功能页核对支持范围，通过FoneClaw 下载页获取当前安装入口。先把一个简单私聊任务跑通，再把更复杂的手机任务交给 FoneClaw，会更容易判断问题发生在连接、权限还是具体 Android 动作上。