[问题反馈] 插件3.6.2，openclaw v2026.4.15版本，无法发送文件

[qxia1989]

背景与问题概述

私聊机器人窗口，发送消息把指定路径的文件发给自己，能收到恢复完成，但是收不到文件

复现步骤

1.在钉钉中发送消息，把文件发给我：/home/node/.openclaw/workspace/xxxxx.txt
2.机器人回复已发送，但是没有文件
3.openclaw控制台中聊天窗口能看到文件，文件路径没问题

期望行为

收到文件

实际行为

收不到机器人发送的文件

发生范围

单聊

环境信息

openclaw v2026.4.15
插件 v3.6.2
配置信息
"channels": {
"dingtalk": {
"enabled": true,
"clientId": "xxxx",
"clientSecret": "xxxxxxx",
"dmPolicy": "open",
"groupPolicy": "open",
"messageType": "markdown"
}
}

相关日志、截图或补充信息

{"0":"{"subsystem":"gateway/channels/dingtalk"}","1":"[DingTalk] Native ack reaction recall succeeded","_meta":{"runtime":"node","runtimeVersion":"24.14.0","hostname":"db8195dc93e0","name":"{"subsystem":"gateway/channels/dingtalk"}","parentNames":["openclaw"],"date":"2026-05-08T07:45:12.708Z","logLevelId":3,"logLevelName":"INFO","path":{"fullFilePath":"file:///app/dist/subsystem-Cgmckbux.js:324:14","fileName":"subsystem-Cgmckbux.js","fileNameWithLine":"subsystem-Cgmckbux.js:324","fileColumn":"46","fileLine":"153","filePath":"dist/subsystem-Cgmckbux.js","filePathWithLine":"dist/subsystem-Cgmckbux.js:153"}},"time":"2026-05-08T07:45:12.708+00:00"}
{"0":"{"subsystem":"gateway/channels/dingtalk"}","1":"[DingTalk] Inbound: from=[用户名] text="请把文件发我：[文件路径]"","_meta":{"runtime":"node","runtimeVersion":"24.14.0","hostname":"db8195dc93e0","name":"{"subsystem":"gateway/channels/dingtalk"}","parentNames":["openclaw"],"date":"2026-05-08T07:45:18.397Z","logLevelId":3,"logLevelName":"INFO","path":{"fullFilePath":"file:///app/dist/subsystem-Cgmckbux.js:324:14","fileName":"subsystem-Cgmckbux.js","fileNameWithLine":"subsystem-Cgmckbux.js:324","fileColumn":"46","fileLine":"153","filePath":"dist/subsystem-Cgmckbux.js","filePathWithLine":"dist/subsystem-Cgmckbux.js:153"}},"time":"2026-05-08T07:45:18.397+00:00"}
{"0":"{"subsystem":"gateway/channels/dingtalk"}","1":"[DingTalk] Native ack reaction attach succeeded (msgId=[消息ID] conversationId=[会话ID] reactionName=👀 attempt=1/3)","_meta":{"runtime":"node","runtimeVersion":"24.14.0","hostname":"db8195dc93e0","name":"{"subsystem":"gateway/channels/dingtalk"}","parentNames":["openclaw"],"date":"2026-05-08T07:45:18.848Z","logLevelId":3,"logLevelName":"INFO","path":{"fullFilePath":"file:///app/dist/subsystem-Cgmckbux.js:324:14","fileName":"subsystem-Cgmckbux.js","fileNameWithLine":"subsystem-Cgmckbux.js:324","fileColumn":"46","fileLine":"153","filePath":"dist/subsystem-Cgmckbux.js","filePathWithLine":"dist/subsystem-Cgmckbux.js:153"}},"time":"2026-05-08T07:45:18.848+00:00"}
{"0":"{"subsystem":"gateway/channels/dingtalk"}","1":"[DingTalk][Dispatch] completed — deliveredFinalCount=0 counts.final=0 queuedFinalType=boolean","_meta":{"runtime":"node","runtimeVersion":"24.14.0","hostname":"db8195dc93e0","name":"{"subsystem":"gateway/channels/dingtalk"}","parentNames":["openclaw"],"date":"2026-05-08T07:45:31.785Z","logLevelId":3,"logLevelName":"INFO","path":{"fullFilePath":"file:///app/dist/subsystem-Cgmckbux.js:324:14","fileName":"subsystem-Cgmckbux.js","fileNameWithLine":"subsystem-Cgmckbux.js:324","fileColumn":"46","fileLine":"153","filePath":"dist/subsystem-Cgmckbux.js","filePathWithLine":"dist/subsystem-Cgmckbux.js:153"}},"time":"2026-05-08T07:45:31.785+00:00"}

