写一次机器人，跑遍所有聊天平台
OneBot 是一套统一的聊天机器人应用接口标准，旨在解决不同聊天平台（如 QQ、微信、Telegram 等）与机器人实现之间协议碎片化的问题。它定义了机器人后端与前端（平台适配层）之间的通信规范，包括事件上报、API 调用、消息格式等，使得开发者可以编写一次机器人逻辑，就能在多个平台上运行。核心能力包括：标准化的消息收发、群管操作、好友互动、以及可扩展的插件机制。通过遵循该标准，机器人框架和客户端可以解耦，生态内组件可互相替换，极大降低了多平台机器人的开发与维护成本。目前主要面向 QQ 生态（继承自 CQHTTP），但设计上支持扩展至其他平台。
1克隆标准文档仓库
把 botuniverse/onebot 仓库拉到本地，注意这是 OneBot 标准草案文档仓库，不是可直接运行的机器人程序。
git clone https://github.com/botuniverse/onebot.git2进入项目目录
切换到克隆下来的仓库根目录，后续安装依赖和预览都在此目录内执行。
cd onebot3安装文档依赖
按 requirements.txt 安装 MkDocs 等依赖，建议先创建并激活虚拟环境以免污染全局 Python。
pip install -r requirements.txt4本地预览文档
启动 MkDocs 本地服务，终端会输出访问地址，浏览器打开该地址即可阅读标准文档。
mkdocs serve终端出现 MkDocs 的本地服务地址（默认 8000 端口）且无报错，浏览器打开该地址能看到 OneBot 标准文档页面即成功。
Q：这个仓库能直接跑 QQ 机器人吗？
A：不能。本仓库是 OneBot 标准草案文档，只定义接口规范，实际机器人需使用生态中遵循该标准的具体实现（如各类 OneBot 实现端）。
Q：哪里能看到已正式发布的版本？
A：正式版本请前往 https://onebot.dev 查找相关链接；本仓库内容是最新草案，发布在 https://12.onebot.dev。
Q：pip install 安装失败怎么办？
A：确认 pip 与 Python 版本可用、网络能访问 PyPI；必要时配置国内镜像源后重新执行 pip install -r requirements.txt。
Q：预览端口被占用怎么办？
A：先关闭占用 8000 端口的程序，再重新执行 mkdocs serve；具体换端口方式请查阅 MkDocs 官方文档。
Mirai、Lagrange.Core、NapCatQQ
onebot 是对话助手领域的开源项目，由 botuniverse 开发，2020 年首次发布。
在全站 13,014 个收录项目中，它的 GitHub 星标数（2,058）位列前 30%，在对话助手分类的 905 个项目里位列前 12%。
项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。开源标准，免费使用，无付费版本。从国内网络环境看，可直接访问。
它主要面向的使用场景是：开发跨平台聊天机器人（QQ、微信等）。同类可对比的替代方案包括 Mirai、Lagrange.Core、NapCatQQ。
上一篇：Awesome-Chatbot
下一篇：genal-chat
open-webui
开源
给本地模型配个漂亮聊天室，全家都能用
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
prompts.chat
开源
海量好提示词，抄了就能让 AI 更听话
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the commun···
elia
开源
终端里用键盘快速聊 AI，多模型切换不打断思路
A snappy, keyboard-centric terminal user interface for interacting with large langua···
NextChat
开源
一个界面聊遍所有主流AI模型，支持全平台部署，轻快又私密。
✨ Zero-config AI chat assistant. No API key needed — sign up and instantly chat wi···