Agent Skills
返回列表
OpenClaw 飞书发文件

OpenClaw 飞书发文件

办公效率 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_39299230/openclaw-feishu-send-file。

技能介绍

要解决什么问题

在飞书群里让 Agent 交付报表、日志或配置时，很多集成只能把文件路径或下载链接塞进消息里。对方要点链接、再跳转，体验和「直接收到附件」差一截；自动化流程里也更难把「消息已送达」和「文件真的以附件形式出现」对齐。

本技能围绕 OpenClaw 与飞书，把「发文件」从附一段文本，变成聊天里可见的文件附件。

核心能力与两种路径

方式一：OpenClaw CLI（默认）

  • 通过 CLI 把本地文件作为飞书消息附件发出。
  • 文件必须先落在白名单目录之一：/tmp/openclaw/、~/.openclaw/media/、~/.openclaw/workspace/、~/.openclaw/sandboxes/。
  • 建议用 mktemp -d 在 /tmp 下建随机子目录，避免同名覆盖；/tmp 由系统回收，一般不必手删。
  • --message 为必选，正文末尾须带 [via OpenClaw CLI]；不能只传 --media。
  • 必须指定 --account，否则会报 appId and appSecret are required；跨应用发送会触发 open_id cross app。

方式二：飞书 API 脚本（备选）

  • 适合文件不在白名单、又不想先拷贝中转的场景，无 CLI 路径白名单限制。
  • 凭据从 ~/.openclaw/openclaw.json 读取，脚本侧不单独存密钥；执行完成后会输出 [via 飞书 API] 标记。

适用边界与注意点

  • 路径不在 CLI 白名单时，可能静默降级为文本链接，界面仍可能显示发送成功——不要仅凭 ✅ 判断附件一定发出。
  • open_id 绑定飞书应用维度，同一用户在不同应用下 ID 不同。
  • Agent 工作区路径（如 ~/.openclaw/agents/*/workspace/）在 CLI 模式下不在白名单内，需拷贝到允许目录或改用 API 脚本。

使用场景

  • OpenClaw Agent 在飞书群或单聊里交付生成的报表、日志包，需要对方在会话里直接收到附件而不是点开文本链接。
  • 自动化任务把产物写到 `/tmp` 或 `~/.openclaw/media/` 后，用 CLI 发到指定飞书会话，并按规定带上 `[via OpenClaw CLI]` 说明。
  • 生成文件落在 `~/.openclaw/agents/*/workspace/` 等非白名单路径时，需拷贝到允许目录或改用飞书 API 脚本完成发送。
  • 同一环境配置多个飞书应用时，向不同租户/机器人发附件必须在 CLI 中指定 `--account`，避免 `open_id cross app` 失败。

适合人员

  • 在飞书上运行 OpenClaw Agent、需要把脚本产物以附件推给值班或项目群的 SRE / 平台工程师
  • 负责飞书企业应用与机器人集成、要判断 CLI 白名单路径与 API 脚本何时该用的后端或 IM 集成开发
  • 编写定时任务把临时文件经 `mktemp` 落盘并透过 OpenClaw 发到飞书、且要核对是否真发成附件的自动化维护者
  • 管理多套飞书 `appId` / 凭据、需要为不同业务线账号正确指定 `--account` 发文件的运维或 Bot 管理员