OpenClaw QQ 插件：把 QQ 接入 OpenClaw 的生产可用方案（NapCat / OneBot v11）非官方机器人

我做了一个 openclaw_qq 插件，用来把 QQ （基于 OneBot v11 ）完整接入 OpenClaw 。 目标不是“能聊就行”，而是能长期稳定跑在群里、可控、可运维。

项目地址： https://github.com/constansino/openclaw_qq

## 这项目能做什么？

• 支持 QQ 私聊 / 群聊 / 频道（ Guild ）消息接入
• 支持 @触发、关键词触发、回复机器人触发
• 支持管理员指令（如状态、群管动作）
• 支持图片消息解析与发送（含 Base64 场景优化）
• 支持风控友好的分段发送、频率控制、去重
• 支持 admin-only 、防盗刷、黑名单、拦截提示防抖
• 默认使用 OpenClaw 会话系统管理上下文（ historyLimit=0 ）

## 我们这版做过的关键改进

• 修复 QQ 会话路由问题，避免和其他通道（如 TG ）记录混淆
• 修复管理员权限判断顺序（先触发判断，再鉴权），降低群聊噪音
• 修复非管理员提示循环/重复提示问题，新增可配置防抖时长
• 黑名单支持稳定输入与保存（支持 Web 表单/Raw/CLI 常见写法）
• 文档补全：管理员、黑名单、防盗刷的 CLI 实战配置
• NapCat Docker 部署模板和示例更完整
• 清理敏感配置管理：.env 改为本地文件 + .env.example 模板

## 适合谁用？

• 已经在用 OpenClaw ，希望把 QQ 作为主要入口
• 有群聊运营需求，担心 token 被刷
• 需要可运维（配置、日志、重启、权限策略）而不是 demo 方案

## 推荐配置（防盗刷最小集）

openclaw config set channels.qq.admins ‘“1838552185”’ –json openclaw config set channels.qq.adminOnlyChat true –json openclaw config set channels.qq.blockedUsers ‘“3425712164”’ –json openclaw gateway restart

说明：本插件里 admins / blockedUsers 使用字符串列表存储，CLI 建议始终 –json 。

## 已知说明

• OpenClaw Web /config 页面在某些情况下会出现整包校验报错（看起来像改 QQ ，实际是其他字段类型问题）
• 相关英文 issue / PR 已提到 OpenClaw 主仓库并跟进中
• 实操建议：涉及 QQ 管理名单时，优先走 CLI 改配置更稳

欢迎大家反馈使用场景和问题，我会继续迭代（尤其是跨端体验和可观测性）。