我做了一个 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 改配置更稳
欢迎大家反馈使用场景和问题，我会继续迭代（尤其是跨端体验和可观测性）。
