（3301期）OneBot Adapter – QQ 机器人协议适配 · 实时消息收发

QQ 机器人协议适配 · 实时消息收发 连接 OpenClaw 与 OneBot 协议的 QQ 机器人适配器，支持 NapCat 等实现，提供实时消息收发与群管理功能。 使用说明 OneBot Adapter 综合评估 核心用法 OneBot Adapter 是 OpenClaw 框架的 QQ 机器人协议适配层，基于 OneBot 11 标准协议实现。核心功能包括： 连接管理：支持 WebSocket（推荐）与 HTTP 两种通信模式。WebSocket 提供实时双向通信，适合需要即时响应的场景；HTTP 采用请求-响应模型，适合简单的消息推送任务。 消息收发：通过 onebotwslistener.py 脚本监听 QQ 消息事件，使用 OneBotClient 类提供标准化 API 发送私聊/群消息。封装了底层协议细节，开发者无需处理复杂的 QQ 协议握手。 数据查询：支持获取登录信息、好友列表、群组列表等基础数据接口，为机器人决策提供上下文信息。 显著优点 协议标准化：基于广泛采用的 OneBot 11 协议，兼容 NapCat、go-cqhttp 等多种实现，降低厂商锁定风险 双模式灵活：WebSocket + HTTP 双通道设计，兼顾实时性与简洁性 NapCat 原生优化：针对基于 NTQQ 的 NapCat 实现进行默认配置优化，减少新手配置成本 轻量集成：仅需环境变量配置即可接入，无需复杂中间件 潜在缺点与局限性 协议依赖风险：OneBot 协议非腾讯官方标准，存在因 QQ 协议变更导致兼容性断裂的历史先例 功能边界：仅覆盖基础消息能力，高级功能（如红包、语音通话）受限于 OneBot 协议定义 部署复杂度：需额外维护 NapCat/OneBot 服务端，形成"服务端+适配器"双层架构 Token 安全：可选的 Token 认证在实际生产环境中易被忽略，存在未授权访问隐患 适合人群 需要为 OpenClaw 扩展 QQ 渠道交互能力的开发者 已部署 NapCat/OneBot 服务端，寻求标准化接入方案的技术团队 构建客服机器人、群管理助手等中度交互场景的机器人开发者 常规风险 | 风险类型 | 描述 | 缓解建议 ||---------|------|---------|| 连接中断 | WebSocket 长连接可能因网络抖动断开 | 实现心跳检测与自动重连机制 || 消息丢失 | 高峰期或风控场景下消息投递失败 | 添加发送结果校验与重试逻辑 || 账号风控 | 高频操作可能触发 QQ 安全限制 | 控制消息频率，模拟人类行为模式 || 敏感信息泄露 | Token/QQ 号硬编码于配置中 | 使用密钥管理服务，定期轮换凭证 | 原始说明 Connect OpenClaw to OneBot protocol for QQ bot integration. Use when receiving or sending QQ messages via NapCat or other OneBot servers.