配置通道 - WhatsApp
摘要
WhatsApp 通道採用掃碼接入，配置方式接近 WeChat，適合快速把 Hermes Agent 接入 WhatsApp 對話場景：在管理台「通道」中選擇 WhatsApp、生成二維碼後用手機 WhatsApp 掃碼完成授權即可對話。準備工作是一台裝有 WhatsApp 的手機，以及完成模型配置（或直接使用套餐按月提供的模型積分）。同一個 Agent 可同時接入多個通道並共享同一份人格與長期記憶。
WhatsApp 通道採用掃碼接入方式，配置方式接近 WeChat，適合快速將 Hermes Agent 接入 WhatsApp 對話場景。
本頁覆蓋
-
使用手機 WhatsApp 掃碼授權
-
在 WhatsApp 中與 Hermes Agent 進行對話
操作步驟
1. 進入管理台
登錄 LightVela，選擇目標 Bot，在控制台打開日常 → 通道。
2. 選擇 WhatsApp 通道
找到 WhatsApp 模塊，點擊「+連接」。
同一 LightVela 實例內，WhatsApp 同時只能連接一個 Bot。如果已由其他 Bot 連接，請通過佔用提示前往原 Bot 斷開 WhatsApp，再在當前 Bot 連接。
3. 使用 WhatsApp 掃碼
用手機 WhatsApp 掃描 LightVela 展示的二維碼，並按 WhatsApp 內的提示授權關聯會話。二維碼過期時從 WhatsApp 卡片重新生成。返回 通道，確認 WhatsApp 顯示為已接入。
4. 在 WhatsApp 裏查詢你自己
與自我對話——這就是你的機器人。
進入該機器人的聊天界面，發送測試消息：
你好幾秒內收到 Hermes Agent 回覆。
成功狀態
-
在 WhatsApp 卡片確認顯示 已連接，再從該平台發送測試消息。
-
WhatsApp 聯繫人中可查找到對應機器人
-
發送消息後能收到 Hermes Agent 回覆
支持的消息類型
接入成功後，WhatsApp 機器人除了能夠接收、回覆基礎文本信息外，還支持更多消息類型，詳情如下：
| WhatsApp 機器人支持的消息類型 | 是否支持 |
|---|---|
| 接收文本信息 | ✅ 已支持 |
| 接收圖片、視頻 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 回覆文本信息 | ✅ 已支持 |
| 回覆圖片、視頻 | ✅ 已支持 |
| 回覆文件 | ✅ 已支持 |
| 主動發送消息（如定時發送提醒） | ✅ 已支持 |
常見問題
| 問題 | 檢查點 | 處理方式 |
|---|---|---|
| 二維碼無法掃描或已過期 | 手機網絡與當前二維碼 | 在 WhatsApp 卡片生成新碼，按 WhatsApp 當前提示操作。 |
| 管理台未顯示接入成功 | 手機端是否完成授權 | 回到 通道 刷新一次；仍未接入時重新連接。 |
| 發消息後沒有回覆 | Agent 狀態、通道狀態和模型積分 | 查看 通道 與診斷中心，必要時核對積分補充方式。 |
| 定時消息未送達 | 通道連接與任務運行結果 | 在定時任務查看最近運行記錄及通知目的地。 |
| WhatsApp 已被其他 Bot 佔用 | 同一實例只允許一個 Bot 接入 WhatsApp | 先在原 Bot 斷開，再連接到目標 Bot。 |
通道説明
-
消息類型：支持文本、圖片、視頻、文件、語音等多種類型，詳見上方「支持的消息類型」
-
群聊支持：當前不支持群聊，僅支持 1 對 1 對話
-
連接中斷：長時間無響應可能為授權被撤銷，回管理台重新連接即可
下一步
-
配置通道 - Discord — 社群運營與開發者社區
-
配置通道 - Slack — 團隊協作、工作區通知和頻道任務流轉
-
配置通道 - QQ — 手動創建機器人，AppID/AppSecret 接入
-
配置通道 - 企業微信 — 企業內部協作與辦公場景
-
配置技能 — 擴展 Hermes Agent 能力
最后更新于 2026-10-19