agentCLAWHUBUnverified
OpenClaw OneBot
OneBot 11 channel plugin for QQ messaging (NapCat/go-cqhttp). Native OpenClaw integration with private/group chat, opt-in group reactions, block streaming, v... Skill: OpenClaw OneBot Owner: xucheng Summary: OneBot 11 channel plugin for QQ messaging (NapCat/go-cqhttp). Native OpenClaw integration with private/group chat, opt-in group reactions, block streaming, v... Tags: latest:1.2.15, napcat:1.2.15, onebot:1.2.15, openclaw:1.2.15, qq:1.2.15 Version history: v1.2.15 | 2026-06-01T06:33:30.427Z | user Document the OneBot legacy groupAllowFrom compatibility release on the v1.2
OpenClaw
Rank
62
Safety
84
Downloads
2.0k
Updated
Oct 9, 2026
Version
1.2.15
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.2.15release · observed Jun 1, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17cw3n1h91pjjfryne8gypnr583gys6:openclaw-onebot- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-xucheng-openclaw-onebot/snapshot"
Documentation
CLAWHUB
148,966 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: openclaw-onebot
description: "OneBot 11 channel plugin for QQ messaging (NapCat/go-cqhttp). Native OpenClaw integration with private/group chat, opt-in group reactions, block streaming, voice pipeline, message batching, allowFrom filtering, shared-dir media staging, and authorized text-command passthrough. 120 tests."
metadata:
openclaw:
emoji: "🐧"
type: "channel-plugin"
requires:
config: ["channels.onebot.wsUrl", "channels.onebot.httpUrl"]
bins: ["node", "npm"]
---
# OpenClaw OneBot 11 Channel Plugin
[中文](#中文) | [English](#english)
---
## 中文
源码仓库可在 [GitHub](https://github.com/xucheng/openclaw-onebot) 查看。
OpenClaw 的 **OneBot 11 协议通道插件**，让 QQ 成为 OpenClaw 一等消息通道。
支持 [NapCat](https://github.com/NapNeko/NapCatQQ)、[go-cqhttp](https://github.com/Mrs4s/go-cqhttp) 等所有兼容 OneBot 11 协议的 QQ 机器人框架。
说明：
- npm 包名是 `openclaw-onebot`
- ClawHub package payload 包名是 `openclaw-onebot-plugin`
- 插件 `id` 是 `openclaw-onebot`
- 通道 `id` 仍然是 `onebot`
- 因此 `plugins.allow` / `plugins.entries` 使用 `openclaw-onebot`；安装记录由 `openclaw plugins install` 管理
- `channels.onebot` 保持不变
- 当前版本对齐 OpenClaw `2026.4.26` / plugin-sdk `2026.4.26`，并声明 `setupEntry` 与 `channelConfigs` manifest metadata
### 功能
- 🔌 **原生通道插件** — QQ 与 Discord / Telegram / WhatsApp 同级
- 📨 私聊和群聊收发消息
- 😀 **Reaction 支持（群聊）** — 通过 NapCat `set_msg_emoji_like` 给群消息加表情回应；QQ 私聊目前不稳定/通常不生效
- 👍 **群聊自动 reaction** — 对入站群消息自动点表情，可配置开关，默认关闭
- 🌊 **Block streaming** — 支持 OpenClaw 分块回复，QQ 端会连续收到多条流式消息
- 🧭 **OpenClaw 文本命令支持** — 已授权来源可使用 `/status`、`/help`、`/commands`、`/model`、`/new`、`/reset` 等命令
- 🎤 **语音完整链路** — QQ 语音 (SILK/AMR) → MP3 → STT → TTS → 发送 QQ 语音
- 📦 **消息聚合** — 连续多条消息 1.5s 内自动合并（类似 Telegram 风格）
- 🖼️ 图片、语音、文件附件发送
- 🔄 WebSocket 自动重连（指数退避）
- 🔒 可选 access token 鉴权
- 🎯 `allowFrom` 消息来源过滤（私聊/群聊/用户级别）
- 🛡️ 未配置 `allowFrom` 时 QQ 文本命令不会被授权；需要显式白名单或 `["*"]`
- ✅ 120 个测试用例全部通过
- 📈 覆盖率可通过 `npm run coverage` 复核
### 快速开始
#### 1. 安装
```bash
# 推荐：直接安装已发布的 ClawHub payload
openclaw plugins install clawhub:openclaw-onebot-plugin
# 自动安装；默认不会修改本机 OpenClaw CLI dist
bash scripts/install.sh
# 或审查源码后手动准备本地发布包
npm install && npm run prepare:clawhub:plugin
openclaw plugins install .clawhub-plugin/openclaw-onebot-plugin
```
`scripts/install.sh` 会先在源码仓库生成 `.clawhub-plugin/openclaw-onebot-plugin` 精简发布包，并优先通过 `openclaw plugins install` 写入新版插件安装索引；旧版 OpenClaw 会回退到手动复制安装。脚本默认不会修改 OpenClaw CLI dist；只有当你的 OpenClaw 构建缺少 `--shared-dir` / `--container-shared-dir` setup 参数时，才需要显式执行 `ONEBOT_SYNC_OPENCLAW_CLI=1 bash scripts/install.sh` 或 `npm run sync:openclaw-cli`。
#### 2. 配置
在 `openclaw.json` 中添加：
```json
{
"plugins": {
"allow": ["openclaw-onebot"],
"entries": {
"openclaw-onebot": {
"enabled": true
}
}
},
"channels": {
"onebot": {
"enabled": true,
"wsUrl": "ws://your-host:3001",
"httpUrl": "http://your-host:3001",
"accessToken": "your_token",
"sharedDir": "/Users/you/napcat/shared",
"containerSharedDir": "/shared",
"aREADME.md
# OpenClaw OneBot 11 Channel Plugin 🐧
[中文](#中文) | [English](#english)
---
## 中文
OpenClaw 的 **OneBot 11 协议通道插件**，让 QQ 成为 OpenClaw 一等消息通道。
支持 [NapCat](https://github.com/NapNeko/NapCatQQ)、[go-cqhttp](https://github.com/Mrs4s/go-cqhttp) 等所有兼容 OneBot 11 协议的 QQ 机器人框架。
说明：
- npm 包名是 `openclaw-onebot`
- ClawHub package payload 包名是 `openclaw-onebot-plugin`
- 插件 `id` 是 `openclaw-onebot`
- 通道 `id` 仍然是 `onebot`
- 因此 `plugins.allow` / `plugins.entries` 使用 `openclaw-onebot`；安装记录由 `openclaw plugins install` 管理
- `channels.onebot` 保持不变
- 当前版本对齐 OpenClaw `2026.4.26` / plugin-sdk `2026.4.26`，并声明 `setupEntry` 与 `channelConfigs` manifest metadata
### 功能
- 🔌 **原生通道插件** — QQ 与 Discord / Telegram / WhatsApp 同级
- 📨 私聊和群聊收发消息
- 😀 **Reaction 支持（群聊）** — 通过 NapCat `set_msg_emoji_like` 给群消息加表情回应；QQ 私聊目前不稳定/通常不生效
- 👍 **群聊自动 reaction** — 对入站群消息自动点表情，可配置开关，默认关闭
- 🌊 **Block streaming** — 支持 OpenClaw 分块回复，QQ 端会连续收到多条流式消息
- 🧭 **OpenClaw 文本命令支持** — 已授权来源可使用 `/status`、`/help`、`/commands`、`/model`、`/new`、`/reset` 等命令
- 🎤 **语音完整链路** — QQ 语音 (SILK/AMR) → MP3 → STT → TTS → 发送 QQ 语音
- 📦 **消息聚合** — 连续多条消息 1.5s 内自动合并（类似 Telegram 风格）
- 🖼️ 图片、语音、文件附件发送
- 🛠️ 通用 `sendMedia` 出站适配，delivery recovery / mirror / message tool 等通路都能发送图片、语音、文件
- 🔄 WebSocket 自动重连（指数退避）
- 🔒 可选 access token 鉴权
- 🎯 `allowFrom` 消息来源过滤（私聊/群聊/用户级别）
- 🛡️ 未配置 `allowFrom` 时 QQ 文本命令不会被授权；需要显式白名单或 `["*"]`
- ✅ 120 个测试用例全部通过
- 📈 覆盖率可通过 `npm run coverage` 复核
### 架构
```
QQ 机器人框架 (NapCat / go-cqhttp)
├── WebSocket → 接收消息 (含语音 SILK/AMR 自动转 MP3)
└── HTTP API → 发送消息 (文字/图片/语音)
↕
OpenClaw OneBot Plugin (ChannelPlugin)
├── 消息聚合 (1.5s debounce)
├── 语音处理 (SILK → pilk → PCM → ffmpeg → MP3)
└── allowFrom 过滤
↕
OpenClaw Gateway (统一消息管线)
├── STT (语音转文字)
├── Agent 对话
├── Block streaming (多段消息回复)
├── Reaction action
└── TTS (文字转语音) → sendRecord → QQ 语音
```
### 快速开始
#### 1. 安装插件
```bash
# 推荐：直接安装已发布的 ClawHub payload
openclaw plugins install clawhub:openclaw-onebot-plugin
# 自动安装；默认不会修改本机 OpenClaw CLI dist
bash scripts/install.sh
# 或审查源码后手动准备本地发布包
npm install && npm run prepare:clawhub:plugin
openclaw plugins install .clawhub-plugin/openclaw-onebot-plugin
```
`scripts/install.sh` 会先在源码仓库生成 `.clawhub-plugin/openclaw-onebot-plugin` 精简发布包，并优先通过 `openclaw plugins install` 写入新版插件安装索引；旧版 OpenClaw 会回退到手动复制安装。脚本默认不会修改 OpenClaw CLI dist；只有当你的 OpenClaw 构建缺少 `--shared-dir` / `--container-shared-dir` setup 参数时，才需要显式执行 `ONEBOT_SYNC_OPENCLAW_CLI=1 bash scripts/install.sh` 或 `npm run sync:openclaw-cli`。
#### 2. 配置
在 `openclaw.json` 中添加：
```json
{
"plugins": {
"allow": ["openclaw-onebot"],
"entries": {
"openclaw-onebot": {
"enabled": true
}
}
},
"channels": {
"onebot": {
"enabled": true,
"wsUrl": "ws://your-host:3001",
"httpUrl": "http://your-host:3001",
"accessToken": "your_token",
"sharedDir": "/Users/you/napcat/shared",
"containerSharedDir": "/shared",
"allowFrom": ["private:12345"],
"groupAutoReact": false,_meta.json
{
"ownerId": "kn7acew66bsj3ef4fmc64ab2px7zzf7b",
"slug": "openclaw-onebot",
"version": "1.2.15",
"publishedAt": 1780295610427
}skill-card.md
## Description: OneBot 11 channel plugin for QQ messaging (NapCat/go-cqhttp), with OpenClaw integration for private and group chat, opt-in group reactions, block streaming, voice handling, message batching, allowFrom filtering, shared-directory media staging, and authorized text-command passthrough. This skill is ready for commercial/non-commercial use. ## Publisher: [xucheng](https://clawhub.ai/user/xucheng) ### License/Terms of Use: MIT-0 ## Use Case: Developers and operators use this skill to connect OpenClaw agents to QQ through OneBot 11-compatible frameworks such as NapCat or go-cqhttp. It supports QQ message routing, media handling, voice workflows, reactions, streaming replies, and controlled text-command access. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Untrusted plugin or QQ bot framework code can affect message handling and media workflows. Mitigation: Install only from trusted or pinned sources and review the OpenClaw plugin and connected OneBot framework before deployment. Risk: Exposed OneBot HTTP or WebSocket endpoints can allow unauthorized access to QQ messaging actions. Mitigation: Use a strong access token and keep OneBot endpoints on localhost or a trusted network. Risk: Overbroad message-source filters can authorize unintended private users or groups. Mitigation: Configure allowFrom narrowly for trusted QQ private users or groups instead of using '*'. Risk: Shared media staging can expose unrelated local files if pointed at broad personal directories. Mitigation: Set sharedDir to a dedicated media directory rather than desktop, downloads, documents, or other personal folders. ## Reference(s): - [ClawHub OpenClaw OneBot Skill](https://clawhub.ai/xucheng/skills/openclaw-onebot) - [OpenClaw](https://github.com/openclaw/openclaw) - [NapCatQQ](https://github.com/NapNeko/NapCatQQ) - [go-cqhttp](https://github.com/Mrs4s/go-cqhttp) ## Skill Output: **Output Type(s):** [Guidance, Markdown, Shell commands, Configuration] **Output Format:** [Markdown with JSON and shell command examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Produces installation, configuration, verification, and operational guidance for OpenClaw OneBot channel setup.] ## Skill Version(s): 1.2.15 (source: server release evidence and artifact release.json) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
release.json
{
"output": "/Users/xucheng/repo/tools/openclaw-onebot/.clawhub-skill/openclaw-onebot",
"slug": "openclaw-onebot",
"displayName": "OpenClaw OneBot",
"version": "1.2.15"
}Github ReposUpdated 4h agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/xucheng/skills/openclaw-onebot",
"sourceUrl": "https://clawhub.ai/xucheng/skills/openclaw-onebot",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T20:23:55.627Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-xucheng-openclaw-onebot/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-xucheng-openclaw-onebot/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T20:23:55.627Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2K downloads",
"href": "https://clawhub.ai/xucheng/openclaw-onebot",
"sourceUrl": "https://clawhub.ai/xucheng/openclaw-onebot",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T20:23:55.627Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.2.15",
"href": "https://clawhub.ai/xucheng/openclaw-onebot",
"sourceUrl": "https://clawhub.ai/xucheng/openclaw-onebot",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-01T06:33:30.427Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-xucheng-openclaw-onebot/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-xucheng-openclaw-onebot/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.2.15",
"description": "Document the OneBot legacy groupAllowFrom compatibility release on the v1.2.13 safer defaults baseline.",
"href": "https://clawhub.ai/xucheng/openclaw-onebot",
"sourceUrl": "https://clawhub.ai/xucheng/openclaw-onebot",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-01T06:33:30.427Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.