# botuniverse/onebot

OneBot：统一的聊天机器人应用接口标准

Repository: https://github.com/botuniverse/onebot
Canonical: https://ross.abutalabs.com/products/onebot
Homepage: https://onebot.dev
Language: CSS
License: MIT
License Family: permissive
Topics: qqbot, bot, cqhttp, onebot, protocol, standard, api, chatbot
Last push: 2023-07-06T08:42:00+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2216, "days_push": 1154, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2048, forks 167 (observed 2026-08-28T04:06:08.975560+00:00)

## What it is
OneBot is an open standard specification that unifies chatbot application interfaces across different chat platforms, so developers can write business logic once and run it on multiple bot platforms. This repository hosts the standard's documentation draft (OneBot 12), published as a MkDocs site.

## Use cases
- write a chatbot once and run it on multiple chat platforms
- implement a bot framework compatible with a unified bot API standard
- port a QQ bot to other messaging platforms without rewriting logic
- build OneBot-compatible protocol implementations or adapters
- contribute to or review the chatbot interface standard via RFCs

## When to choose
- you are developing a chatbot and want platform independence
- you are building a bot framework or protocol adapter and want a common interface to target
- you want to implement or extend the OneBot standard itself

## When to avoid
- you need a ready-to-run bot library or runtime rather than a specification
- your target platform has no OneBot implementation available
- you need features outside the standard's common chatbot API surface

## Facets
- artifact type: learning-resource
- maturity: active
- function: chatbot, api-framework, documentation
- domain: chatbots, apis, developer-tools, messaging-platforms
- platform: cross-platform
- tags: protocol-standard, bot-api, specification, qqbot, cqhttp

## Member repositories
- botuniverse/onebot (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:08.975560+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:57:41.651488+00:00, confidence not recorded.
  - readme: https://github.com/botuniverse/onebot (fetched 2026-08-28T04:06:08.975560+00:00, sha 274a5137f46c)
  - homepage: https://onebot.dev (fetched 2026-08-29T10:37:53.380411+00:00, sha da0a81e1ef27)
- Data as of 2026-08-30T08:39:29.467469+00:00.