目标

确保 openclaw 发送 QQ 消息（文本与媒体）时只使用本插件的 API，并让 sessionKey 满足 napcat 插件要求。

工作流

1. •

   识别消息类型：私聊或群聊。

2. •

   校验并构造 sessionKey：

   • •私聊：session:napcat:private:<QQ号>
   • •群聊：session:napcat:group:<群号>
3. •

   目标写法说明（重要）：

   • •群聊优先使用 target: group:<群号> 或 target: session:napcat:group:<群号>。
   • •纯数字 target 会被当作私聊用户 ID，容易导致“无法获取用户信息”。
4. •

   调用 message 工具时必须显式指定 channel: "napcat"，避免多通道场景下无法路由。

5. •

   媒体发送规则：

   • •发送图片/媒体时，使用 message 工具并传 mediaUrl。
   • •可选传 text 作为媒体说明（caption）。
   • •语音可直接传 .wav 等音频 URL/路径到 mediaUrl，插件会按语音消息发送。
   • •mediaUrl 需为 NapCat 可访问地址（通常是 http/https 局域网可达 URL）。
6. •

   语音生成与情绪策略（推荐约定，便于一致体验）：

   • •默认情绪策略：根据消息文本内容自动检测情绪/语气（由上游 TTS 侧实现）。
   • •显式覆盖规则：若用户明确指定情绪/语气（如“温柔/严肃/开心/激动”等），则覆盖自动检测结果。
   • •实践建议：将“默认音色/声线（voice profile）”作为本地环境偏好维护（见 TOOLS.md），避免在可分享的 skill 中绑定特定音色或语料路径。
7. •

   仅使用本插件的 API 完成发送，不要调用其他 QQ 发送途径。

交互规则

• •若用户未提供 QQ 号或群号，先询问并明确补全后再发送。
• •若用户提供了 sessionKey 但格式不符合规则，改写为正确格式并说明已规范化。
• •若用户含糊描述（如“发消息给他”），优先确认私聊/群聊与目标 ID。