LightVela

如何讓一個 Agent 同時接入 Telegram 和 WhatsApp,並保持統一人格與長期記憶?

Telegram 和 WhatsApp 可以作為同一個 Hermes Agent 的不同入口。

只要兩個通道都連接到同一個 Agent,它們就可以共享 Agent 級的人格、Skill、自動任務和長期記憶,但每個通道仍有自己的授權和消息限制。

一個 Agent 同時連接 Telegram 和 WhatsApp 並共享人格與長期記憶

摘要

Telegram 與 WhatsApp 可以作為同一個 Hermes Agent 的兩個入口:只要兩個通道連接到同一個 Agent,它們就共享 Agent 級的人格、Skill、自動任務與長期記憶,不需要為每個平台複製一份配置。 但「統一」有明確範圍——共享的是 Agent 級資產,每個通道仍保有各自的授權方式與消息限制,因此接入是兩次獨立的授權動作。驗證是否真的共享,最直接的方法是在一個通道説一件事,再到另一個通道詢問同一件事;能答出來才説明兩個入口指向同一個 Agent。接入新通道後還要確認回覆落在你發消息的那一條會話裏,避免投遞到錯誤會話。

適合誰

這篇指南適合希望在不同消息應用之間切換,同時保持同一個 AI 助手身份的用户。

它適合需要在 Telegram 和 WhatsApp 之間切換設備或聯繫人,也適合希望把個人助理、研究夥伴或客服草稿助手集中管理的用户。

先理解“統一”的範圍

同一個 Agent 不等於兩個通道實時共享完整聊天記錄。

兩個入口共享的是 Agent 級配置和長期上下文,當前對話中的全部消息仍然屬於各自的通道會話。

如果你希望另一端知道某個已經確認的事實,可以直接讓 Hermes 記住它,再在另一端繼續驗證。

人格、長期記憶和 Skill 屬於 Agent 層,而 Bot Token、掃碼授權、會話入口和消息格式屬於通道層。

前置條件

  • 一個已經運行中的 LightVela Hermes Agent。 如果你還沒有創建 Agent,可以先查看快速開始

  • 一個已經配置好的模型或可用的體驗積分。

  • 一個可以正常使用的 Telegram 賬號和 Bot。

  • 一個可以正常使用的 WhatsApp 賬號。

  • 瞭解 Telegram 和 WhatsApp 當前都以 1 對 1 對話為主要支持方式。

操作步驟

1. 先選定唯一的目標 Agent

打開 LightVela 管理台,先確定 Telegram 和 WhatsApp 都要連接到哪一個 Hermes Agent。

不要為每個通道分別創建一個 Agent,除非你確實希望它們擁有不同的人格、記憶和 Skill。

2. 接入 Telegram

按照配置通道 - Telegram創建 Bot,並把 HTTP API Token 填入目標 Agent 的 Telegram 通道設置。

在 Telegram 中發送一條測試消息,確認管理台顯示已接入,並確認回覆回到了預期的 Bot。

如果你還需要為 Telegram 配置獨立人格,可以參考如何在 Telegram 中配置一個具有獨立人格的 Hermes Agent

3. 接入 WhatsApp

在同一個 Hermes Agent 的通道設置中選擇 WhatsApp,按照配置通道 - WhatsApp完成掃碼授權。

在 WhatsApp 中打開對應的機器人聯繫人,發送一條測試消息,確認回覆正常返回。

如果你還需要為 WhatsApp 配置獨立人格,可以參考如何在 WhatsApp 中配置一個具有獨立人格的 Hermes Agent

4. 在 Agent 層設置統一人格

進入目標 Agent 的“人設”區域,確認 SOUL.md 中的角色、語氣、優先級和行為邊界適合兩個通道。

人格寫在 Agent 層,因此不需要在 Telegram 和 WhatsApp 中重複配置兩份。

如果需要修改人格,可以查看如何通過 SOUL.md 設定 IM Agent 的角色、性格與説話方式

修改後,分別在兩個通道開啓新會話並做一次自我檢查,確認新的人格已經生效。

5. 在 Agent 層配置記憶和用户畫像

在管理台打開“記憶”,確認 Agent 記憶和用户畫像的容量設置符合你的使用方式。

Telegram 和 WhatsApp 共享同一個雲端 Agent 的長期記憶,所以不需要分別錄入相同的身份、語言和偏好。

你可以在任一通道發送:

記住我希望所有日報先給結論,再給三條關鍵依據。

然後切換到另一個通道發送:

按照我之前設定的日報格式,給我一個簡短示例。

如果兩個通道表現不一致,先檢查它們是否確實連接到了同一個 Agent,再檢查當前會話是否需要發送 /new。

6. 只安裝一次需要共享的 Skill

Skill 屬於 Agent 的能力配置,不需要為 Telegram 和 WhatsApp 各安裝一份。

可以先在任一通道通過對話請求 Hermes 安裝 Skill,再讓它更新技能列表並用一個低風險任務驗證。

詳細步驟請查看配置技能,安全要求請先確認 Skill 的來源、權限和外部服務依賴。

7. 分別測試通道差異

用同一組問題在兩個通道各測試一次:

請介紹你現在的角色,並説明你會如何處理不確定的問題。

請按照我記錄的偏好,把這段內容整理成三條要點。

再測試一次通道特有的行為,例如媒體消息、主動提醒或 Bot 聯繫人顯示方式。

人格和長期記憶應該保持一致,但消息格式、媒體能力、授權方式和主動投遞限制可能不同。

一個 Agent、兩個入口的建議結構

同一個 Hermes Agent ├── 一份 SOUL.md ├── 一份 Agent 記憶和用户畫像 ├── 一套已安裝的 Skills ├── 一組自動任務 ├── Telegram 入口 └── WhatsApp 入口

自動任務的通知方式需要單獨選擇目標通道。

不要因為兩個通道共享 Agent,就默認每個提醒會同時發送到 Telegram 和 WhatsApp。

常見問題

在 Telegram 記住的內容會出現在 WhatsApp 嗎?

會,只要兩個通道連接的是同一個 Hermes Agent,並且內容已經寫入 Agent 的長期記憶或用户畫像。

當前 Telegram 會話中的每一句消息不會自動變成 WhatsApp 會話的實時聊天記錄。

為什麼兩個通道的語氣看起來不完全一樣?

通道的消息格式、媒體能力、會話狀態和模型輸出都會影響細節。

先確認兩端連接的是同一個 Agent,並在需要時發送 /new 讓新的 SOUL.md 在會話開始時加載。

可以給 Telegram 和 WhatsApp 配置不同人格嗎?

如果它們連接的是同一個 Agent,默認使用同一份 Agent 級人格。

如果確實需要完全不同的角色和記憶,應創建不同的 Agent,再分別連接對應通道。

WhatsApp 群組可以和 Telegram 一起共享嗎?

當前 WhatsApp 文檔明確説明不支持群聊,Telegram 也仍以 1 對 1 對話為支持範圍。

多通道共享解決的是 Agent 層的一致性,不會自動增加任一通道的群聊能力。

自動任務會同時發到兩個通道嗎?

不會自動同時發送。

創建或編輯自動任務時,需要確認通知方式和目標通道,並分別測試投遞結果。

下一步