onebot

写一次机器人，跑遍所有聊天平台

开源 🏷️完全免费 ✅ 目前可打开对话助手 🍴 复刻 166 🐛 待处理 3 👀 关注 22

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2089

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源标准，免费使用，无付费版本。

项目预览

项目数据

分类对话助手

开发团队botuniverse

官网地址https://onebot.dev

GitHubhttps://github.com/botuniverse/onebot

定价模式🏷️完全免费

价格说明开源标准，免费使用，无付费版本。

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言CSS

技术栈/模型api,bot,chatbot,cqhttp,onebot,protocol,qqbot,standard

GitHub 星标★ 2089

上线时间2020-08-08 00:00:00

代码更新2023-07-06

仓库体积1.3 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数4

项目介绍

OneBot 是一套统一的聊天机器人应用接口标准，旨在解决不同聊天平台（如 QQ、微信、Telegram 等）与机器人实现之间协议碎片化的问题。它定义了机器人后端与前端（平台适配层）之间的通信规范，包括事件上报、API 调用、消息格式等，使得开发者可以编写一次机器人逻辑，就能在多个平台上运行。核心能力包括：标准化的消息收发、群管操作、好友互动、以及可扩展的插件机制。通过遵循该标准，机器人框架和客户端可以解耦，生态内组件可互相替换，极大降低了多平台机器人的开发与维护成本。目前主要面向 QQ 生态（继承自 CQHTTP），但设计上支持扩展至其他平台。

Star 增长趋势

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

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

技术标签

api bot chatbot onebot qqbot

使用教程

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

难度：入门约 5 分钟部署方式：本地安装 4 步

环境要求

已安装 Python 与 pip
已安装 git（用于克隆仓库）
可访问 GitHub 与 PyPI 的网络环境

安装与启动步骤

1克隆标准文档仓库

把 botuniverse/onebot 仓库拉到本地，注意这是 OneBot 标准草案文档仓库，不是可直接运行的机器人程序。
```
git clone https://github.com/botuniverse/onebot.git
```
2进入项目目录

切换到克隆下来的仓库根目录，后续安装依赖和预览都在此目录内执行。
```
cd onebot
```
3安装文档依赖

按 requirements.txt 安装 MkDocs 等依赖，建议先创建并激活虚拟环境以免污染全局 Python。
```
pip install -r requirements.txt
```
4本地预览文档

启动 MkDocs 本地服务，终端会输出访问地址，浏览器打开该地址即可阅读标准文档。
```
mkdocs serve
```