Hermes 消息平台接入 · 第9篇2026/8/9· Easy Understand Hermes Agent
Matrix 接入——去中心化聊天网络
Hermes 消息平台接入第9篇:Matrix。开源去中心化聊天协议接入。
Matrix 接入——去中心化聊天網路
嘿,朋友們!今天咱們來聊聊 Hermes Agent 的 Matrix 接入。如果你還沒聽說過 Matrix,簡單說就是一個開放、去中心化的聊天協定——你可以自己搭伺服器(比如 Synapse、Conduit 或 Dendrite),也可以用公共的 matrix.org,反正資料永遠在你手裡。
連上之後,Hermes 會怎麼表現?
這是大家最關心的問題,直接看表格:
| 場景 | 行為 |
|---|---|
| 私聊(DM) | 每條訊息都回覆,不需要 @ 它。每個私聊獨立會話。 |
| 群聊(Rooms) | 預設需要 @Hermes 才回覆。想讓它自由發言?設定 MATRIX_REQUIRE_MENTION=false 或加入 MATRIX_FREE_RESPONSE_ROOMS。 |
| 執行緒(Threads) | 支援 MSC3440 執行緒。你在執行緒裡回覆,上下文就隔離在執行緒裡,不污染主聊天室。 |
| 自動建執行緒 | 預設每條回覆都會自動開執行緒,保持對話隔離。想關掉?MATRIX_AUTO_THREAD=false。 |
| 指令 | 支援 /commands。如果你的用戶端把 / 佔了,用 !commands 也行,Hermes 會自動轉換。 |
| 互動控制 | 危險指令審批、模型切換都可以用表情反應(reactions)操作。 |
最爽的是:邀請機器人進房間,它自動加入,不用手動操作。
會話模型:每個人都有自己的小天地
預設情況下:
- 每個私聊獨立會話
- 每個執行緒獨立命名空間
- 群聊裡每個使用者獨立會話(互不干擾)
這是由 config.yaml 控制的:
group_sessions_per_user: true
如果你想要整個房間共享一個對話(比如協作專案房),改成 false 就行。但注意:共享意味著上下文和 token 費用也共享,一個人跑個大任務,其他人都會受影響。
設定速查
環境變數方式:
MATRIX_REQUIRE_MENTION=true
MATRIX_AUTO_THREAD=true
MATRIX_DM_MENTION_THREADS=false
MATRIX_FREE_RESPONSE_ROOMS=!abc123:matrix.org
MATRIX_REACTIONS=true # 處理中顯示 👀/✅/❌ 表情
或者 config.yaml 方式:
matrix:
require_mention: true
auto_thread: true
session_scope: room # auto|room|thread,專案房推薦 room
max_message_length: 16000
小貼士
MATRIX_REACTIONS=false可以關掉處理中的表情反應,適合表情雜訊大的房間- 支援端到端加密(E2EE),可選關閉/可選/強制三種模式
- 支援文字、圖片、檔案、音訊、影片,基本啥都能發
Matrix 接入就是這麼簡單又強大。去中心化聊天 + AI 助手,這組合夠酷吧?快去試試!
📖 官方文档
本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › user-guide/messaging/matrix