🤖HermesBlog
Hermes 消息平台接入 · 第9篇2026/8/9· Easy Understand Hermes Agent

Matrix 接入——去中心化聊天网络

Hermes 消息平台接入第9篇:Matrix。开源去中心化聊天协议接入。

messaging-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