maubot

在 Matrix 上像搭积木一样快速搭建聊天机器人

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 109 🐛 待处理 86 👀 关注 11

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 901

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源项目，AGPL-3.0许可，可自行部署，完全免费。

项目预览

项目数据

分类对话助手

开发团队maubot

官网地址https://mau.bot

GitHubhttps://github.com/maubot/maubot

定价模式🏷️完全免费

价格说明开源项目，AGPL-3.0许可，可自行部署，完全免费。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议AGPL-3.0

主要语言Python

技术栈/模型asyncio,chatbot,matrix,matrix-org,maubot,python

GitHub 星标★ 901

上线时间2018-06-10 00:00:00

代码更新2026-10-24

仓库体积5.8 MB

本站数据更新2026-11-09

维护状态较活跃

收录时间2026-08-09

浏览次数3

项目介绍

maubot 是一个基于插件的 Matrix 机器人框架，用 Python 编写，基于 asyncio 实现异步处理。它解决了在 Matrix 协议生态中快速开发和部署聊天机器人的问题，提供了一套完整的插件管理机制，包括插件的加载、卸载、配置和权限控制。核心能力包括：支持通过 API 或 Web 界面管理插件，内置数据库支持，提供事件处理、命令注册等抽象，方便开发者用少量代码实现复杂功能。maubot 还支持多用户、多房间的机器人实例，并提供了与 Matrix 客户端 API 的深度集成。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 901

技术标签

asyncio chatbot matrix python

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 30 分钟部署方式：本地安装 4 步

环境要求

Matrix homeserver
Python 3.9+

安装与启动步骤

1装 maubot

Python 项目，按 README 用 pip 或 Docker 装，依赖 Matrix 服务端。
```
pip install maubot
```
2配 Matrix

准备一个 homeserver 与 bot 账号，拿到 access token 填进配置。
3装插件

插件是 zip 包，从管理界面或 CLI 上传，启用后即可在房间响应。
4写自己的插件

继承 Plugin 基类，用装饰器声明命令，改完重新打包上传即可热更。