🤖HermesBlog
Hermes Messaging Platforms · Parte 98/9/2026

Matrix — Mạng Lưới Trò Chuyện Phi Tập Trung

Matrix — Decentralized Chat Network — easy-to-understand guide based on official docs

messaging-matrix

Matrix — Mạng Lưới Trò Chuyện Phi Tập Trung

Nếu bạn từng muốn có một mạng lưới trò chuyện mà mình không bị khóa cứng vào máy chủ của người khác, thì Matrix chính là câu trả lời. Đây là một giao thức nhắn tin mở, liên bang — cứ nghĩ như email, nhưng dành cho nhắn tin tức thời. Bạn có thể tự vận hành homeserver của riêng mình, hoặc dùng một máy chủ công cộng như matrix.org. Dù chọn cách nào, bạn vẫn nắm quyền kiểm soát cuộc trò chuyện của mình.

Hermes Agent kết nối trực tiếp vào Matrix thông qua Python SDK mautrix. Điều đó có nghĩa là bot của bạn có thể trò chuyện với bạn qua Matrix, sử dụng tất cả sức mạnh Hermes mà bạn đã biết và yêu thích — sử dụng công cụ, ghi nhớ, suy luận và phản hồi theo thời gian thực. Nó xử lý văn bản, tệp tin, hình ảnh, âm thanh, video và thậm chí cả mã hóa đầu cuối (E2EE) tùy chọn.

Và phần tuyệt nhất: Hermes hoạt động với bất kỳ homeserver Matrix nào. Synapse, Conduit, Dendrite, hoặc máy chủ công cộng lớn tại matrix.org — cứ chọn loại bạn thích.

Cách Hermes Hoạt Động

Khi đã kết nối, Hermes có một số thiết lập mặc định thông minh. Đây là bảng tóm tắt nhanh:

Ngữ cảnh Hành vi
Tin nhắn riêng (DM) Hermes trả lời mọi tin nhắn. Không cần phải @đề cập đến nó. Mỗi DM có một phiên (session) riêng.
Phòng (Rooms) Theo mặc định, Hermes chờ được @đề cập trước khi phản hồi. Bạn có thể thay đổi điều này bằng MATRIX_REQUIRE_MENTION=false hoặc thêm các phòng cụ thể vào MATRIX_FREE_RESPONSE_ROOMS. Lời mời vào phòng được tự động chấp nhận.
Threads (Chuỗi hội thoại) Hermes hỗ trợ đầy đủ threads của Matrix. Trả lời trong một thread, và Hermes giữ ngữ cảnh đó tách biệt với dòng thời gian chính của phòng. Các thread mà bot đã tham gia thì không cần đề cập đến.
Tự động tạo thread Theo mặc định, Hermes tự động tạo một thread cho mỗi phản hồi trong phòng. Điều này giúp cuộc trò chuyện gọn gàng và tách biệt. Tắt tính năng này bằng MATRIX_AUTO_THREAD=false.
Lệnh Các lệnh /commands thông thường hoạt động như mong đợi. Nếu ứng dụng của bạn dành riêng / cho lệnh cục bộ, chỉ cần dùng !commands — Hermes tự động chuẩn hóa các bí danh đó.
Điều khiển tương tác Phê duyệt cho các lệnh nguy hiểm và chọn lựa /model có thể sử dụng phản ứng (reactions) của Matrix. Bạn thậm chí có thể giới hạn phản ứng phê duyệt chỉ dành cho người dùng đã yêu cầu hành động đó.
Hoạt động suy luận và công cụ Hermes sử dụng các khung (pane) có thread và chỉnh sửa được cho hoạt động suy luận và công cụ khi tính năng tiến trình cổng (gateway progress) được bật. Không còn cảnh làm ngập dòng thời gian chính với các cập nhật nữa.
Phòng chia sẻ Theo mặc định, Hermes cô lập lịch sử phiên theo từng người dùng trong một phòng. Hai người trong cùng một phòng không dùng chung một bản ghi hội thoại trừ khi bạn tắt tính năng này một cách rõ ràng.

Mẹo chuyên nghiệp: Chỉ cần mời người dùng Matrix của bot vào bất kỳ phòng nào, nó sẽ tham gia và bắt đầu phản hồi tự động.

Hermes Có Thể Làm Gì Trên Matrix

