元宝接入——腾讯 AI 助手 | Easy Understand Hermes Agent

這篇教學將手把手教你如何把 Hermes Agent 智慧體接入騰訊元寶，讓 AI 助手在你的企業聊天裡隨叫隨到。

準備工作：先備好三樣東西

就像出門旅行前要檢查身分證、錢包和手機一樣，接入元寶前你需要：

一個元寶帳號（要有建立機器人的權限）
APP_ID 和 APP_SECRET（相當於機器人的「門牌號碼」和「鑰匙」，找平台管理員要）
安裝幾個 Python 小工具——別怕，只需一條指令：

pip install websockets httpx aiofiles

第1步：在元寶裡建立機器人

打開元寶 App（https://yuanbao.tencent.com/），找到 PAI → 我的機器人，點「新建」。建立成功後，你會看到一串 APP_ID 和一串 APP_SECRET——把它們複製下來，這就是機器人的身分證和鑰匙。

第2步：執行設定精靈（偷懶神器）

Hermes 提供了一個互動式精靈，你只需要在終端機輸入：

hermes gateway setup

然後按提示選擇 Yuanbao，貼上剛才複製的 APP_ID 和 APP_SECRET，剩下的它全幫你搞定。WebSocket 位址和 API 網域都內建了預設值，不用你操心。

第3步：檢查設定檔

精靈儲存後，打開 ~/.hermes/.env 檔案，確認這些關鍵資訊都在：

YUANBAO_APP_ID=你的應用程式ID
YUANBAO_APP_SECRET=你的應用程式金鑰
YUANBAO_WS_URL=wss://api.yuanbao.example.com/ws
YUANBAO_API_DOMAIN=https://api.yuanbao.example.com

第4步：啟動閘道，讓機器人「上線」

hermes gateway

看到連線成功的日誌，你的機器人就正式「上崗」了！

機器人能幹什麼？

接入後，你的機器人就像是全能助理：

私聊和群聊都能聊——直接對話或拉進群都行
收發圖片、檔案、語音——自動上傳到騰訊雲 COS
支援 Markdown 排版——長訊息會自動分段，不怕超限
自動重連——網路斷了會自己爬回來，不用你管
微信聊天記錄解析——使用者轉發微信聊天記錄進來，機器人能讀懂完整對話

設定「家庭頻道」：定時任務的收件匣

想像一下，機器人每天定時彙報工作，結果發到哪個群？這就需要設定家庭頻道。

在任何對話裡傳送 /sethome，機器人就會回覆：「家庭頻道已設定為 [聊天名稱]」。之後所有定時任務（比如每天早上9點的伺服器狀態報告）都會自動發到這裡。

小技巧：如果你不設定，第一個給機器人發訊息的人會自動成為家庭頻道主人。

遇到問題？常見故障排除

問題	原因	解決
機器人不回覆	認證失敗	檢查 APP_ID/APP_SECRET 是否正確
連線被拒絕	網路不通	確認 wss:// 開頭的位址能存取
圖片發不出去	COS 權限問題	找管理員確認上傳權限
老掉線	網路不穩定	查看日誌 `tail -f ~/.hermes/logs/gateway.log`

安全設定：誰能跟機器人聊天？

你還可以精細控制誰能私聊機器人、誰能拉它進群：

# 私聊策略：open（所有人）/ allowlist（白名單）/ disabled（關閉）
YUANBAO_DM_POLICY=open
# 群聊策略同理
YUANBAO_GROUP_POLICY=open

總結一下：接入元寶只需四步——建立機器人、跑精靈、檢查設定、啟動閘道。之後你的 AI 助手就能在企業聊天裡收發訊息、處理檔案、定時彙報了。

下篇預告：機器人接入只是開始，下一篇我們來聊聊如何用 Hermes 的定時任務（Cron）讓機器人主動幹活——比如每天早上自動整理待辦清單，敬請期待！