CeylanCLC

CeylanCLC / agent-qq-sandbox-bot

Public

基于 OpenClaw、NapCat OneBot、WebSocket 和 Python 的 QQ 群 AI 机器人桥接项目。A QQ group AI bot bridge based on OpenClaw, NapCat OneBot, WebSocket, and Python.

10
0
69% credibility
Found May 13, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

This project builds an intelligent QQ bot that joins group chats, responds to mentions and keywords, analyzes images, shares files, remembers discussions, and chimes in periodically.

How It Works

1
👀 Discover the QQ AI Buddy Project

You stumble upon this open project on GitHub that's perfect for adding a smart, chatty friend to your QQ groups and private messages.

2
📱 Prepare Your QQ Account

You get a simple QQ login tool running on your computer so the bot can join your groups like a real member.

3
🧠 Connect Smart AI Helpers

You link free AI services that let the bot think, remember chats, understand pictures, and join conversations naturally.

4
🚀 Launch Your Group Companion

With one easy start command, your AI buddy connects and springs to life, ready to chat in your QQ groups.

5
💬 Chat and Share in Groups or Private

Mention the bot, use fun keywords, send pictures or files, and watch it reply smartly, read images, or even speak up on its own.

🎉 Enjoy Lively QQ Chats Forever

Your groups buzz with natural conversations, memory of past talks, proactive comments, and helpful image insights—your AI friend feels like family!

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 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 agent-qq-sandbox-bot?

This Python bridge turns a QQ account into a smart AI agent for group chats via NapCat OneBot, WebSocket, and OpenClaw integration. It handles @ replies, keyword triggers like "弹性", private messages, timed group patrols, task execution, image sending from a shared folder, file uploads to groups, and vision analysis with MiMo-V2.5. Developers get a sandbox bot that acts like a natural group member, with message caching and long-term memory compression to avoid repetitive replies.

Why is it gaining traction?

It stands out with proactive features like periodic group patrols that scan for conversation gaps and insert context-aware replies, plus robust image handling—caching pics for follow-up questions like "@bot 这图是什么". The dual-model routing (OpenClaw for text, direct MiMo for vision) ensures reliable multimodal responses, and systemd/Docker setup makes it easy to run persistently on Linux servers. Devs dig the focus on QQ-specific quirks, like handling split text/image events from NapCat.

Who should use this?

Chinese devs building AI bots for QQ workgroups or communities, especially those integrating OpenClaw agents. Learners experimenting with OneBot protocol, WebSocket event loops, or group context management in Python. Self-hosters wanting a low-overhead sandbox for personal groups with vision and memory features.

Verdict

Solid learning project with excellent docs for QQ-OneBot-OpenClaw bridges, but at 10 stars and 0.7% credibility, it's early-stage—expect tweaks for production. Try it in a sandbox if you're prototyping group agents; skip for battle-tested bots.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.