pandolia/qqbot

Analysis updated 2026-07-03

★ 3,685PythonAudience · developerComplexity · 3/5Setup · hard

Mindmap

mindmap
  root((qqbot))
    What it was
      QQ messaging automation
      Plugin-based bot
      HTTP control API
    How it worked
      QR code login
      onQQMessage handler
      bot.SendTo replies
    Tools
      qq CLI tool
      Runtime plugin load
    Status
      SmartQQ shut down 2019
      No longer functional

mindmap root((qqbot)) What it was QQ messaging automation Plugin-based bot HTTP control API How it worked QR code login onQQMessage handler bot.SendTo replies Tools qq CLI tool Runtime plugin load Status SmartQQ shut down 2019 No longer functional

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Study how a plugin-based chatbot framework was structured before the SmartQQ shutdown.

USE CASE 2

Learn how HTTP APIs were used to control a running bot from external web applications.

USE CASE 3

Use the plugin loading and unloading pattern as a reference for building your own extensible bot framework.

USE CASE 4

Understand how QR code-based login was implemented for QQ automation in 2018-era Python projects.

What is it built with?

Python

How does it compare?

	pandolia/qqbot	miso-belica/sumy	paper2poster/paper2poster
Stars	3,685	3,685	3,685
Language	Python	Python	Python
Setup difficulty	hard	easy	moderate
Complexity	3/5	2/5	4/5
Audience	developer	developer	researcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

SmartQQ was shut down in January 2019, the underlying service no longer exists and the bot cannot be run.

In plain English

qqbot is a Python-based chatbot framework built on top of Tencent's SmartQQ protocol, which allowed automated interaction with the QQ messaging platform. The README notes prominently that SmartQQ was shut down on January 3, 2019, and as a result this project no longer works and is no longer maintained. When it was functional, qqbot let you log in to a QQ account by scanning a QR code and then automate messaging tasks: monitoring incoming messages, sending messages to friends or groups, and building custom response logic through a plugin system. The bot ran on Linux, Windows, and macOS. Custom bot behavior was added by writing a Python file with a function named onQQMessage. This function received each incoming message along with the sender's details and a bot object, and you could call bot.SendTo() to reply. Plugins could be loaded and unloaded at runtime without restarting the bot. A companion command-line tool called qq let you control the running bot: listing contacts, searching within friend or group lists, sending messages, and loading or unloading plugins. All commands also had corresponding HTTP API endpoints, making it possible for web applications to trigger actions by calling local URLs. Because the underlying SmartQQ service no longer exists, this repository serves only as a historical reference. Anyone looking for a working QQ bot framework would need to find a project based on a currently supported protocol.

Copy-paste prompts

Prompt 1

Based on the qqbot codebase, show me how to implement a plugin system in Python where plugins can be loaded and unloaded at runtime without restarting the main process.

Prompt 2

Using the qqbot architecture as a reference, help me build a simple chatbot in Python with an HTTP API for sending messages from external web apps.

Prompt 3

Explain how the onQQMessage handler pattern in qqbot works and help me apply the same event-driven message handling pattern to a modern Discord or Telegram bot.

Prompt 4

Show me how to structure a Python CLI tool like qqbot's qq command that controls a running server process by sending HTTP requests.

Frequently asked questions

What is qqbot?

A Python chatbot framework for Tencent's QQ messaging platform that automated messaging and ran custom plugins. SmartQQ was shut down in January 2019, so this project no longer works and is kept only as a historical reference.

What language is qqbot written in?

Mainly Python. The stack also includes Python.

How hard is qqbot to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is qqbot for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub pandolia on gitmyhub

Verify against the repo before relying on details.