專注AI Agent實(shí)戰(zhàn)、多平臺部署、開源項(xiàng)目落地！

前面我們完成了Hermes的安裝、源碼解析、自定義工具開發(fā)和本地模型對接，今天帶來終極實(shí)戰(zhàn)——部署Telegram/Discord機(jī)器人，讓你隨時(shí)隨地通過手機(jī)、電腦遠(yuǎn)程控制Hermes，實(shí)現(xiàn)跨平臺對話、工具調(diào)用、定時(shí)任務(wù)，真正把AI智能體變成你的隨身助手！全文流程清晰、代碼可直接復(fù)制，建議收藏+關(guān)注，部署時(shí)不迷路～

?? 前言：為什么要部署多平臺機(jī)器人？

Hermes默認(rèn)只能在終端使用，局限性很大：必須登錄服務(wù)器、打開終端才能操作。而部署成Telegram/Discord機(jī)器人后，你可以：

• 手機(jī)/電腦隨時(shí)隨地聊天、調(diào)用工具（無需登錄服務(wù)器）
• 多設(shè)備同步對話歷史（和Hermes終端對話同步）
• 邀請好友一起使用（設(shè)置權(quán)限即可）
• 結(jié)合定時(shí)任務(wù)，讓Hermes定時(shí)推送消息到Telegram/Discord

Hermes內(nèi)置消息網(wǎng)關(guān)，部署過程非常簡單，無需額外開發(fā)，一鍵配置即可完成！

? 一、前期準(zhǔn)備（必做）

• 已安裝Hermes-Agent（參考第一篇安裝教程），且能正常啟動(dòng)
• 擁有Telegram/Discord賬號（用于創(chuàng)建機(jī)器人）
• 服務(wù)器能正常聯(lián)網(wǎng)（需要對接Telegram/Discord API）
• 安裝消息網(wǎng)關(guān)依賴（Hermes內(nèi)置，執(zhí)行以下命令確認(rèn)）：

# 激活Hermes虛擬環(huán)境
source ~/.hermes/venv/bin/activate
# 安裝消息網(wǎng)關(guān)依賴（若未安裝）
uv pip install -e ".[messaging]"  # 包含Telegram、Discord網(wǎng)關(guān)依賴

??? 二、部署Telegram機(jī)器人（重點(diǎn)，手機(jī)端首選）

Step 1：創(chuàng)建Telegram機(jī)器人，獲取API Token

• 打開Telegram，搜索 @BotFather（官方機(jī)器人）
• 發(fā)送指令 /newbot，按照提示設(shè)置機(jī)器人名稱（如HermesAgentBot）和用戶名（如Hermes_Agent_Bot，必須以bot結(jié)尾）
• 創(chuàng)建成功后，BotFather會(huì)返回一個(gè) API Token（格式：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11），復(fù)制保存，后續(xù)要用

Step 2：配置Hermes對接Telegram機(jī)器人

# 啟動(dòng)Hermes消息網(wǎng)關(guān)配置向?qū)?
hermes gateway setup
# 后續(xù)步驟（按提示操作，全程中文）：
1. 選擇要配置的平臺 → 輸入 1（Telegram）
2. 輸入Telegram Bot API Token → 粘貼剛才獲取的Token
3. 設(shè)置允許使用機(jī)器人的用戶ID（可選，不設(shè)置則所有人可使用）
   - 如何獲取自己的用戶ID：搜索 @userinfobot，發(fā)送任意消息，即可獲取
4. 確認(rèn)配置 → 輸入 y 保存

Step 3：啟動(dòng)Telegram機(jī)器人網(wǎng)關(guān)

# 啟動(dòng)Hermes消息網(wǎng)關(guān)（后臺運(yùn)行，避免關(guān)閉終端后停止）
hermes gateway start &
# 查看網(wǎng)關(guān)運(yùn)行狀態(tài)，確認(rèn)啟動(dòng)成功
hermes gateway status

若輸出“Telegram gateway: running”，說明啟動(dòng)成功！

Step 4：測試Telegram機(jī)器人

• 打開Telegram，搜索你創(chuàng)建的機(jī)器人用戶名（如Hermes_Agent_Bot）
• 發(fā)送 /start 指令，機(jī)器人會(huì)回復(fù)歡迎消息
• 發(fā)送任意消息（如“幫我查詢當(dāng)前時(shí)間”），機(jī)器人會(huì)調(diào)用Hermes的能力，返回回復(fù)
• 測試工具調(diào)用（如“幫我查詢文件 /home/user/test.txt”），驗(yàn)證工具是否正常使用

?? 三、部署Discord機(jī)器人（電腦端首選）

Step 1：創(chuàng)建Discord機(jī)器人，獲取Token和Client ID

