为 OpenClaw 加入 Matrix Channel - 选择孤独真实

The Matrix 1999 - Take the red pill to stay in Wonderland and see how deep the rabbit hole goes, or the blue pill to wake up and believe what you want.

不可否认，OpenClaw 在一定程度上被过度炒作了。不过，从 AI Agent 开发的角度来看，它确实引入了一种有意思的思路：将 即时通讯平台（如 WhatsApp、Telegram、Matrix 等）作为与 AI Agent 交互的主要入口。

这种设计显著降低了部署和远程使用的复杂度。用户只需要一个 IM 客户端即可与 AI 交互，而无需处理端口映射、反向代理或复杂的网络配置。

许多技术用户之所以对 OpenClaw 感兴趣，正是因为它强调 可自托管。尽管由于硬件成本的限制，完全在本地自托管大模型对大多数人来说仍不现实，但自托管 OpenClaw 的 Matrix Channel却是一个非常可行的方案。

通过这种方式，用户既能利用 OpenClaw 的能力，又能在一个私有的 Matrix Channel 中进行通信。自托管 Matrix Server 意味着你可以完全掌控自己的数据，在不依赖第三方平台的前提下，以安全、私密的方式与 AI Agent 交互。

搭建 Matrix 聊天 Server

我选择了 tuwunel 作为自托管的 Matrix Server。它是 conduwuit 的官方继任项目。

完成 Server部署后，我创建了一个名为 openclaw 的 Matrix 用户，并通过以下请求获取访问令牌（access token）：

1
2
3
4
5
6


curl -XPOST \
  -H "Content-Type: application/json" \
  -d '{"type":"m.login.password", "user":"@openclaw:your_matrix_home_domain", "password":"$your_matrix_password"}' \
  "https://$your_matrix_home_domain/_matrix/client/r0/login"

{"user_id":"@openclaw:your_matrix_home_domain","access_token":"$your_matrix_access_token","home_server":"$your_matrix_home_domain","device_id":"xyz"}

配置 OpenClaw Channel

在继续之前需要说明：OpenClaw 以及 OpenClaw 的 Matrix 插件目前仍处于早期开发阶段。在配置过程中你可能会遇到一些问题。以下步骤基于我自己的实践环境整理，希望能帮助你顺利完成 Matrix Channel的搭建。

参考 https://docs.openclaw.ai/channels/matrix

安装 Matrix Channel插件

在安装插件之前，建议先观察 OpenClaw 的日志输出：

1

tail -f /tmp/openclaw/openclaw-2026-xx-xx.log

然后安装 Matrix 插件：

1

openclaw plugins install @openclaw/matrix

插件安装问题一：重复的插件 ID

安装完成后，你可能会看到类似下面的错误：

Config warnings:
- plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may be overridden
(/home/mark/.nvm/versions/node/v24.13.0/lib/node_modules/openclaw/extensions/matrix/index.ts)

这通常是因为插件同时存在于以下两个目录中：

~/.nvm/versions/node/v24.13.0/lib/node_modules/openclaw/extensions/matrix
~/.openclaw/extensions/matrix

如果是这种情况，删除其中一个重复目录即可，例如：

1

sudo rm -rf ~/.nvm/versions/node/v$some_version/lib/node_modules/openclaw/extensions/matrix

插件安装问题二：缺少依赖

如果日志中出现如下错误：

[plugins] matrix failed to load from /home/mark/.openclaw/extensions/matrix/index.ts:
Error: Cannot find module '@vector-im/matrix-bot-sdk'

说明缺少相关依赖。可以通过全局安装依赖来解决：

1
2
3
4


npm install -g vector-im/matrix-bot-sdk
npm install -g markdown-it
npm install -g music-metadata
npm install -g zod

配置 OpenClaw

编辑 ~/.openclaw/openclaw.json，加入以下配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


"channels": {
  "matrix": {
    "accessToken": "$your_matrix_access_token",
    "dm": {
      "enabled": true,
      "policy": "open"
    },
    "autoJoin": "always",
    "groupPolicy": "open",
    "homeserver": "https://$your_matrix_home_domain",
    "deviceName": "OpenClaw",
    "enabled": true,
    "encryption": true
  }
}

注意：这里的 open 策略意味着你的 Matrix homeserver 上的任何用户都可以向 OpenClaw 机器人发送消息。该配置仅适用于测试环境。
在生产环境中，建议限制访问策略，并考虑关闭 Matrix 的 federation 功能。

测试 Matrix 聊天 Channel

配置完成后，你应该可以通过 Matrix 客户端与 OpenClaw 进行交互：

matrix ui

Chat