openclaw_qq

2026-04-30 原生文件 / 媒体收发更新

本次更新把 QQ 文件与富媒体收发能力收进 openclaw_qq 插件本体,目标是:普通 OpenClaw 回复、message 工具、自动回复 payload 都可以直接通过 QQ 插件完成图片、语音、视频和普通文件发送,不再依赖外部“发文件 skill”兜底。

1. 这轮解决了什么

入站:QQ 文件能收到,但不再污染上下文

出站:图片、语音、视频、压缩包走插件原生逻辑

2. 为什么 TXT 不再自动读入上下文

QQ 文件附件和用户直接上传给模型看的文件不是一回事。

如果插件把普通 QQ 文件的本地路径直接塞进 MediaPath,OpenClaw runtime 可能会把 text/plain / .txt 自动展开成 <file>...</file>。这对“引用人格模板、日志、配置、压缩包说明”等场景很危险:文件内容可能不是用户当前指令,却会直接进入模型上下文。

因此本轮规则改为:

3. 路径与容器场景

插件同时兼容几类出站媒体来源:

普通文件上传时,插件会优先走 OneBot/NapCat 的文件上传接口。对于远端 NapCat 容器无法直接读取的本机文件,插件会尽量使用可被 OneBot 接受的 URL / base64 / 上传路径;如果配置了 sharedMediaHostDirsharedMediaContainerDir,本地文件也会先 staging 到共享目录再交给容器读取。

4. 失败回退策略

5. 已验证场景

本轮已实测:

6. 涉及的主要代码点

7. 使用建议