配置通道 - Discord

Discord 通道採用 Bot 授權接入方式，適合將 Hermes Agent 接入 Discord 服務器，在頻道中提供問答、助手或社區互動能力。

本頁覆蓋

使用 Discord 打開邀請鏈接並完成授權
在 Discord 服務器或頻道中與 Hermes Agent 進行對話

操作步驟

1. 進入管理台

登錄 LightVela，點擊右上角「我的 Hermes」進入管理台，找到「通道」按鍵。

2. 選擇 Discord 通道

找到 Discord 模塊，點擊「+連接」。

3. 打開 Discord 並前往 Developer Portal

選擇你想加機器人的服務器，前往 Developer Portal：

點擊 Applications

點擊右上角的 New Applications
給你的 Application 起名
為你的應用程序添加一個機器人，並生成一個機器人令牌。該令牌將用於驗證 Hermes Agent 與您的 Discord 服務器之間的連接。

把 Token 複製入 Discord 模塊裏。

4. 前往 Developer Portal 裏的 Bot 頁面

在 Bot 頁面下滑至 Privileged Gateway Intents，開啓：

Message Content Intent：必選，用於讀取消息內容
Server Members Intent：推薦，用於角色列表和名稱匹配 ID
Presence Intent：可選，僅用於狀態更新

勾選後，點擊下方 Save Changes 保存。

5. 前往 Developer Portal 裏的 OAuth2 頁面

配置 Bot 權限：點擊頁面左側 OAuth2，進入後選擇 OAuth2 URL Generator。先配置 Scopes，建議按最小權限原則，優先勾選 bot 和 applications.commands。

繼續向下滑動配置 Bot Permissions，勾選：

View Channels
Send Messages
Read Message History
Embed Links
Attach Files
Add Reactions（可選）

6. 複製並粘貼邀請鏈接

複製生成的 Invite Link，在瀏覽器中打開，並將 Bot 邀請到你的 Discord 服務器（需要服務器管理員權限）。點擊 Continue 完成授權後，即可邀請 Bot 加入服務器。

7. 與 Discord 裏新的機器人聊天

現在你就可以開始與它互動了。進入該機器人的聊天界面，發送測試消息：

你好

幾秒內收到 Hermes Agent 回覆。

成功狀態

管理台「已接入通道」列表中出現"Discord"
Discord 聯繫人中可查找到對應機器人
發送消息後能收到 Hermes Agent 回覆

支持的消息類型

接入成功後，Discord 機器人除了能夠接收、回覆基礎文本信息外，還支持更多消息類型，詳情如下：

Discord 機器人支持的消息類型	是否支持
接收文本信息	✅ 已支持
接收圖片、視頻	✅ 已支持
接收文件	✅ 已支持
回覆文本信息	✅ 已支持
回覆圖片、視頻	✅ 已支持
回覆文件	✅ 已支持
主動發送消息（如定時發送提醒）	✅ 已支持

常見問題

現象	可能原因	處理方式
無法創建 Discord Bot	未進入 Discord Developer Portal，或應用創建流程未完成	進入 Discord Developer Portal，創建 Application 後再添加 Bot
找不到 Bot Token	Token 未生成或未複製完整	在 Bot 頁面點擊 Reset Token / Copy Token，複製完整 Token 後粘貼到 token 欄位
粘貼 Token 後提示無效	Token 複製不完整，或包含多餘空格/換行	重新複製完整 Bot Token，並確認沒有多餘空格
無法邀請機器人到服務器	OAuth2 URL 配置錯誤，或當前賬號沒有服務器管理權限	在 OAuth2 URL Generator 中勾選 bot 權限，並確認你擁有該服務器的管理權限
邀請後服務器中看不到機器人	邀請未完成，或機器人未上線	重新打開邀請鏈接確認授權成功；刷新 Discord 服務器成員列表
發送消息後無回覆	模型未配置、體驗積分耗盡，或 Discord 通道尚未成功接入	檢查「1. 模型」卡片的「當前模型」狀態，並確認 Discord 通道顯示為已接入
機器人無法讀取消息內容	Message Content Intent 未開啓	在 Discord Developer Portal 的 Bot 設置中開啓 Message Content Intent
機器人在頻道中無權限回覆	頻道權限不足	確認機器人擁有查看頻道、發送消息、讀取消息歷史等權限
機器人無法接收私信	私信權限或用户隱私設置限制	確認機器人允許接收私信，並檢查用户的 Discord 隱私設置
如何解除綁定	—	在「已接入通道」列表中刪除該 Discord 記錄
同一個 Discord Bot 能否接入多個 Hermes Agent	通常不建議，一個 Bot Token 應綁定一個 Hermes Agent	如需多個 Hermes Agent，建議分別創建不同的 Discord Bot

通道説明

消息類型：支持文本、圖片、視頻、文件、語音等多種類型，詳見上方「支持的消息類型」
群聊支持：當前不支持群聊，僅支持 1 對 1 對話
連接中斷：長時間無響應可能為授權被撤銷，回管理台重新授權接入即可

下一步

配置通道 - QQ — 手動創建機器人，AppID/AppSecret 接入
配置通道 - 企業微信 — 企業內部協作與辦公場景
配置通道 - 飛書 — 辦公場景，支持富文本與群聊
配置技能 — 擴展 Hermes Agent 能力

Discord

本頁目錄