前言¶

在飞书协作里，经常需要把本地截图、文档或图片发给指定用户。手工上传再粘贴消息，会打断你和 Agent 的对话流。若希望 Agent 在对话中直接完成「选文件 → 上传 → 发消息」，需要在技能层封装飞书开放能力，并事先配好应用凭证。

下面介绍 SkillHub 社区技能「飞书文件图片传输」（@user_037a0790/feishu-file-image-sender），用于在 Agent 侧触发本地文件向飞书用户的发送。

这是什么¶

「飞书文件图片传输」是 SkillHub 上的社区技能（版本 1.0.0，分类 office-efficiency），发布者为 user_037a0790。官方简介概括为：将本地文件发送给飞书用户，上传文件并发送消息；在用户要发图片、发文件时由 Agent 调用。

技能标记为 requires_api_key=true，实际依赖在 openclaw.json 中配置飞书应用的 appId 与 appSecret，而不是在技能包里写死密钥。

核心功能¶

依据 SkillHub 页面与抓取元数据，可确认的能力如下：

1. 本地文件发送：面向飞书用户，从本机路径读取文件并走飞书侧上传与消息流程。
2. 图片与通用文件：简介明确在用户发送图片、发送文件的场景下调用，覆盖常见办公附件类型（具体 MIME、大小上限以飞书开放平台与运行时实现为准，页面未单独列出）。
3. 消息联动：不仅上传，还会发送消息，把文件作为消息内容带给对方。

未在官方简介中出现的接口名、回调地址或 CLI 子命令，本文不展开，避免与真实 SKILL.md 不一致。

安装与启用¶

安装 SkillHub CLI（如尚未安装）¶

先检查是否已有 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需要 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装本技能¶

安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。

skillhub install @user_037a0790/feishu-file-image-sender --dir <skills 目录>

常见客户端 skills 路径（来自 SkillHub 安装文档，按你当前环境选用其一）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可将下列提示交给支持 Skill 安装的 AI，让其按 SkillHub 安装说明 安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_037a0790/feishu-file-image-sender`。

安装后若 Agent 未立即识别新技能，按你所用客户端说明重启或刷新技能列表。

飞书应用配置¶

在 openclaw.json 中配置飞书 appId 与 appSecret。这是技能说明中的硬性前提；未配置时，上传与发消息相关能力无法正常工作。

页面未给出 openclaw.json 的完整字段示例，请对照你所用 OpenClaw 系运行时与飞书开放平台文档，填写合法的应用凭证，并确保应用具备发消息、传文件所需的权限范围。

典型用法¶

官方资料未附带可复制的端到端对话脚本，用法可从简介反推为可复现的工作方式：

1. 完成 Skill 安装与 openclaw.json 中的飞书凭证配置。
2. 在对话中说明要发送的对象（飞书用户）与本地文件路径，或明确「把这张图/这个文件发给某某」。
3. Agent 在识别到发图片、发文件意图时调用本技能，执行上传并发送消息。

你无需记忆飞书 REST 步骤；技能把「上传 + 发消息」收敛为 Agent 可调用的能力。具体参数名、错误码处理以技能包内 SKILL.md 为准。

适用场景与注意¶

适合谁

• 已在飞书侧创建应用，并能在 openclaw.json 维护 appId / appSecret 的团队或个人。
• 希望用自然语言让 Agent 代发本地附件，减少在飞书客户端里反复点选上传的人。

限制与注意

• 社区来源（community），升级与维护节奏依赖发布者；生产环境使用前建议在测试租户验证权限与配额。
• 标签 requires_api_key=true：密钥只应放在配置文件中，不要写进对话或仓库明文。
• SkillHub 统计（抓取时）：评分 100000，下载 1236 次，安装 50 次；数据会随时间变化，以 技能页 为准。

结尾¶

「飞书文件图片传输」把本地文件到飞书用户的消息链路封装成 Agent Skill，适合办公效率类自动化。安装坐标为 @user_037a0790/feishu-file-image-sender，使用前务必配好 openclaw.json 中的飞书应用信息。

官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_037a0790/feishu-file-image-sender
• API 坐标页：https://api.skillhub.cn/user_037a0790/feishu-file-image-sender