openclaw-onebot

让OpenClaw智能体通过OneBot协议接入QQ等平台

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:openclaw-onebot。
它的用途是:让OpenClaw智能体通过OneBot协议接入QQ等平台
完整的 Skill 内容见:https://321skill.com/skills/openclaw-onebot/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“@机器人 给大家介绍一下OpenClaw平台的主要功能”,它会以清晰的结构在群内进行介绍,并根据回复长度自动选择分段发送或生成图文并茂的卡片。在私聊中,用户可以直接发送“帮我规划一下本周的社群内容排期”,AI助手会结合上下文给出详细的建议方案。

介绍

openclaw-onebot是OpenClaw智能体平台的官方OneBot v11协议插件。它解决了智能体无法直接与QQ等主流即时通讯平台交互的问题,通过标准化的OneBot协议,将OpenClaw的强大AI能力无缝引入QQ私聊和群聊场景。

使用上,用户只需通过简单的命令行安装插件,并配置连接到一个已运行的OneBot服务端(如NapCat、go-cqhttp或Lagrange.Core),即可让QQ机器人获得OpenClaw智能体的对话、文件处理、上下文理解等能力。配置支持正向/反向WebSocket连接,并可通过环境变量灵活部署。

该插件非常适合需要在QQ生态内(如社群管理、客服辅助、娱乐互动)部署AI助手的开发者、社群运营者或技术爱好者。它降低了在QQ平台集成AI的门槛,无需复杂的底层开发。

使用建议:初次使用前,请确保已熟悉OneBot服务端(如NapCat)的安装与配置。对于群聊场景,建议合理配置触发方式(如@触发或关键字触发)和长消息处理策略,以避免消息刷屏或体验不佳。注意遵守相关平台的使用规范。

核心特点

作为OpenClaw官方出品的渠道插件,深度集成平台特性,支持OpenClaw特有的长消息OG图片渲染、流式聚合发送等高级功能;同时提供CLI工具支持主动消息发送,无需依赖Agent工具调用,管理更灵活。

注意事项

需要用户自行部署和维护兼容OneBot v11协议的后端服务(如QQ机器人框架),插件本身不提供QQ协议实现。

常见问题

如何让QQ机器人用上OpenClaw?

安装本插件,并配置连接至一个已部署的OneBot服务端(如NapCat)即可。

群聊里必须@机器人才能触发回复吗?

不是,支持@触发和关键字触发两种方式,可在配置中开启并自定义关键词列表。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/openclaw-onebot/raw/index.md 读取 openclaw-onebot 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。