如何在 Hermes Agent 中透過 Telegram 傳送圖片

📖 前言

本文將一步步教你在 Hermes Agent 中設定 MiniMax MCP，生成圖片後自動傳送到 Telegram。適合第一次接觸 Hermes Agent 的新手閱讀。

---

🐕 什麼是 Hermes Agent？

Hermes Agent 是由 Nous Research 開發的開源 AI 助理。它具有以下特色：

• 跨平臺支援：可在 CLI、Telegram、Discord、Slack 等平臺運行
• 持久記憶：會記住對話內容和用戶偏好
• MCP 工具擴展：可連接各種 MCP 伺服器（像是 MiniMax）來增強功能
• 自學習能力：使用越多，效果越好

---

🎯 本文目標

1. 設定 MiniMax MCP（用於生成 AI 圖片）
2. 設定 Telegram 接收頻道
3. 學會如何傳送圖片到 Telegram

---

📦 前置需求

• 已安裝 Hermes Agent
• 已有 MiniMax API Key（從 MiniMax 開放平臺 取得）
• Telegram Bot Token（可透過 @BotFather 取得）

---

步驟一：安裝 mcporter（MCP 管理工具）

MCP 伺服器需要透過 mcporter 來管理。首先用 npm 安裝：

npm install -g mcporter

驗證安裝成功：

mcporter --version

---

步驟二：設定 MiniMax MCP

2.1 設定圖片生成 MCP

MiniMax 提供兩種主要的 MCP：

MCP 名稱	功能
minimax-coding-plan-mcp	聯網搜尋、圖片理解
minimax-mcp	圖片生成、音樂、語音、影片生成

加入 minimax-mcp（圖片生成）：

mcporter config add minimax-mcp \
 --command uvx \
 --arg minimax-mcp \
 --env MINIMAX_API_KEY="你的API Key" \
 --env MINIMAX_API_HOST="https://api.minimaxi.com" \
 --description "MiniMax Image Generation MCP"

2.2 驗證 MCP 是否正常運作

查看可用的工具：

mcporter list-tools minimax-mcp

測試生成一張圖片：

mcporter call minimax-mcp.text_to_image \
 prompt="cute cat" \
 n=1

成功時會回傳圖片 URL。

---

步驟三：設定 Telegram 頻道

3.1 找出你的 Telegram Chat ID

當你傳送訊息給 Bot 後，可從以下位置找到 Chat ID：

~/.hermes/sessions/

或者查看日誌：

grep "telegram" ~/.hermes/processes.json

找到類似 "session_key": "agent:main:telegram:dm:你的Chat ID" 的內容，數字部分就是你的 Chat ID。

3.2 設定 Hermes 組態

開啟 ~/.hermes/config.yaml，在 telegram 區塊設定 home_channel：

telegram:
 reactions: false
 channel_prompts: {}
 home_channel: "你的Chat ID" # 例如：你的Chat ID

3.3 重啟 Gateway 使設定生效

hermes gateway restart

---

步驟四：傳送圖片到 Telegram

4.1 透過 Hermes Agent 傳送（推薦）

當你使用 Hermes Agent 的 Telegram 對話時，只需在訊息中包含：

MEDIA:/檔案路徑

例如：

這是我生成的圖片 🐱
MEDIA:/tmp/cat_image.jpg

圖片會自動以原生格式發送到 Telegram。

4.2 透過 send_message 工具傳送

在程式碼中使用：

send_message(
 message="這是我生成的圖片 🐱\nMEDIA:/tmp/cat_image.jpg",
 target="telegram:你的ChatID"
)

---

💡 完整範例

以下是一個完整的對話流程：

使用者：幫我生成一張可愛小貓的圖片

Hermes：

mcporter call minimax-mcp.text_to_image prompt="一隻可愛的小貓在草地上玩耍" n=1

（回傳圖片 URL）

Hermes 傳送到 Telegram：

✅ 圖片生成完成！

MEDIA:/tmp/cat_image.jpg

---

🔧 常用指令參考

指令	說明
mcporter list-tools <mcp名稱>	列出 MCP 的所有工具
mcporter call <mcp>.<工具> <參數>	呼叫特定工具
hermes gateway status	查看 Gateway 狀態
hermes gateway restart	重啟 Gateway
hermes config set telegram.home_channel "ID"	設定 Telegram 頻道

---

⚠️ 常見問題

Q：出現「No home channel set」錯誤？

確保在 ~/.hermes/config.yaml 中設定了正確的 home_channel 值（你的 Telegram Chat ID），然後重啟 Gateway。

Q：MCP 測試成功但無法生成圖片？

檢查 API Key 是否正確，以及 API Key 是否有足夠的額度。

Q：圖片無法在 Telegram 中顯示？

確保 MEDIA: 後面使用的是絕對路徑，例如 /tmp/catimage.jpg 而不是 catimage.jpg。

---

🎉 恭喜完成！

現在你已經學會：

• 如何設定 MiniMax MCP 生成圖片
• 如何設定 Telegram 頻道接收檔案
• 如何傳送圖片到 Telegram

如果想要更深入瞭解 Hermes Agent 的其他功能，可以參考 MiniMax 開放平臺文檔。

---

文章更新日期：2026年5月7日