Channels 导读

Matrix 接入:先拿 token 或密码,再配 autoJoin

Matrix 是 OpenClaw 内置的频道插件,支持私聊、群聊、线程、媒体、端到端加密。配置时最易踩的坑是:所有邀请(包括私聊邀请)都先走 autoJoin 过滤,dm.policy 在加入后才生效;想用流式预览就设 streaming 为 partial 或 quiet,但会多耗 API 调用。

先讲这一页到底在解决什么

Matrix 接入:先拿 token 或密码,再配 autoJoin

Matrix 是 OpenClaw 内置的频道插件,支持私聊、群聊、线程、媒体、端到端加密。配置时最易踩的坑是:所有邀请(包括私聊邀请)都先走 autoJoin 过滤,dm.policy 在加入后才生效;想用流式预览就设 streaming 为 partial 或 quiet,但会多耗 API 调用。

原文共 50 节,先看 Start Here 路径:/channels/matrix 查看官方原文

第一站

🧱 第一步永远是“先装插件砖”,不然墙上根本没有这扇门

这就是官方把 Plugin required 放在最前面的原因。

openclaw plugins install @openclaw/matrix

像去插件仓库拿一块现成的 Matrix 门组件,装到 OpenClaw 墙上。

openclaw plugins install ./extensions/matrix

像不用商店现货,而是直接拿本地那块 Matrix 开发砖来装。

📌 为什么要先装

因为 Matrix 不是“已经在门上,只是没开锁”,而是“门本身还没装上去”。

🎈 一句话

Matrix 这条路的第一步不是登录,是先把门造出来。

第二站

🔑 登录有两条路:直接给 access token,或者给账号密码让它自己换票

把它想成两种进门方式就好。

🎫

accessToken 路线

像你直接拿着现成门票进门,最省事。

👤

userId + password 路线

像先拿账号密码去前台换票,换来的 token 之后会被缓存起来。

🏠

homeserver

像你这块 Matrix 门到底连到哪栋楼,必须先写清楚。

🗃️

credentials 缓存

换到的票会被存进状态目录,下次不用每次都重新排队。

第三站

🔐 E2EE 和 verify 那大段,不是在吓人,而是在教你“怎么把加密房间的钥匙链整理好”

这也是 Matrix 比普通通道更麻烦的一点。

🔏 encryption: true

像告诉 Matrix:“我要进加密房间,但你得准备好钥匙管理。”

openclaw matrix verify bootstrap

像把这台设备正式接进你的 Matrix 钥匙体系,建立交叉签名和备份基线。

openclaw matrix verify device \"<recovery-key>\"

像拿恢复钥匙来证明“这台设备确实是自己人”。

openclaw matrix verify backup restore

像从保险柜里把旧房间钥匙取回来,恢复之前的加密阅读能力。

第四站

🤖 allowBots 那段,说白了就是“要不要让别的 Matrix 机器人也能在同一房间和你搭话”

默认是比较保守的。

allowBots: true

像说“别的 OpenClaw Matrix 机器人也可以跟我说话”。

allowBots: \"mentions\"

像说“它们不是不能说,但在群房里也得先点我名”。

📌 为什么默认谨慎

不然多个 bot 在同一房间里,很容易互相接球、越聊越热闹。

🎈 收尾一句

Matrix 这页最难的从来不是门本身,而是加密钥匙和设备信任链。