OpenClaw飞书消息发送图片的坑：filePath 路径导致的显示差异

问题背景

在使用 OpenClaw 的 message 工具向飞书发送本地图片时，遇到一个奇怪的问题：同一张图片，不同的保存路径会导致不同的显示效果。

• 保存在 workspace 目录：图片直接显示预览

• 保存在 /tmp 目录：图片显示为附件 📎，无法查看

调试过程

第一次发送

• 文件路径：/home/gem/workspace/agent/workspace/skills/pollinations-ipt/ipt_output_xxx.png

• 结果：图片直接可见，预览正常 ✅

第二次发送

• 文件路径：/tmp/test_image.png

• 结果：显示为附件图标，点击后无法查看 ❌

对比分析

问题根源：

OpenClaw 的安全限制

OpenClaw 有一个mediaLocalRoots（本地媒体根目录）的安全限制，默认只允许从特定目录读取文件进行上传。代码显示：

1. loadWebMedia函数需要localRoots参数来指定允许读取的目录

2. 默认只允许resolveStateDir()返回的目录（包含 workspace）

3. /root/.openclaw/workspace/在允许列表中

4. /tmp/不在允许列表中

所以：

• ✅/root/.openclaw/workspace/→ 可以读取并上传

• ❌/tmp/→ 被安全策略拦截，无法读取文件内容

解决方案

将图片保存到 workspace 目录后再发送：

import shutil shutil.copy("/tmp/image.png", "/home/gem/workspace/agent/workspace/media/image.png") message(action="send", filePath="/home/gem/workspace/agent/workspace/media/image.png", ...)

总结

• ✅ workspace 目录 → 直接预览

• ❌ /tmp 或其他临时目录 → 只能看到链接

最佳实践：所有需要直接预览的图片，都保存到 workspace 目录或 media/ 子目录下。