Feishu Image Sender 飞书发图指南 — Feishu Image Sender 飞书发图指南 翻译： 飞书图片发送器 飞书发送图片指南

飞书 IM 工具 使用带有 channel=feishu 的消息工具进行所有 IM 操作。 发送文本消息 message(action=send, channel=feishu, target=, message="文本") 发送图片（正确方法） 始终使用 filePath 或 media，永远不要在消息文本中粘贴原始路径。 message(action=send, channel=feishu, target=, filePath="/绝对路径/到/image.jpg") 或者带有标题： message(action=send, channel=feishu, target=, media="/路径/到/image.jpg", message="标题文本") 工具内部处理两步上传： POST /im/v1/images → 获取 image_key POST /im/v1/messages 带有 image_key 常见故障模式 — 图片显示为路径/链接 请参阅 references/image-sending-pitfalls.md 以获取完整的诊断。 TL;DR 根本原因： 助手在消息文本中写入原始文件路径，而不是调用消息工具 → 纯文本，无上传 使用 MEDIA:/绝对路径 → 安全过滤器剥离它 image_type 在上传期间错误（必须是 message，而不是 avatar） tenant_access_token 过期（TTL ~2h）→ 上传静默失败，key 为空 Webhook 自定义机器人代替 Bot App → 无 access_token，无法上传图片 所需权限 范围 目的 im:resource 上传图片/文件到 IM，获取 file_key / image_key im:message 发送带有媒体的消息 im:message:send_as_bot 以机器人身份发送 目前所有三个权限都已在此安装中授予。 机器人类型比较 功能 Webhook 自定义机器人 Bot App (自建应用) 发送文本 ✅ ✅ 发送图片 ⚠️ 仅 base64（不推荐） ✅ 通过 image_key access_token ❌ 无 ✅ tenant_access_token 上传 API ❌ 不支持 ✅ /im/v1/images OpenClaw 使用 Bot App — 始终使用消息工具，而不是原始 Webhook POST。 令牌刷新 tenant_access_token 在 ~2 小时后过期。 如果上传静默失败： 错误代码 99991663 = image_key 无效 错误代码 99991400 = 令牌过期 OpenClaw 在每次 API 调用时自动刷新令牌。 如果您看到这些错误，请检查 Gateway 日志。 参考 references/image-sending-pitfalls.md — 详细故障模式诊断 飞书 API 文档：https://open.feishu.cn/document/server-docs/im-v1/image/create