What it does

This is a plugin for Yunzai-Bot / Miao-Yunzai, the popular Chinese QQ bot framework. It wires ChatGPT (and other LLMs) into group chats and private messages, adding memory, preset personalities, tool use, and a web management panel. Think of it as giving your QQ bot a persistent, configurable brain that can also pretend to be just another lurker.

The interesting bit

The “BYM” (pseudo-human) mode is the standout oddity: the bot probabilistically interjects based on keywords or a dice roll, then can recall its own message seconds later to maintain plausible deniability. Combined with per-group memory injection and vectra-based RAG, it’s less a chatbot and more an NPC with commitment issues.

Key highlights

• Multi-model channel management with load balancing and per-user presets
• BYM “fake human” mode with probability triggers, keyword maps, and timed message recall
• Memory system: group memory, private memory, and external RAG knowledge base via vectra vector index
• Web admin panel (#chatgpt管理面板) plus full CRUD command interface for channels, presets, tools
• Auto-update via git + pnpm, with hot-reload config (JSON/YAML)
• Handles images, voice, quotes, and tool-call outputs through QQ forward messages

Caveats

• v3 is “basically usable, continuously improving” per the author’s own warning; RAG knowledge base and MCP compatibility remain unchecked on the todo list
• better-sqlite3 compilation issues are common enough to warrant a dedicated troubleshooting note
• Chaite Cloud integration exists but the local default is SQLite; scaling beyond single-node isn’t discussed

Verdict

Worth it if you run a Yunzai QQ bot and want sophisticated group-AI behavior without building the plumbing yourself. Skip if you’re not already in the Yunzai ecosystem or need production-grade reliability today.