Agent Skills
返回列表
飞书发送图片消息

飞书发送图片消息

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_55cd17ff/feishu-send-image-message。

技能介绍

要解决什么问题

在飞书里发图,常见路径是客户端里点上传。若你已经在本地有截图或导出文件,并希望由 OpenClaw 托管的当前飞书会话直接发出,就需要走开放平台:先拿 tenant_access_token,再把文件上传成 image_key,最后用 msg_type=image 投递消息。手工拼 curl 和 JSON 容易在 image_type、receive_id_type 上踩坑。

本技能把这条链路收成固定步骤:给定本地可读的图片路径和当前会话上下文,完成上传并发送,并回传 image_key 与 message_id。

技能如何工作

  1. 从 ~/.openclaw/openclaw.json 读取 channels.feishu.appId 与 channels.feishu.appSecret。
  2. 请求租户访问令牌 tenant_access_token,供后续 API 使用。
  3. 调用飞书图片上传接口(image_type=message),从响应取出 data.image_key;上传成功前保留本地文件。
  4. 向当前会话发送图片消息:msg_type=image,content 为包含 image_key 的 JSON 字符串,并按会话选择正确的 receive_id_type 与接收方 ID。

运行环境需具备 curl、jq,且飞书应用已配置 im:resource 等与上传、发消息相关的权限。

适用边界与注意点

  • 前置条件:当前对话由 OpenClaw 在飞书中处理;凭证文件已配置;输入路径存在且可读。
  • 安全:仅上传用户明确要求发送的文件;不擅自改图;路径含糊时先确认具体文件。
  • 排错:缺配置则提示 openclaw.json 未就绪;上传失败应透出飞书错误码与文案;发送失败重点核对 receive_id_type 与目标 ID。

使用场景

  • 本地调试或复现问题后,将截图文件路径交给技能,发到当前 OpenClaw 托管的飞书会话。
  • 运维在值班群里说明故障时,把本机保存的监控或日志截图上传并以图片消息发出。
  • 评审或走查中已有导出的本地 UI 图、流程图,需要直接投递到正在讨论的飞书对话线程。
  • 脚本或流水线在服务器上生成图片文件,需写入当前飞书群消息而不再手工打开客户端上传。

适合人员

  • 维护 OpenClaw 飞书通道、需要把本机图片按 API 规范发进当前会话的集成工程师
  • 在飞书值班或支持群里、习惯用本地截图说明问题且对话已由 OpenClaw 接管的运维人员
  • 为飞书场景编写 Agent 技能、要把用户明确指定的本地图片路径转成 `image_key` 并发送的开发者
  • 测试同学手里是缺陷复现截图文件,需在当前飞书 bug 讨论串里一键贴图给研发的同学