Files
AstrBot/docs/zh/platform/matrix.md
lingyun14 fd4fe84310 fix: docs (#8229)
* Update listen-message-event.md

* Update other.md

* Update send-message.md

* Update ai.md

* Update ai.md

* Update send-message.md

* Update listen-message-event.md

* Delete docs/zh/dev/star/guides/env.md

* Delete docs/en/dev/star/guides/env.md

* Update simple.md

* Update discord.md

* Update discord.md

* Update matrix.md

* Update matrix.md

* Update index.md

* Update index.md

* Update openapi.md

* Update ppio.md

* Update ppio.md

* Update function-calling.md

* Update function-calling.md

* Update config.mjs

* docs: add EN desktop deployment page

* Update plugin.md

* Update ai.md

* Update ai.md

* Update ai.md

* Update desktop.md
2026-05-22 20:35:29 +08:00

2.5 KiB
Raw Permalink Blame History

接入 Matrix

Tip

该平台适配器由社区(stevessr) 维护。如果您觉得有帮助,请支持开发者,给该仓库点一个 Star。❤️

部署 Matrix 服务器

Matrix 是一个 IM 协议,有着丰富的服务端实现。

请在 Matrix Server查看可用的服务端。

支持的基本消息类型

消息类型 是否支持接收 是否支持发送 备注
文本
图片*
语音*
视频*
文件*
投票

*: 会持久化到本地,插件会按配置清理,在发送前会进行上传操作,超过服务器允许大小的上传将会失败

安装 astrbot_plugin_matrix_adapter 插件

进入 AstrBot WebUI 的插件市场,搜索 astrbot_plugin_matrix_adapter,点击安装。

安装完成后,前往 机器人(旧版本为 消息平台 → 新增适配器 → 选择 Matrix若选项缺失尝试重启 AstrBot 或检查插件安装状态)。

在弹出的配置对话框中点击 启用

配置

  • matrix_homeserver (必填): 你的 matrix 服务器实例的完整URL地址,支持域名委托自动探测。例如官方实例https://matrix.org
  • matrix_user_id: 你的 matrix 完整用户名。如 @username:homeserver.com
  • matrix_auth_method (必填) : 你的登陆方式,可选password,token,oauth2,qr推荐使用passwordoauth2/qr模式 (oauth2/qr 模式下请确保用于认证/扫码的设备回调可以访问到 astrbot 配置的公开地址)

更多请参考该仓库的 README.md 进行配置。

问题提交

如有疑问,请提交 issue 至插件仓库