OpenClaw OneBot

适用于通过 NapCat/go-cqhttp 连接 QQ 的 OneBot 11 频道插件。原生集成 OpenClaw,支持私聊与群聊、群内表情回应、屏蔽直播及语音管道等功能。

安装

概览

OpenClaw OneBot 11 Channel Plugin 是一款专为 OpenClaw 设计的 QQ 消息通道插件,旨在将 QQ 平台无缝集成到 OpenClaw 的原生消息路由体系中。该插件直接支持 NapCat 和 go-cqhttp 等主流 OneBot 11 协议框架,无需额外桥接脚本或自定义路由逻辑即可实现稳定通信。其核心优势在于原生集成 OpenClaw 的 ChannelPlugin 能力,使 QQ 成为与文本、语音、文件同等重要的第一类消息通道。插件通过 WebSocket 自动重连机制保障连接稳定性,并支持完整的 OpenClaw 文本命令生态,如 `/status`、`/help`、`/model` 等指令均可正常响应。此外,插件具备完善的测试覆盖(测试用例通过率 100%,语句覆盖率超92%),确保功能可靠性。配置方面仅需指定 OneBot 的 WebSocket 地址即可快速接入,极大简化了部署复杂度。

核心功能特点

  1. 原生集成 OpenClaw ChannelPlugin,实现 QQ 私聊与群聊消息收发
  2. 支持群聊表情反应(reaction)及默认开启的自动群聊反应功能
  3. 内置 OpenClaw block streaming 分块回复机制,适配长消息流式传输
  4. 提供 QQ 语音链路处理:SILK/AMR → MP3 → STT/TTS → 发送录音的完整管道
  5. 支持图片、语音、文件等多种附件类型发送
  6. 具备来源过滤(allowFrom)和 WebSocket 自动重连等稳定性特性

适用场景

OpenClaw OneBot 11 Channel Plugin 特别适合已有 NapCat 或 go-cqhttp 部署环境的用户,希望在不破坏现有架构的前提下快速启用 OpenClaw 对 QQ 的支持。相比直接使用 QQ 官方 Bot API,该方案保留了 OneBot 生态的兼容性,并可直接对接 OpenClaw 原生消息路由,避免中间层带来的性能损耗与状态不一致问题。对于需要高可靠性的生产环境,插件提供的完整测试套件和详细日志输出(如 `deliver(block)` 提示)有助于快速验证功能完整性。典型应用场景包括企业级客服机器人、社区群组自动化管理以及多平台统一消息分发系统,其中群聊自动反应和分块消息流可有效提升用户体验与系统响应效率。需要注意的是,当前版本暂不支持私聊表情反应的稳定实现,相关场景应谨慎依赖。