qq-send

name	qq_send
description	通用消息发送 — 通过 PushQueue 向 QQ（OneBot）或 Telegram 发送文本消息。当 Agent 需要主动推送通知、回复或提醒到外部平台时使用。
version	1.1
category	messaging
enabled	true
tags	["qq","telegram","message","push"]

发送消息 (QQ Send)

通过消息路由的 PushQueue 机制，向 QQ 或 Telegram 发送文本消息。消息通过异步队列发送，支持私聊和群聊。

插件路径

plugins/qq_send/

注册工具

工具	用途
send_qq_message	向 QQ（OneBot）或 Telegram 发送文本消息

参数

参数	类型	必需	默认值	说明
target	string	是	—	目标 ID：QQ 号 / TG 用户 ID / 群号
chat_type	string	是	—	private（私聊）或 group（群聊）
message	string	是	—	要发送的文本内容
platform	string	否	"onebot"	平台：onebot（QQ）或 telegram。由智能体根据用户消息来源或用户指令决定

结果说明

• 成功：返回 OK: 消息已入队, ID: <task_id> + 平台/目标信息
• 失败：返回 ERROR: 前缀的错误信息

典型场景

• 定时任务结果推送到 QQ/Telegram
• 主动通知用户某事已完成
• 群聊消息推送

常见规范

• platform 由智能体根据用户消息来源判断：用户从 QQ 来则用 onebot，从 Telegram 来则用 telegram
• 消息通过文件队列异步发送，非实时
• chat_type 仅支持 private 和 group，其他值会报错

常见处理办法

• 消息未送达：检查 PushQueue 是否正常运行，查看 message/push_queue/ 目录
• target 为空：确认目标 ID 非空（QQ 号 / TG 用户 ID / 群号）
• 平台不支持：确认 platform 为 onebot 或 telegram

常见教训

• 消息是异步入队，不代表对方已收到；实际投递依赖 OneBot/TG Bot 在线状态
• 发送群消息时 target 是群号，不是群名
• Telegram Bot 主动发起对话需要用户先 /start 过 Bot