onebot-ops

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

install

source · Clone the upstream repo

git clone https://github.com/LSTM-Kirigaya/openclaw-onebot

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/LSTM-Kirigaya/openclaw-onebot "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/onebot-ops" ~/.claude/skills/lstm-kirigaya-openclaw-onebot-onebot-ops && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/LSTM-Kirigaya/openclaw-onebot "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/onebot-ops" ~/.openclaw/skills/lstm-kirigaya-openclaw-onebot-onebot-ops && rm -rf "$T"

manifest: skills/onebot-ops/SKILL.md

source content

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

插件安装

openclaw plugins install @openclaw/onebot

本地开发时：

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 中的完整参数说明。