Inbound: from=[用户名] text="帮我创建一个test.md文件，写入今天日期后把文件发我..."
openclaw-gateway-1 | 2026-05-08T08:52:11.859+00:00 [dingtalk] Native ack reaction attach succeeded (msgId=[消息ID] conversationId=[会话ID] reactionName=👀 attempt=1/3)
openclaw-gateway-1 | 2026-05-08T08:52:50.927+00:00 [dingtalk] Send message failed: Session webhook file send failed: code=401102 message=miss param : file->mediaId
openclaw-gateway-1 | 2026-05-08T08:52:50.930+00:00 [dingtalk] Reply failed: Session webhook file send failed: code=401102 message=miss param : file->mediaId
openclaw-gateway-1 | 2026-05-08T08:52:50.932+00:00 [dingtalk] [Dispatch] completed — deliveredFinalCount=0 counts.final=0 queuedFinalType=boolean
openclaw-gateway-1 | 2026-05-08T08:52:51.650+00:00 [dingtalk] Native ack reaction recall succeeded

提交前确认

• 我已搜索现有 Issue，暂未发现可直接合并的问题报告
• 我已对日志、截图、payload 中的敏感信息做过脱敏
• 我已阅读仓库中的 CONTRIBUTING 文档，并尽量补齐了定位所需信息

[soimy]

排查简报（2026-05-08）

我复核了本 Issue 的日志、当前 v3.6.2 代码路径，以及钉钉公开资料，初步判断这不是用户侧文件路径或权限问题，而是当前 sessionWebhook 媒体发送分支的设计需要调整。

关键证据

• 日志中的核心错误是：Session webhook file send failed: code=401102 message=miss param : file->mediaId。这说明链路已经进入“sessionWebhook 文件发送”分支，但钉钉没有接受当前文件消息 payload。
• 当前代码在 sendBySession() 中会对 image/voice/video/file 构造原生媒体 body，其中 file 当前为 { msgtype: "file", file: { media_id: mediaId } }。
• 钉钉开发者百科《机器人回复/发送消息》说明：Webhook 方式主要用于简单文本、Markdown；OpenAPI 用于上传图片、卡片等更丰富消息形式：https://open-dingtalk.github.io/developerpedia/docs/learn/bot/appbot/reply/
• 钉钉 Stream FAQ 说明：Markdown 中图片可以先上传媒体文件获得 MediaId，再把 MediaId 当作图片 URL 使用：https://opensource.dingtalk.com/developerpedia/docs/learn/stream/faq/
• AI 助理发送消息文档也把 SessionWebhook 回复与 OpenAPI 回复/主动发送区分为不同模式：https://opensource.dingtalk.com/developerpedia/docs/develop/agent/send-message/

初步结论

从公开资料看，sessionWebhook 不应作为直接发送 file/voice/video 的稳定能力来依赖。即使把当前 file.media_id 改成 file.mediaId，也可能只是追着后端参数报错跑，不能保证文件回复路径长期稳定。

当前更符合既有设计和钉钉公开资料的方案是：

1. sessionWebhook + image：上传图片拿到 mediaId 后，发送 Markdown：![filename](mediaId)。这与现有 replaceMarkdownLocalImages() 的实现思路一致。
2. sessionWebhook + file/video/voice：不要再向 sessionWebhook POST msgtype: file/video/voice；改为转 sendProactiveMedia()，通过机器人 OpenAPI 模板消息发送文件。
3. 保留文本/Markdown 兜底：如果主动发送因为权限或目标不可达失败，应回复文件路径/失败原因，避免用户看到“已发送”但实际没有收到文件。

建议修复项

• 调整 sendBySession() 的媒体分支：图片转 Markdown 内嵌 mediaId；非图片媒体转 proactive media。
• 更新 deliverMediaAttachments() / sendMessage() 相关测试，覆盖单聊 sessionWebhook 下图片与文件两条路径。
• 增加回归测试，确保不再向 sessionWebhook 发送 msgtype: file，避免复现本 Issue。

[qxia1989]

@soimy 大佬这个问题已经修复了吗？我拉取了最新源码安装，使用markdown模式，尝试让agent发送txt文件给我，还是不行

从日志看没有也没有Send message failed:相关信息

[soimy]

在PR中修复了，如果你不是直接拉取PR测试的，就等周末会发新版的

[qxia1989]

好的

[soimy]

已在新发布的 Release v3.6.3 Latest 中做了修复，请更新测试。如果还有遗留问题，欢迎重新打开Issue并提供反馈

[qxia1989]

已在新发布的 Release v3.6.3 Latest 中做了修复，请更新测试。如果还有遗留问题，欢迎重新打开Issue并提供反馈

我安装了3.6.3版本插件，重新试了还是没有收到文件：

[qxia1989]

使用agent命令可以发送成功

[qxia1989]

补充下日志：
openclaw-gateway-1 | 2026-05-16T07:06:21.223+00:00 [dingtalk] Inbound: from=[USER_NAME] text="把/home/node/.openclaw/workspace/downloads/test.txt..."
openclaw-gateway-1 | 2026-05-16T07:06:21.686+00:00 [dingtalk] Native ack reaction attach succeeded (msgId=[MESSAGE_ID]/Q== conversationId=[CONVERSATION_ID] reactionName=👀 attempt=1/3)
openclaw-gateway-1 | 2026-05-16T07:06:24.220+00:00 [dingtalk] [Dispatch] completed — deliveredFinalCount=0 counts.final=0 queuedFinalType=boolean
openclaw-gateway-1 | 2026-05-16T07:06:24.896+00:00 [dingtalk] Native ack reaction recall succeeded

