HermesAgent连接Telegram教程：手机端获取BotToken实现远程控制

必须先获取Telegram BotToken才能连接HermesAgent实现手机远程控制：一、通过BotFather创建Bot并获取Token；二、在HermesAgent配置中填入该Token；三、在手机Telegram中搜索并对话Bot验证连通性；四、启用控制权限、添加授权用户ID并绑定指令映射。

想用手机上的Telegram远程控制HermesAgent？这事儿听起来挺酷，但第一步，你得先拿到一把“数字钥匙”——也就是Telegram Bot的Token。没有它，后续所有操作都无从谈起。下面，咱们就按步骤把这把钥匙拿到手，并把整个通道打通。

一、在Telegram中创建Bot并获取BotToken

所有Telegram Bot的“出生证明”都得由官方机器人BotFather来签发。它颁发的BotToken，是后续HermesAgent与Telegram服务器对话的唯一身份凭证，重要性不言而喻，务必妥善保管。

第一步，打开你的Telegram应用，在搜索框里找到并关注那个名叫 BotFather 的官方机器人。

第二步，直接给BotFather发送指令 /newbot，这就启动了创建流程。

第三步，跟着提示走：先给你的Bot起个大家能看见的名字（比如“HermesControlBot”），然后再设定一个唯一的用户名。注意，这个用户名必须以“bot”结尾，例如“hermescontrolbot”。

第四步，创建成功后，BotFather会发来一条消息，里面包含一串 HTTP API token。这串字符长得像“123456789:ABCdefGhIjKlmNoPqrStUvWxYz123456789”，没错，它就是你要找的BotToken，赶紧复制保存好。

二、配置HermesAgent使用BotToken

拿到Token只是第一步，接下来得把它交给HermesAgent，让它能和你的Bot“相认”。

首先，启动HermesAgent应用，找到设置或者配置中心。

接着，定位到 Telegram Integration 或 Bot Configuration 这类选项。

然后，在 Bot Token 输入框里，粘贴上一步复制的完整Token字符串。

最后，点击 Sa ve & Connect 之类的按钮。稍等片刻，看到状态指示灯变绿，并显示“Connected to Telegram”之类的提示，就说明连接成功了。

三、在手机端Telegram中添加并测试Bot

配置好了，不代表马上就能用。还得在手机上和你的Bot“打个招呼”，确认这条通信链路是双向畅通的。

1. 找到你的Bot：在Telegram里搜索你之前设定的Bot用户名（比如 hermescontrolbot），然后进入聊天界面。

2. 发送激活指令：发送一条 /start 消息。如果一切正常，Bot应该会回复一段欢迎语，这说明它已经在线了。

3. 检查后台日志：这时，去瞅一眼HermesAgent的日志。如果看到类似 Received message from @yourusername 的记录，恭喜你，消息接收通路正常。

4. 测试反向通信：为了万无一失，可以在HermesAgent界面执行一个简单的查询指令（比如查看系统状态），然后观察Telegram的聊天窗口里，是否及时收到了结构化的反馈信息。这一步能验证指令发送通路也没问题。

四、启用手机端控制权限与指令映射

到了这里，通信基础是打好了，但安全和控制粒度还得细化。HermesAgent默认不会开放所有控制功能，需要你手动开启并绑定权限，防止被误操作或未授权访问。

1. 开启远程执行开关：在HermesAgent的配置里，找到 Remote Command Execution 这类选项，把它打开。

2. 添加授权用户：光有Bot还不够，得明确告诉HermesAgent“谁”可以控制它。进入 Authorized Users 列表，添加你的Telegram账号ID。这个ID可以通过给 @userinfobot 发消息轻松获取。

3. 绑定具体指令：这是实现灵活控制的关键。在 Command Mapping 页面，你可以把在Telegram里输入的文本指令（比如“reboot”），一对一地映射到本地要执行的shell命令或某个API调用路径上。

4. 保存并重启：完成上述设置后，保存配置，并重启HermesAgent服务，让所有的权限和映射规则正式生效。

走完这四步，你的手机就真正变成一个远程控制终端了。整个过程逻辑清晰，步步为营，既保证了功能的实现，也兼顾了基本的安全性。试试看吧。