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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/openclaw-onebot/raw/index.md(查看排版版本)