shinonome123

shinonome123 / openqqwaifu

Public

openqqwaifu 是一个独立运行的 QQ Waifu 控制台与运行时。 它把角色卡、会话记忆、知识库、成员目录、技能系统、模型接入、Web Console，以及 OpenClaw 兼容 skill runtime 都收敛在同一个服务里；NapCat / OneBot 只负责 QQ 协议和消息收发。

33
1
100% credibility
Found Apr 22, 2026 at 33 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

OpenQQWaifu is a self-contained tool for running customizable AI virtual companions that chat intelligently on QQ messaging.

How It Works

1
🔍 Discover a fun AI companion

You hear about a project that lets you create a smart, personalized virtual friend for chatting on QQ.

2
💻 Set it up on your computer

Download and start the program with a simple command, and it runs a friendly web dashboard right in your browser.

3
🔗 Link your QQ account

Scan a QR code in the dashboard to safely connect your QQ, so your AI can chat in groups or private messages.

4
🎨 Design your AI's personality

Use the easy web panels to pick a character, add a portrait, set traits, and choose how it talks and acts.

5
🛠️ Add special abilities

Browse a marketplace or import fun skills like searching info, generating images, or playing games during chats.

6
💬 Start chatting on QQ

Send messages in QQ, and your AI replies naturally, remembering conversations and using its skills.

😊 Enjoy ongoing fun talks

Your AI friend grows closer over time, recalls details, sends pictures, and keeps chats lively and personal.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 33 to 33 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is openqqwaifu?

openqqwaifu is a standalone Python runtime for QQ Waifu bots, bundling character cards, session memory, knowledge bases, member directories, skill systems, LLM integrations, and a web console into one service. NapCat or OneBot adapters handle only QQ protocol and messaging, freeing you from fragmented setups. Developers get a single Docker Compose deploy for running virtual girlfriends with persistent state and proactive behaviors.

Why is it gaining traction?

It stands out by converging OpenClaw-compatible skill runtimes with QQ bots, letting you import skills from marketplaces like ClawHub or GitHub via simple CLI commands. The web console offers real-time panels for editing personas, browsing memories, and tweaking abilities without restarting. Python simplicity plus OneBot hooks make prototyping waifu interactions fast, with built-in tools for search, image gen, and file ops.

Who should use this?

QQ bot builders wanting AI-driven companions with long-term memory and skills. Chinese devs experimenting with OpenClaw plugins in group chats. Hobbyists deploying virtual waifus via Docker for personal servers or testing LLM personalities in QQ.

Verdict

Worth a spin for niche QQ waifu projects—solid web UI and CLI like `run_cli.py serve` make it approachable despite 33 stars and 1.0% credibility score. Early stage means lean docs and unproven scale; run the tests first and watch for maturity.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.