Matrix 设置
Hermes Agent 与 Matrix 集成，Matrix 是一个开放的联邦消息协议。机器人通过 mautrix Python SDK 连接。
行为
| 上下文 | 行为 |
|---|---|
| DM | Hermes 响应每条消息，无需 @mention |
| 房间 | 默认需要 @mention；设置 MATRIX_REQUIRE_MENTION=false |
| 线程 | 支持 Matrix 线程；自动创建线程响应 |
设置步骤
步骤 1：创建机器人账户
在 Synapse 上：
register_new_matrix_user -c /etc/synapse/homeserver.yaml http://localhost:8008
步骤 2：获取访问令牌
通过 Element：Settings → Help & About → Advanced → 访问令牌
步骤 3：配置 Hermes
hermes gateway setup # 选择 Matrix
或手动：
MATRIX_HOMESERVER=https://matrix.example.org
MATRIX_ACCESS_TOKEN=你的令牌
MATRIX_ALLOWED_USERS=@alice:matrix.example.org
端到端加密（E2EE）
pip install 'mautrix[encryption]'
# 需要 libolm
MATRIX_ENCRYPTION=true
故障排除
| 问题 | 解决方案 |
|---|---|
| 机器人不响应 | 检查机器人已加入房间，MATRIX_ALLOWED_USERS 包含你的用户 ID |
| E2EE 错误 | 安装 libolm，设置 MATRIX_ENCRYPTION=true |
安全
注意
始终设置 MATRIX_ALLOWED_USERS 限制谁可以与机器人交互。