Matrix 接入——去中心化聊天网络 | Easy Understand Hermes Agent

这篇教程将带你一步步把 Hermes Agent 接入 Matrix——一个像微信群聊一样自由、但数据完全由你自己掌控的去中心化聊天网络。

Matrix 是什么？先打个比方

想象一下，Matrix 就像是一个“自建邮局”的聊天系统。你既可以用公共邮局（matrix.org），也可以在自己家里搭一个私人邮局（自建 homeserver）。无论哪种方式，你寄出的每封信（消息）都归你管，别人没法偷看。Hermes 就是这个邮局里的一个“智能管家”，你发消息给它，它就能帮你干活。

第 1 步：给机器人“办个身份证”（创建账号）

Hermes 需要一个 Matrix 账号才能“上岗”。有三种方式：

方式 A（推荐）：如果你有自己的服务器，用命令创建一个账号，就像在小区物业登记一个新住户：
```
register_new_matrix_user -c /etc/synapse/homeserver.yaml http://localhost:8008
```
用户名取 hermes，那它的完整 ID 就是 @hermes:你的服务器地址。
方式 B：不想折腾服务器？直接去 app.element.io 注册一个公共账号，就像用手机号注册微信一样简单。
方式 C：用你自己的账号。机器人会以你的身份发言，适合当个人助理。

第 2 步：拿一把“钥匙”（获取访问令牌）

这个令牌相当于机器人的“门禁卡”，证明它是本人。

最简单的方法：用 Element 登录机器人账号 → 点右上角头像 → 设置 → 帮助与关于 → 展开高级，就能看到访问令牌。复制它，保存好。

第 3 步：告诉 Hermes“钥匙”放在哪（配置环境变量）

在 Hermes 的配置里填上令牌和服务器地址，就像把钥匙挂在门口指定位置：

export MATRIX_HOMESERVER="https://matrix.org"   # 或你自己的服务器地址
export MATRIX_ACCESS_TOKEN="你的令牌"

第 4 步：设置机器人的“性格”（行为规则）

Hermes 默认很“矜持”——在群里必须 @它才回应，但私聊里它秒回。你可以调整：

想让它在群里主动说话：设置 MATRIX_REQUIRE_MENTION=false
想让它把每条回复都开个“子话题”（避免刷屏）：保持默认 MATRIX_AUTO_THREAD=true
想限制谁能使唤它：用 MATRIX_ALLOWED_USERS=@alice:matrix.org 指定白名单

第 5 步：把它拉进群，开始聊天！

直接把机器人账号拉进任何房间，它会自动接受邀请并开始工作。 就像把管家请进家门，它自己就知道该干嘛。

试试发一条消息：“帮我查一下明天的天气”，如果配置正确，它会立刻回复你。

小总结

Matrix 接入的核心就三步：建账号 → 拿令牌 → 配环境。它最大的好处是数据自主——你完全掌控自己的聊天记录和机器人行为。Hermes 在 Matrix 里还支持图片、文件、语音，甚至端到端加密，非常强大。

下篇预告：机器人只会聊天还不够，下一篇我们讲讲如何给 Hermes 装上“手脚”——接入 Telegram，让它能主动给你发通知、推送文件，敬请期待！