Đây là danh sách đầy đủ các khả năng, trực tiếp từ khai báo của adapter:

  • Văn bản — có
  • Threads — có
  • Phản ứng (Reactions) — có
  • Phê duyệt — có
  • Bộ chọn mô hình — có
  • Khung suy luận — có
  • Hình ảnh — có (bao gồm nhiều hình ảnh)
  • Tệp tin — có
  • Thoại/âm thanh — có
  • Video — có
  • E2EE — tắt / tùy chọn / bắt buộc (theo chế độ)
  • Chẩn đoán — có

Mô Hình Phiên Trong Matrix

Theo mặc định, Hermes giữ mọi thứ được phân tách gọn gàng:

  • Mỗi DM có một phiên riêng
  • Mỗi thread có một không gian tên phiên riêng
  • Mỗi người dùng trong một phòng chia sẻ có phiên riêng trong phòng đó

Điều này được kiểm soát bởi config.yaml:

group_sessions_per_user: true

Chỉ đặt thành false nếu bạn thực sự muốn một cuộc trò chuyện dùng chung cho toàn bộ phòng:

group_sessions_per_user: false

Phiên dùng chung có thể hữu ích cho một phòng hợp tác, nhưng hãy cẩn thận: người dùng sẽ chia sẻ sự tăng trưởng ngữ cảnh và chi phí token, một người thực hiện tác vụ dài với nhiều công cụ có thể làm phình to ngữ cảnh của mọi người khác, và một tác vụ đang chạy của người này có thể làm gián đoạn tác vụ tiếp theo của người khác.

Cấu Hình Đề Cập và Threading

Bạn có thể tinh chỉnh mọi thứ qua biến môi trường hoặc config.yaml. Đây là phiên bản YAML:

matrix:
  require_mention: true           # Yêu cầu @đề cập trong phòng (mặc định: true)
  allowed_users:                  # Người dùng Matrix được phép kích hoạt lượt tác động của agent
    - "@alice:matrix.org"
  allowed_rooms:                  # Phòng Matrix được phép kích hoạt lượt tác động của agent
    - "!abc123:matrix.org"
  free_response_rooms:            # Phòng được miễn yêu cầu đề cập
    - "!abc123:matrix.org"
  ignore_user_patterns:           # Người dùng ảo từ bridge/appservice cần bỏ qua
    - "^@telegram_"
    - "^@whatsapp_"
  process_notices: false          # Bỏ qua m.notice theo mặc định
  session_scope: room             # auto|room|thread; room được khuyến nghị cho phòng dự án
  auto_thread: true               # Tự động tạo thread cho phản hồi (mặc định: true)
  dm_mention_threads: false       # Tạo thread khi được @đề cập trong DM (mặc định: false)
  max_message_length: 16000       # Kích thước khối tin nhắn gửi đi tính bằng ký tự (mặc định: 16000, tối đa: 65535)

Hoặc qua biến môi trường:

MATRIX_REQUIRE_MENTION=true
MATRIX_ALLOWED_USERS=@alice:matrix.org
MATRIX_ALLOWED_ROOMS=!abc123:matrix.org
MATRIX_FREE_RESPONSE_ROOMS=!abc123:matrix.org,!def456:matrix.org
MATRIX_IGNORE_USER_PATTERNS='^@telegram_,^@whatsapp_'
MATRIX_PROCESS_NOTICES=false
MATRIX_SESSION_SCOPE=room       # được khuyến nghị cho ngữ cảnh phòng dự án ổn định
MATRIX_AUTO_THREAD=true
MATRIX_DM_MENTION_THREADS=false
MATRIX_REACTIONS=true          # mặc định: true — phản ứng emoji trong quá trình xử lý
MATRIX_ALLOW_ROOM_MENTIONS=false

Mẹo: MATRIX_REACTIONS=false sẽ tắt các phản ứng emoji theo vòng đời xử lý (👀/✅/❌) mà bot đăng trên các tin nhắn đến. Hữu ích cho các phòng nơi sự kiện phản ứng gây nhiễu hoặc không được hỗ trợ.

Mẹo nữa: Hermes gửi các đề cập người dùng Matrix có cấu trúc cho các ID rõ ràng như @alice:example.org. Các đề cập @room trên toàn phòng được kiểm soát riêng biệt.

Đó là toàn cảnh về Matrix. Dù bạn tự vận hành homeserver của riêng mình hay chỉ muốn một cuộc trò chuyện phi tập trung tôn trọng quyền riêng tư của bạn, Hermes đều đáp ứng được. Hãy mời bot vào một phòng và xem nó hoạt động thực tế nhé!

📖 Tài liệu chính thức

この記事は Hermes Agent のTài liệu chính thứcに基づいています:Tài liệu chính thức › user-guide/messaging/matrix