• 訪問Discord開發(fā)者平臺：https://discord.com/developers/applications
• 點(diǎn)擊“New Application”，輸入應(yīng)用名稱（如HermesAgent），創(chuàng)建應(yīng)用
• 左側(cè)導(dǎo)航欄點(diǎn)擊“Bot”，點(diǎn)擊“Add Bot”，確認(rèn)創(chuàng)建機(jī)器人
• 點(diǎn)擊“Reset Token”，復(fù)制生成的Token（保存，后續(xù)要用）
• 開啟“Message Content Intent”（否則機(jī)器人無法接收消息）
• 左側(cè)導(dǎo)航欄點(diǎn)擊“OAuth2 → URL Generator”，勾選“bot”和“Send Messages”權(quán)限，復(fù)制生成的URL
• 打開復(fù)制的URL，將機(jī)器人邀請到你的Discord服務(wù)器

Step 2：配置Hermes對接Discord機(jī)器人

# 啟動(dòng)Hermes消息網(wǎng)關(guān)配置向?qū)?
hermes gateway setup
# 后續(xù)步驟（按提示操作）：
1. 選擇要配置的平臺 → 輸入 2（Discord）
2. 輸入Discord Bot Token → 粘貼剛才獲取的Token
3. 輸入Discord Client ID → 在開發(fā)者平臺“General Information”中獲取
4. 設(shè)置允許使用機(jī)器人的服務(wù)器ID（可選）
   - 如何獲取服務(wù)器ID：Discord開啟開發(fā)者模式后，右鍵服務(wù)器 → 復(fù)制ID
5. 確認(rèn)配置 → 輸入 y 保存

Step 3：啟動(dòng)Discord機(jī)器人網(wǎng)關(guān)

# 啟動(dòng)Hermes消息網(wǎng)關(guān)（后臺運(yùn)行）
hermes gateway start &
# 查看網(wǎng)關(guān)運(yùn)行狀態(tài)
hermes gateway status

若輸出“Discord gateway: running”，說明啟動(dòng)成功！

Step 4：測試Discord機(jī)器人

• 打開Discord，進(jìn)入你邀請機(jī)器人的服務(wù)器
• 在任意頻道發(fā)送 /start 指令，機(jī)器人回復(fù)歡迎消息
• 發(fā)送消息測試對話和工具調(diào)用，確認(rèn)機(jī)器人正常工作

?? 四、進(jìn)階配置（提升使用體驗(yàn)）

1. 后臺持久化運(yùn)行網(wǎng)關(guān)（關(guān)鍵）

直接用 hermes gateway start 啟動(dòng)，關(guān)閉終端后會(huì)停止，推薦用systemd設(shè)置開機(jī)自啟：

# 創(chuàng)建systemd服務(wù)文件
sudo vim /etc/systemd/system/hermes-gateway.service
# 寫入以下內(nèi)容（替換路徑為你的Hermes路徑）
[Unit]
Description=Hermes Agent Gateway
After=network.target
[Service]
User=root  # 可替換為你的用戶名
ExecStart=/root/.hermes/venv/bin/hermes gateway start
Restart=always  # 異常退出時(shí)自動(dòng)重啟
[Install]
WantedBy=multi-user.target
# 啟動(dòng)服務(wù)并設(shè)置開機(jī)自啟
sudo systemctl daemon-reload
sudo systemctl start hermes-gateway
sudo systemctl enable hermes-gateway
# 查看服務(wù)狀態(tài)
sudo systemctl status hermes-gateway

2. 配置多平臺同時(shí)運(yùn)行

Hermes支持同時(shí)啟動(dòng)Telegram和Discord網(wǎng)關(guān)，只需分別配置后，啟動(dòng)一次網(wǎng)關(guān)即可：

# 分別配置Telegram和Discord
hermes gateway setup  # 先配置Telegram，再配置Discord
hermes gateway start  # 啟動(dòng)后，兩個(gè)平臺同時(shí)可用

3. 權(quán)限控制（限制使用人員）

避免機(jī)器人被陌生人使用，可設(shè)置允許使用的用戶ID：

# 編輯配置文件
vim ~/.hermes/config.yaml
# 添加以下內(nèi)容（以Telegram為例）
gateway:
  telegram:
    allowed_user_ids: [123456789, 987654321]  # 允許使用的用戶ID列表
  discord:
    allowed_guild_ids: [123456789012345678]  # 允許使用的服務(wù)器ID列表

保存后，重啟網(wǎng)關(guān)即可生效。

?? 五、常見問題&解決方案

?? 六、總結(jié)&互動(dòng)引流

本文詳細(xì)講解了Hermes-Agent部署Telegram和Discord機(jī)器人的全過程，從機(jī)器人創(chuàng)建、Hermes配置到網(wǎng)關(guān)啟動(dòng)、測試，一步到位，讓你隨時(shí)隨地遠(yuǎn)程控制Hermes，真正實(shí)現(xiàn)AI智能體隨身化！

到此這篇關(guān)于Hermes-Agent 部署Telegram/Discord機(jī)器人的全過程(多平臺遠(yuǎn)程控制)的文章就介紹到這了,更多相關(guān)Hermes Agent 部署Telegram/Discord機(jī)器人內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論