📦 QQ-Bot-connect — QQ消息推送

v1.0.0

通过读取本地 config 获取 openid,调用平台 message 工具向 QQ 用户或群主动发送文本、图片、语音、文件等富媒体消息,支持群发。

0· 217·1 当前·1 累计
jcduann 头像by @jcduann (JCDuann)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/4/4
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
This instruction-only skill is internally consistent with its stated purpose (sending QQ messages) and only reads a local config file to obtain a target openid; it does not request extra credentials or install code.
评估建议
This skill appears to do what it says: it reads a local config.json to get an openid and uses your agent's message tool to send to QQ targets. Before installing: (1) confirm you are comfortable storing the target openid in the local config file and do not place secrets there; (2) verify the 'message' tool is trusted (messages sent by the agent will be delivered to the QQ account/ group you specify); (3) test with your own account/group to avoid accidental broadcasts; (4) if you do not want the a...
详细分析 ▾
用途与能力
名称与描述声明推送 QQ 消息;SKILL.md 仅要求读取本地 config.json 获取 openid,并调用平台 message 工具发送至 qqbot:c2c:... 或 qqbot:group:... 未请求无关二进制文件、云凭证或其他服务,所需能力与目的一致。
指令范围
运行时指令范围狭窄:读取技能 config.json,构造目标字符串,调用 message 工具发送文本或媒体。SKILL.md 未指示读取任意系统文件或向 QQ 消息通道外发送数据。注意:文档给出示例本地路径——技能期望本地配置文件并指示用户编辑以填写 openid。
安装机制
无安装规范且无代码文件——纯指令型。这是最低风险安装姿态,因为技能安装器不会下载或写入任何内容。
凭证需求
技能未声明所需环境变量或凭证,其 config.json 仅含 openid 占位符。所请求访问与功能(向指定 QQ 目标发送消息)成比例。
持久化与权限
always 为 false(常规)。技能允许常规自主调用(disable-model-invocation 为 false),属平台默认;因可发送消息,用户需知代理可能自主调用。技能未请求持久系统级权限或修改其他技能。
安全有层次,运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发,无需署名。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/4/4

qq-bot-connect 1.0.0 初始版本发布 - 支持主动发送消息到 QQ 用户或群聊,包括文本和富媒体(图片、语音、文件等) - 提供消息发送格式与 target/channel 参数规范 - 配置方法详述,支持自定义 openid 和 groupid - 附带常见问题说明和操作流程 - 触发词包括“发送 QQ”、“推送 QQ”、“QQ 消息”等

无害

安装命令

点击复制
官方npx clawhub@latest install qq-bot-connect
镜像加速npx clawhub@latest install qq-bot-connect --registry https://cn.longxiaskill.com

技能文档

QQ 机器人消息推送技能。

⚠️ 首次使用必读

配置文件位置:

  • C:\Users\21115\.qclaw\skills\qqbot-connect\config.json
  • E:\QClaw\skills\qqbot-connect\config.json (改成自己的位置)

当前配置的 openid:

openid: (修改成自己的openid)
type: c2c (私聊)
name: 主人

发送格式:

qqbot:c2c:4AFDDAB3E1ABB0B75D790C12B22086EF

核心规则

必须使用 message 工具发送消息!

消息发送格式

类型target 参数channel 参数
私聊qqbot:c2c:{openid}qqbot
群聊qqbot:group:{groupid}qqbot

发送文本消息

{
  "action": "send",
  "channel": "qqbot",
  "target": "qqbot:c2c:4AFDDAB3E1ABB0B75D790C12B22086EF",
  "message": "要发送的消息内容"
}

发送富媒体

使用 标签:

/path/to/image.jpg
/path/to/file.pdf

支持的格式:

  • 图片:.jpg, .png, .gif, .webp, .bmp
  • 语音:.silk, .wav, .mp3, .ogg, .aac, .flac
  • 视频:.mp4, .mov, .avi, .mkv, .webm
  • 文件:其他扩展名

使用流程

  • 用户请求发送消息 → 如"发送 hello 到 QQ"
  • 读取 config.json → 获取 openid
  • 拼接 targetqqbot:c2c: + openid
  • 使用 message 工具发送
  • 确认发送成功 → 返回结果给用户

配置文件格式

{
  "_readme": "QQ-bot-connect 配置文件",
  "default": {
    "openid": "4AFDDAB3E1ABB0B75D790C12B22086EF",
    "type": "c2c",
    "name": "主人"
  },
  "_format": {
    "c2c_private": "qqbot:c2c:{openid}",
    "group": "qqbot:group:{groupid}"
  }
}

常见问题

如何知道用户的 openid?

在 OpenClaw 控制 UI 中:

  • 打开左侧 QQ 机器人对话面板
  • 查看对话标题栏显示的会话标识
  • 格式如:qqbot:c2c:4AFDDAB3E1ABB0B75D790C12B22086EF

发送失败怎么办?

  • 检查 target 格式是否正确(必须是 qqbot:c2c:{openid}
  • 确保 openid 与当前对话匹配
  • 确认 QQ 机器人已正确配置

如何修改默认 openid?

编辑 config.json 中的 default.openid 字段。

如何发送给不同的 QQ 用户?

可以临时指定 openid:

  • 用户说"发送 XX 到 123456789" → 使用 qqbot:c2c:123456789
  • 用户说"发送 XX 到群 987654321" → 使用 qqbot:group:987654321
数据来源ClawHub ↗ · 中文优化:龙虾技能库