accessToken 路线
像你直接拿着现成门票进门,最省事。
Channels 导读
Matrix 是 OpenClaw 内置的频道插件,支持私聊、群聊、线程、媒体、端到端加密。配置时最易踩的坑是:所有邀请(包括私聊邀请)都先走 autoJoin 过滤,dm.policy 在加入后才生效;想用流式预览就设 streaming 为 partial 或 quiet,但会多耗 API 调用。
先讲这一页到底在解决什么
Matrix 是 OpenClaw 内置的频道插件,支持私聊、群聊、线程、媒体、端到端加密。配置时最易踩的坑是:所有邀请(包括私聊邀请)都先走 autoJoin 过滤,dm.policy 在加入后才生效;想用流式预览就设 streaming 为 partial 或 quiet,但会多耗 API 调用。
第一站
这就是官方把 Plugin required 放在最前面的原因。
openclaw plugins install @openclaw/matrix像去插件仓库拿一块现成的 Matrix 门组件,装到 OpenClaw 墙上。
openclaw plugins install ./extensions/matrix像不用商店现货,而是直接拿本地那块 Matrix 开发砖来装。
因为 Matrix 不是“已经在门上,只是没开锁”,而是“门本身还没装上去”。
Matrix 这条路的第一步不是登录,是先把门造出来。
第二站
把它想成两种进门方式就好。
像你直接拿着现成门票进门,最省事。
像先拿账号密码去前台换票,换来的 token 之后会被缓存起来。
homeserver像你这块 Matrix 门到底连到哪栋楼,必须先写清楚。
换到的票会被存进状态目录,下次不用每次都重新排队。
第三站
这也是 Matrix 比普通通道更麻烦的一点。
像告诉 Matrix:“我要进加密房间,但你得准备好钥匙管理。”
openclaw matrix verify bootstrap像把这台设备正式接进你的 Matrix 钥匙体系,建立交叉签名和备份基线。
openclaw matrix verify device \"<recovery-key>\"像拿恢复钥匙来证明“这台设备确实是自己人”。
openclaw matrix verify backup restore像从保险柜里把旧房间钥匙取回来,恢复之前的加密阅读能力。
第四站
默认是比较保守的。
allowBots: true像说“别的 OpenClaw Matrix 机器人也可以跟我说话”。
allowBots: \"mentions\"像说“它们不是不能说,但在群房里也得先点我名”。
不然多个 bot 在同一房间里,很容易互相接球、越聊越热闹。
Matrix 这页最难的从来不是门本身,而是加密钥匙和设备信任链。