Skip to content
Skills Library
AI & agents · Tool integration

onebot-ops

/onebot-ops

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

Licence
MIT
Last repository change
08.05.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.05.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

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

Original author description

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

How it works

  1. 快速判断
  2. 插件安装
  3. 前置条件
  4. OneBot 协议能力
  5. Agent 工具与 CLI
Original SKILL.md headings · 69 lines, 287 words
SKILL.md preview
---
name: onebot-ops
description: OneBot (QQ/Lagrange) 渠道运维与使用规范。消息收发通过 Channel outbound 与 deliver 完成,不依赖 Agent 工具。
---

# OneBot 运维/使用规范

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

## 快速判断

| 场景 | 说明 |
|------|------|
| **接收消息** | 私聊全回复,群聊默认仅 @ 回复,详见 [receive.md](receive.md) |
| **message 工具 target** | 群聊必须用 `ctx.To`(格式 `group:群号`),勿用 SenderId |
| **发送消息** | 使用 `openclaw message send` CLI,详见 [send.md](send.md) |
| **配置** | 运行 `openclaw onebot setup` 或编辑 `openclaw.json`,详见 [config.md](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](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](agent-tools.md) 中的完整参数说明。
Files in this package (5)
  • SKILL.md 3 KB
  • agent-tools.md 4 KB
  • config.md 3 KB
  • receive.md 5 KB
  • send.md 2 KB

Versions

The database has no other skills named onebot-ops.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 1cb76daf2713 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100dsh-bridge-plugin
    Write or debug a DeepSeek Harness channel bridge plugin that connects a chat protocol (OneBot/SnowLuma/NapCat/WeChat/etc.) to dsh-her-kernel. Use when the user wants to add a new channel, fix ingest/outbound/read-receipt, mount tools per character, or design a bridge package.…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.