Matrix 是一种开放且去中心化的即时通讯协议，允许用户自主部署私有服务器并接入全球 Matrix 联邦网络。OpenClaw 网关通过集成 Matrix 的 Client-Server API，实现与这一分布式通信生态的无缝对接。

前置准备

在配置 OpenClaw 连接 Matrix 之前，请确保已完成以下准备工作：

• 拥有一个有效的 Matrix 账户（可在 matrix.org 等公共家园服务器免费注册）。
• 获取该账户的 Access Token（访问令牌），用于 API 身份验证。
• 已在本地或服务器部署并运行 OpenClaw Gateway 服务。

安装 Matrix 插件

通过 OpenClaw 命令行工具安装官方提供的 Matrix 通信插件：

openclaw plugins install @openclaw/matrix

获取 Access Token

推荐通过 Element Web 客户端快速获取 Access Token：

1. 使用浏览器登录 Element Web 界面。
2. 点击左上角头像进入 Settings（设置） > Help & About（帮助与关于）。
3. 在页面中定位 Access Token 区域，点击展开并复制令牌字符串。

# 在 Element 客户端中：Settings > Help & About > Access Token
# 点击展开即可复制

安全提醒：Access Token 具备账户完全访问权限，请勿泄露。建议为 OpenClaw 机器人创建独立 Matrix 机器人账户，避免使用个人主账号，以提升安全性并实现权限隔离。

配置 OpenClaw 连接参数

在 OpenClaw 配置文件中启用 Matrix 通道并进行必要设置。主要配置字段示例如下：

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.
    }
  }
}