Mrs4s/go-cqhttp

🤖 go-cqhttp — cánh cổng OneBot v11 cho QQ, viết bằng Go thuần

Bot framework huyền thoại của cộng đồng QQ, với hơn 10.000 sao GitHub, giờ đã chính thức ngừng bảo trì.

go-cqhttp là bản triển khai chuẩn OneBot v11 viết bằng Golang thuần, chạy trên nền Mirai và MiraiGo của tác giả Mrs4s. Dự án ra đời nhằm thay thế CoolQ HTTP API (đã ngừng phát triển), cho phép lập trình viên xây dựng bot QQ một cách linh hoạt, đa nền tảng, dễ tích hợp với mọi ngôn ngữ backend thông qua giao thức HTTP và WebSocket chuẩn hoá.

✨ Điểm nổi bật

• Golang thuần, đa nền tảng: build ra binary chạy trên Windows, Linux, macOS mà không cần runtime ngoài, phù hợp cả server headless lẫn máy cá nhân.
• Tương thích OneBot v11: gần như full spec, có thể dùng lại mọi SDK OneBot v11 (Python nonebot, Java mirai/onebot-kotlin, Node.js, …) mà không sửa code.
• 4 kiểu kết nối linh hoạt: HTTP API, HTTP POST ngược, WebSocket thuận, WebSocket ngược — tuỳ mô hình bot chủ động gọi hay bị gọi.
• CQ code phong phú: chuẩn OneBot (face, record, video, at, share, music, reply, forward, xml, json…) và nhiều mở rộng độc quyền như image, redbag, poke, cardimage, tts.
• API mở rộng: HTTP POST đa điểm, WebSocket ngược đa kết nối, đổi tên nhóm, lắng nghe sự kiện thu hồi tin nhắn, parse/gửi reply và merge forward, fetch ảnh qua proxy.
• API chuẩn OneBot đầy đủ: gửi tin nhắn riêng/nhóm, xử lý lời mời vào nhóm, duyệt thành viên, upload file, lấy thông tin friend/group/stranger, xử lý friend request, xoá tin nhắn, lấy credentials, get/send like…
• Tài liệu tiếng Trung chính thức tại docs.go-cqhttp.org, có hướng dẫn quick start riêng cho cả người mới.

💡 Vì sao đáng chú ý

go-cqhttp từng là lựa chọn mặc định của cộng đồng làm bot QQ từ 2020–2023 nhờ sự cân bằng giữa tính ổn định, tài liệu và hệ sinh thái OneBot rộng lớn. Kiến trúc tách bạch giữa lớp giao thức (MiraiGo) và lớp giao tiếp chuẩn (OneBot v11) giúp dự án trở thành "cầu nối" trung tính — backend viết bằng bất cứ ngôn ngữ nào cũng có thể điều khiển QQ thông qua HTTP/WS.

Tuy nhiên, README hiện tại ghi rõ dự án đã dừng bảo trì do QQ liên tục thay đổi scheme mã hoá. Issue #2471 được pin lên, khuyến nghị dev chuyển sang các dự án NTQQ headless mới (ví dụ Lagrange.OneBot, NapCat). Với người mới, đây vẫn là tài liệu quý để hiểu kiến trúc OneBot; với người vận hành production, nên cân nhắc migrate để tránh đứt gãy khi Tencent cập nhật client.

---

#Go #OneBot #QQBot #OpenSource #TiniX