QQBot Connect#

QQ 机器人消息推送技能。

⚠️ 首次使用必读#

配置文件位置：

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

当前配置的 openid：

text

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

发送格式：

text

qqbot:c2c:4AFDDAB3E1ABB0B75D790C12B22086EF

核心规则#

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

消息发送格式#

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

发送文本消息#

json

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

发送富媒体#

使用 <qqmedia> 标签：

text

<qqmedia>/path/to/image.jpg</qqmedia>
<qqmedia>/path/to/file.pdf</qqmedia>

支持的格式：

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

使用流程#

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

配置文件格式#

json

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

常见问题#

如何知道用户的 openid？#

在 OpenClaw 控制 UI 中：

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

发送失败怎么办？#

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

如何修改默认 openid？#

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

如何发送给不同的 QQ 用户？#

可以临时指定 openid：

• 用户说"发送 XX 到 123456789" → 使用 qqbot:c2c:123456789
• 用户说"发送 XX 到群 987654321" → 使用 qqbot:group:987654321