Agent skill

onebot-ops

OneBot (QQ/Lagrange) 渠道运维与使用规范。消息收发通过 Channel outbound 与 deliver 完成,不依赖 Agent 工具。

Stars 116
Forks 23

Install this agent skill to your Project

npx add-skill https://github.com/LSTM-Kirigaya/openclaw-onebot/tree/main/skills/onebot-ops

SKILL.md

OneBot 运维/使用规范

OneBot v11 协议渠道,支持 QQ/Lagrange.Core/go-cqhttp。消息收发均通过 Channel 的 outbound 与 deliver 完成,不依赖 Agent 工具

快速判断

场景 说明
接收消息 私聊全回复,群聊默认仅 @ 回复,详见 receive.md
message 工具 target 群聊必须用 ctx.To(格式 group:群号),勿用 SenderId
发送消息 使用 openclaw message send CLI,详见 send.md
配置 运行 openclaw onebot setup 或编辑 openclaw.json,详见 config.md

插件安装

bash
openclaw plugins install @openclaw/onebot

本地开发时:

bash
openclaw plugins install ./openclaw-onebot

前置条件

  • Gateway 已启动:openclaw gateway
  • OneBot 实现(Lagrange.Core / go-cqhttp)已运行并暴露 WebSocket
  • openclaw.json 中配置 channels.onebot 或通过 ONEBOT_WS_* 环境变量

OneBot 协议能力

对应 Lagrange.onebot context.ts 的 API:

能力 说明
send_private_msg 发送私聊消息
send_group_msg 发送群消息
send_msg 按 message_type 发送
图片消息 message 为 [{ type: "image", data: { file } }]
delete_msg 撤回消息
get_msg 获取单条消息
get_group_msg_history 获取群历史(Lagrange.Core 扩展),支持 reverse_order 分页
upload_group_file 上传群文件
upload_private_file 上传私聊文件
set_msg_emoji_like 表情回应(Lagrange/QQ NT 扩展)

Agent 工具与 CLI

插件提供群历史、按名字搜 QQ 等能力,既注册为 Agent 工具(供 Cron/脚本/AI 调用),也提供等价的 CLI 命令,便于 AI 与人工按文档调用。

详细说明与所有命令用法见:agent-tools.md

常用 CLI 一览

命令 说明
openclaw onebot setup 交互式配置 OneBot 连接
openclaw onebot get-group-msg-history --group-id <群号> [--hours N] 获取群历史(单页或最近 N 小时内,从旧到新)
openclaw onebot search-group-member --group-id <群号> --name <名字> 按名字模糊搜群友 QQ 号
openclaw onebot upload-file --target group:<群号> --file <路径> --name <文件名> 上传文件到群/私聊
openclaw message send --channel onebot --target group:xxx --message "hi" 发送文本/图片
openclaw gateway status 查看 Gateway 状态
openclaw logs --follow 查看日志

AI 或脚本需要「获取群历史、查群友 QQ」时,应使用上述 CLI 或查阅 agent-tools.md 中的完整参数说明。

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results