feishu-send-files 技能说明

基础信息

• 技能名称：feishu-send-files
• 触发指令：发文件 / 帮我发 / 发送文件 / 自然语言
• 运行入口：index.js
• 日志路径：技能目录下 logs/
• 依赖：无外部依赖（仅 Node.js 内置模块）

⚠️ 重要：两种触发模式的区别

模式 1：机器人触发（推荐）

在群里@机器人 或 私聊@机器人，直接说：

发文件 /path/to/file.pptx
发一下这个 PPT

✅ 自动识别发送目标：

• 群里@机器人 → 发到当前群
• 私聊@机器人 → 发到私聊

模式 2：命令行调用（手动指定）

在终端运行：

cd /home/node/.openclaw/workspace/skills/feishu-send-files
node index.js --file "/path/to/file.pptx" --to "chat:群聊 ID"

⚠️ 必须手动指定发送目标：

• --to "chat:oc_xxx" → 发到群聊
• --to "open_id:ou_xxx" → 发到个人
• 不传 --to 参数 → 默认发到个人（容易发错！）

功能描述

飞书文件发送技能，支持三种模式：

1. 精确路径模式（机器人触发）

发文件 /home/node/test.pptx

2. 文件名搜索模式（机器人触发）

发文件 test.pdf

自动在 workspace 目录查找。

3. 模糊匹配 + 交互式选择（机器人触发）

把 workspace 里面那个 PPT 文件发给我
发一下 Excel 文件

机器人搜索→展示列表→让你选择→发送。

核心特性：

• ✅ 递归搜索 workspace 目录（3 层深度）
• ✅ 智能关键词提取（中文 + 英文）
• ✅ 自动文件类型识别（12 种常见格式）
• ✅ 交互式选择（数字/文件名）
• ✅ 批量发送（多文件选择） - 回复 1,2,3 或 all
• ✅ 文件大小显示
• ✅ 完整日志记录
• ✅ 错误处理和状态反馈

触发规则

{
  "triggers": [
    {"type": "exact_match", "value": "发文件"},
    {"type": "prefix_match", "value": "发文件 "},
    {"type": "mention", "value": "发文件"},
    {"type": "prefix_match", "value": "帮我发"},
    {"type": "prefix_match", "value": "发一下"},
    {"type": "prefix_match", "value": "把文件"},
    {"type": "prefix_match", "value": "发送文件"},
    {"type": "prefix_match", "value": "发这个文件"},
    {"type": "prefix_match", "value": "发那个文件"},
    {"type": "contains", "value": "发文件"},
    {"type": "contains", "value": "发送文件"}
  ]
}

快速使用指南

✅ 推荐：群里@机器人发送

@机器人 发文件 /path/to/file.pptx
@机器人 发一下这个 PPT

优点：自动识别群聊/私聊，不会发错！

⚠️ 命令行调用（需要手动指定目标）

# 发到群聊
node index.js --file "/path/to/file.pptx" --to "chat:oc_群聊 ID"

# 发到个人
node index.js --file "/path/to/file.pptx" --to "open_id:ou_用户 ID"

# 不传 --to 参数 → 默认发到个人（容易发错！）

命令行参数说明

使用示例

精确路径（机器人触发）

发文件 /home/node/test.pptx
@机器人 发文件 /path/to/data.xlsx

文件名搜索（机器人触发）

发文件 test.pdf
帮我发一下 report.docx

模糊匹配（机器人触发）

把 workspace 里面那个 PPT 文件发给我
发一下 Excel 文件
帮我发会议纪要
发送那个 PDF

机器人响应：

找到 3 个匹配文件，请选择：

1. test.pptx (2.3 MB)
2. 交易报告.pptx (1.8 MB)
3. 会议纪要.pptx (856 KB)

回复数字选择（如：1）或输入多个数字（如：1,2,3）或输入 "all" 发送全部

批量发送示例：

用户：发 PPT 文件
机器人：找到 3 个文件...请选择
用户：1,3
机器人：✅ 发送完成！成功 2/2 个文件

快速排错

最佳实践

✅ 推荐：在群里@机器人发送文件（自动识别群聊） ❌ 避免：命令行调用时忘记加 --to 参数（会发到个人）

技术实现

• Token 获取：使用 tenant_access_token 内部门户 API
• 文件上传：multipart/form-data 表单上传到飞书文件接口
• 消息发送：使用 file_key 发送文件消息
• 日志记录：同步追加写入，确保不丢失
• 路径提取：智能识别绝对路径、相对路径、workspace 目录文件
• 模糊搜索：递归搜索 + 关键词匹配 + 扩展名过滤
• 交互式选择：展示文件列表，等待用户选择

权限要求

• im:message:send_as_bot
• im:message:send_to_chat
• im:message:send_to_open_id