简要总结
Matrix
这页说明书在教你如何让你的 OpenClaw 小助手通过一个叫 Matrix 的“聊天大广场”来和你聊天。Matrix 就像一个有很多房间的大楼，每个人都可以有自己的小房间。你需要先给你的小助手一个进入大楼的“钥匙”（安装插件），再帮它办一张“身份证”（创建账户），它就能在广场里和你私聊，或者加入你邀请它去的房间了。如果你想让你们的悄悄话只有你们俩能看懂，还可以打开一个叫“E2EE”的魔法锁。
五岁小孩版解释
第一步：给你的小助手装上“聊天大广场”的耳朵
首先，你的 OpenClaw 小助手需要安装一个特别的“耳朵”才能听到 Matrix 广场里的声音。这个“耳朵”是一个插件，就像给你的玩具装上一个新零件。
- 安装插件：你需要打开电脑的命令行（就像对电脑说话的小窗口），然后告诉它安装这个零件。
- 从网上商店安装，输入：
openclaw plugins install @openclaw/matrix - 如果你是从一个叫“git”的代码仓库自己运行 OpenClaw，可以输入：
openclaw plugins install ./extensions/matrix
- 从网上商店安装，输入：
第二步：帮你的小助手办一张“广场身份证”
现在，你的小助手需要一个在 Matrix 广场里用的身份。这就像给它办一张学生证。
创建账户：你需要先找一个“大楼管理员”（这叫做 homeserver）。你可以去 https://matrix.org/ecosystem/hosting/ 这个网站看看有哪些管理员，或者自己当管理员。
拿到“入场门票”：有了账户（用户名和密码）后，小助手还需要一张“门票”（access token）才能进场。有两种方法拿票：
- 用
curl这个工具向你的大楼管理员（homeserver）要票。你需要把命令里的matrix.example.org换成你管理员的地盘，your-user-name和your-password换成你给小助手起的名字和密码。 - 或者，更简单的方法：你直接在 OpenClaw 的设置里写上小助手的用户名 (
channels.matrix.userId) 和密码 (channels.matrix.password)。小助手会自己去要票，并把票好好存起来下次用。
- 用
告诉小助手门票信息：你需要把大楼的地址和门票告诉小助手。可以通过两种方式：
- 设置电脑的环境变量：
MATRIX_HOMESERVER（大楼地址）和MATRIX_ACCESS_TOKEN（门票）。 - 或者在 OpenClaw 的配置文件里写：
channels.matrix.homeserver和channels.matrix.accessToken。 - 要小心：如果两种方式都写了，配置文件里的会更厉害，小助手会听配置文件的。
- 设置电脑的环境变量：
重启小助手：告诉小助手这些新消息后，需要让它休息一下再醒来（重启网关），或者完成一开始的设置向导。
开始聊天：现在，你可以用任何一个 Matrix 的聊天软件（比如 Element 或 Beeper）去找你的小助手了！你可以直接给它发私信，或者把它邀请到你所在的房间。注意：如果用 Beeper 软件，需要打开“魔法锁”（E2EE），也就是在设置里把
channels.matrix.encryption改成true，并且要在其他聊天软件里批准一下这个新设备。
关于“魔法锁”（E2EE）
“魔法锁”的学名叫端到端加密。打开它 (channels.matrix.encryption: true)，你们在加密房间里的对话就会变成密语，只有你们俩能看懂。
- 第一次用要批准：第一次打开时，小助手会举着牌子在你其他的 Matrix 软件（比如 Element）里请求批准。你一定要去点“批准”，这样它才能拿到解密的钥匙。
- 如果锁坏了：如果这个“魔法锁”功能没能成功加载，加密房间里的消息小助手就看不懂了，它会大声告诉你（记录警告日志）。如果看到关于
@matrix-org/matrix-sdk-crypto-nodejs的错误，可能需要运行一些修复命令。
重要的事情要记住
- 私信控制：默认情况下，不认识的人给小助手发私信，小助手会给他一个配对码。需要你用命令
openclaw pairing approve matrix <配对码>批准后，他们才能聊天。 - 房间控制：默认情况下，小助手不会理睬房间里的消息，除非你明确告诉它允许进入哪些房间（在
channels.matrix.groups里设置房间ID）。 - 多个小助手：你甚至可以配置好几个小助手身份（多账户），让它们用不同的身份在广场里活动，每个身份可以有不同的设置。
- 它很能干：你的小助手在 Matrix 里可以收发音视频、表情回复、投票（会把投票转成文字）、位置信息，还能在对话的“小分支”（线程）里聊天。
如果出了问题怎么办？
先别急，按顺序试试这些检查命令，就像爬梯子一样一步一步来：
openclaw status（看看小助手整体状态）openclaw gateway status（看看网关状态）openclaw logs --follow（看看小助手最近在嘀咕什么）openclaw doctor（让“医生”检查一下）openclaw channels status --probe（专门检查聊天通道）
如果私信没反应，可以用 openclaw pairing list matrix 看看是不是有人在等批准。