{"0":"{"subsystem":"gateway/channels/dingtalk"}","1":"[DingTalk] Native ack reaction recall succeeded","_meta":{"runtime":"node","runtimeVersion":"24.14.0","hostname":"[HOSTNAME]","name":"{"subsystem":"gateway/channels/dingtalk"}","parentNames":["openclaw"],"date":"2026-05-16T07:00:56.772Z","logLevelId":3,"logLevelName":"INFO","path":{"fullFilePath":"file:///app/dist/subsystem-Cgmckbux.js:324:14","fileName":"subsystem-Cgmckbux.js","fileNameWithLine":"subsystem-Cgmckbux.js:324","fileColumn":"14","fileLine":"324","filePath":"dist/subsystem-Cgmckbux.js","filePathWithLine":"dist/subsystem-Cgmckbux.js:324","method":"logToFile"}},"time":"2026-05-16T07:00:56.772+00:00"}
{"0":"{"subsystem":"gateway/channels/dingtalk"}","1":"[DingTalk] Inbound: from=[USER_NAME] text="把/home/node/.openclaw/workspace/downloads/test.txt..."","_meta":{"runtime":"node","runtimeVersion":"24.14.0","hostname":"[HOSTNAME]","name":"{"subsystem":"gateway/channels/dingtalk"}","parentNames":["openclaw"],"date":"2026-05-16T07:06:21.221Z","logLevelId":3,"logLevelName":"INFO","path":{"fullFilePath":"file:///app/dist/subsystem-Cgmckbux.js:324:14","fileName":"subsystem-Cgmckbux.js","fileNameWithLine":"subsystem-Cgmckbux.js:324","fileColumn":"14","fileLine":"324","filePath":"dist/subsystem-Cgmckbux.js","filePathWithLine":"dist/subsystem-Cgmckbux.js:324","method":"logToFile"}},"time":"2026-05-16T07:06:21.222+00:00"}
{"0":"{"subsystem":"gateway/channels/dingtalk"}","1":"[DingTalk] Native ack reaction attach succeeded (msgId=[MESSAGE_ID] conversationId=[CONVERSATION_ID] reactionName=👀 attempt=1/3)","_meta":{"runtime":"node","runtimeVersion":"24.14.0","hostname":"[HOSTNAME]","name":"{"subsystem":"gateway/channels/dingtalk"}","parentNames":["openclaw"],"date":"2026-05-16T07:06:21.685Z","logLevelId":3,"logLevelName":"INFO","path":{"fullFilePath":"file:///app/dist/subsystem-Cgmckbux.js:324:14","fileName":"subsystem-Cgmckbux.js","fileNameWithLine":"subsystem-Cgmckbux.js:324","fileColumn":"14","fileLine":"324","filePath":"dist/subsystem-Cgmckbux.js","filePathWithLine":"dist/subsystem-Cgmckbux.js:324","method":"logToFile"}},"time":"2026-05-16T07:06:21.686+00:00"}
{"0":"{"subsystem":"gateway/channels/dingtalk"}","1":"[DingTalk][Dispatch] completed — deliveredFinalCount=0 counts.final=0 queuedFinalType=boolean","_meta":{"runtime":"node","runtimeVersion":"24.14.0","hostname":"[HOSTNAME]","name":"{"subsystem":"gateway/channels/dingtalk"}","parentNames":["openclaw"],"date":"2026-05-16T07:06:24.219Z","logLevelId":3,"logLevelName":"INFO","path":{"fullFilePath":"file:///app/dist/subsystem-Cgmckbux.js:324:14","fileName":"subsystem-Cgmckbux.js","fileNameWithLine":"subsystem-Cgmckbux.js:324","fileColumn":"14","fileLine":"324","filePath":"dist/subsystem-Cgmckbux.js","filePathWithLine":"dist/subsystem-Cgmckbux.js:324","method":"logToFile"}},"time":"2026-05-16T07:06:24.220+00:00"}
{"0":"{"subsystem":"gateway/channels/dingtalk"}","1":"[DingTalk] Native ack reaction recall succeeded","_meta":{"runtime":"node","runtimeVersion":"24.14.0","hostname":"[HOSTNAME]","name":"{"subsystem":"gateway/channels/dingtalk"}","parentNames":["openclaw"],"date":"2026-05-16T07:06:24.895Z","logLevelId":3,"logLevelName":"INFO","path":{"fullFilePath":"file:///app/dist/subsystem-Cgmckbux.js:324:14","fileName":"subsystem-Cgmckbux.js","fileNameWithLine":"subsystem-Cgmckbux.js:324","fileColumn":"14","fileLine":"324","filePath":"dist/subsystem-Cgmckbux.js","filePathWithLine":"dist/subsystem-Cgmckbux.js:324","method":"logToFile"}},"time":"2026-05-16T07:06:24.896+00:00"}