jianf/chat_rebot-connect-with-onebot-standard-

Template

Files

Claw 6ec3cd623d docs: 修正仓库地址引用，移除已删 skill 的引用

- SKILL.md 前置条件 → 链接到本仓库
- README.md 底部链接 → chat_rebot-connect-with-onebot-standard-
- SKILL.md 组件清单移除 browser/mc-query/nix-helper/file-process

2026-05-04 16:39:57 +08:00

2.5 KiB

Raw Blame History

id, name, description, version, icon, author

id	name	description	version	icon	author
openclaw-bridge	openclaw-bridge	OpenClaw Gateway QQ AI Reply — 完整部署方案	1.0.0	🤖	Claw

OpenClaw Bridge — QQ AI 回复 AgentSkill

一站式部署 QQ AI 回复机器人的完整方案。

架构

QQ 用户 ──→ NapCat ──→ qqrebot ──→ 本插件 ──→ OpenClaw Gateway ──→ qq-agent

组件清单

1. qqrebot 插件（被动接收）

src/process.py — QQ消息→OpenClaw Gateway 桥接
config/openclawbridge/config.toml — 配置（含安全词库）

2. QQ 操作脚本（主动能力）

放在 scripts/ 下，通过 subprocess 调用直连 NapCat API：

qq_send_msg.py — 发文本消息
qq_send_file.py — 发文件/图片
qq_get_groups.py / qq_get_friends.py — 查询
qq_get_history.py — 历史消息回溯
qq_resolve_name.py — QQ号↔名称解析
qq_friend_action.py — 好友管理（删/拉黑）
qq_group_action.py / qq_group_manage.py — 群管理
qq_get_group_files.py / qq_upload_group_file.py — 群文件
qq_send_like.py — 点赞/戳一戳
qq_ocr_image.py — 图片OCR
qq_video_download.py — 视频下载

3. Agent Skills（使用指导）

放在 skills/ 下：

qq-messenger/ — 发送消息/文件
qq-management/ — 群/好友管理
qq-resolver/ — 信息查询
qq-napcat-extras/ — 点赞/OCR

部署步骤

前置条件

运行中的 NapCat / go-cqhttp
运行中的 qqrebot（本仓库即为 qqrebot 源码）
运行中的 OpenClaw Gateway
已配置的 qq-agent

1. 配置插件

编辑 config/openclawbridge/config.toml：

gateway_url — OpenClaw Gateway 地址
gateway_token — 认证 Token
allowed_sender — 管理员 QQ 号
model / agent_id — 使用的 agent

2. 打包（在目标主机执行）

bash packup.sh
# 得到 dist/openclaw_bridge.zip

3. 部署

cp dist/openclaw_bridge.zip /path/to/qqrebot/plugins/
systemctl restart qqrebot

4. 配置 Agent

将 scripts/ 和 skills/ 部署到 qq-agent 的工作区，参照各 skills/SKILL.md 中的说明使用。

安全特性

高危词检测（可配置）
管理员白名单
MC 指令过滤
错误信息脱敏

注意事项

打包必须在目标主机执行 — C 扩展兼容性
首次部署后检查日志确认插件加载成功
管理员QQ号不要用默认占位符
Gateway Token 是敏感信息，不要提交到 git

2.5 KiB Raw Blame History Unescape Escape