核心功能
OpenClaw OneBot Channel Plugin 是一款将 QQ 接入 OpenClaw 生态的原生通道插件，基于 OneBot 11 协议实现，兼容 NapCat、go-cqhttp 等主流 QQ 机器人框架。
核心用法
- 双协议通信：通过 WebSocket 接收事件，HTTP 发送消息
- 目标格式：
private:<QQ号>私聊、group:<群号>群聊，纯数字自动识别为私聊 - 配置入口：
plugins.allow使用openclaw-onebot，channels.onebot保持通道配置 - OpenClaw 命令全支持：
/status、/help、/model、/new、/reset等
显著优点
1. 原生集成：作为 ChannelPlugin 直接接入 OpenClaw 消息路由，无需外部桥接脚本
2. 流式回复：支持 block streaming，长文本分块发送，避免消息过长截断
3. 语音链路完整：自动处理 SILK/AMR → MP3 转换，打通 STT/TTS 语音管道
4. 群聊增强：自动 reaction、群聊表情包回应，提升交互体验
5. 高测试覆盖：106 个测试用例，Statements/Lines 92.11%，Functions 95.16%
6. 生态兼容：保留 OneBot 11 生态，现有 NapCat/go-cqhttp 部署可平滑迁移
潜在局限
- 私聊 reaction 不可靠：官方限制，不建议依赖此能力
- Streaming 非编辑模式：QQ 端表现为多条连续消息，而非单条消息原地编辑
- 依赖外部 OneBot 实现：需自行部署 NapCat 或 go-cqhttp，非纯云端方案
- QQ 官方 API 风险：基于非官方协议，存在账号风控可能性
适合人群
- 已有 NapCat/go-cqhttp 部署，希望接入 OpenClaw AI 能力的开发者
- 需要 QQ 群聊机器人、且看重流式回复与语音交互的用户
- 追求测试覆盖率和代码质量的技术团队
常规风险
- 账号安全：使用非官方 QQ 协议可能触发风控，建议小号部署
- 供应链安全：建议固定 Git tag/commit 安装，避免自动更新引入未审计代码
- 配置误操作：修改
openclaw.json前务必备份，重启 gateway 前确认影响范围