feishu-sticker

🎭 飞书贴纸自动上传发送工具

办公榜 #2

OpenClaw社区推出的飞书贴纸自动化工具,支持智能上传缓存与GIF转WebP,让团队表情包分享更高效便捷。

收藏
23.6k
安装
4.8k
版本
latest
CLS 安全性认证2026-04-30
点击查看完整报告 >

使用说明

Feishu Sticker Skill 是一款专为飞书(Lark)生态设计的图片自动化发送工具,旨在将本地图片以原生贴纸形式发送至指定用户或群组。其核心用法围绕命令行接口展开,用户可通过 --target 指定接收方(支持用户ID或群组ID),配合 --file 发送特定图片,或使用 --query/--emotion 基于关键词或情绪标签智能搜索贴纸目录。Skill 会自动处理图片上传至飞书 CDN 的流程,通过 MD5 哈希缓存 image_key 避免重复上传,并对超过 5MB 的图片及 GIF 文件进行自动压缩和 WebP 格式转换,显著提升传输效率。

该 Skill 的显著优点在于其完善的自动化能力与工程健壮性。首先,智能缓存机制有效减少了 API 调用次数和网络带宽消耗;其次,集成 ffmpeg-static 实现的 GIF 转 WebP 功能在保证视觉效果的同时优化了文件体积;再者,代码层面实施了严格的安全检查,包括文件路径解析验证(防止目录遍历攻击)和敏感操作的环境变量隔离。此外,依赖版本已完全锁定(package-lock.json),且所有网络请求均限定于飞书官方 API 端点,确保了运行的稳定性与可预期性。

然而,该 Skill 也存在一定局限性。其功能强依赖于飞书开放平台生态,用户必须预先配置 FEISHU_APP_IDFEISHU_SECRET 环境变量并具备相应的 API 权限,配置门槛较高。同时,由于使用 spawnSync 调用外部 ffmpeg 进程进行格式转换,在极端情况下可能受限于系统进程调度或二进制文件兼容性(尽管已使用静态链接版本)。此外,所有上传的图片将永久存储于飞书 CDN,对于高度敏感或机密内容的分享存在固有的隐私风险。

该工具特别适合以下群体:需要在飞书群组中频繁分享自定义表情包的内容运营团队、构建内部娱乐或通知机器人的开发者、以及希望通过自动化脚本提升内部沟通趣味性的办公自动化爱好者。对于已深度使用飞书作为协作平台、且具备基础 Node.js 环境配置能力的技术团队而言,此 Skill 能显著简化贴纸管理流程。

使用风险方面,除上述提及的图片上传至第三方 CDN 的隐私考量外,用户需注意定期清理本地缓存文件(memory/feishu_image_keys.json)以防索引膨胀。虽然代码中已实现完善的错误处理和重试机制(最多3次),但在网络不稳定或飞书 API 限流时仍可能出现发送失败。建议在生产环境使用前,充分测试贴纸目录的权限配置及 ffmpeg 转换流程在目标系统上的兼容性。

安全解读

核心用法

feishu-sticker 是一款专为飞书(Lark)平台设计的表情包发送工具,通过调用飞书开放平台 API 实现图片消息的自动化投递。用户可通过 CLI 命令向指定用户或群组发送本地图片,支持随机选择、关键词搜索、情绪匹配三种发送模式。

主要功能路径

  • 基础发送: send.js --target "ou_..." --file "/path/to/image.jpg"
  • 随机表情包: 省略 --file 参数,从 ~/.openclaw/media/stickers/ 目录随机选取
  • 智能搜索: --query "angry cat"--emotion "happy" 基于语义匹配贴纸
  • 自动优化: GIF 自动转 WebP(via ffmpeg)、大图片(>5MB)智能压缩

架构亮点

采用 MD5 文件哈希缓存 image_key,避免重复上传;使用原子写入(write+rename)策略保护 Token 和缓存数据完整性。

---

显著优点

1. 效率优化到位: WebP 转换节省约 30-50% 带宽,CDN 缓存机制减少 API 调用频次
2. 开发体验友好: 纯 Node.js 实现,依赖成熟(commander/dotenv/ffmpeg-static),配置即开箱

3. 企业级集成: 完整对接飞书官方 API,支持 tenant_access_token 自动续期

4. 扩展性设计: 模块化目录结构,支持自定义贴纸库路径(STICKER_DIR 环境变量)

---

潜在缺点与局限性

| 维度 | 说明 |
|------|------|
| **外部依赖** | 依赖 `ffmpeg-static` 二进制,跨平台兼容性(ARM/Windows)需额外验证 |
| **安全边界** | 子进程调用存在理论攻击面,虽经路径验证但非零风险 |
| **功能边界** | 仅支持静态图片/GIF,不支持飞书原生动态表情或自定义表情商店集成 |
| **配置门槛** | 需自行申请飞书企业应用并配置 `FEISHU_APP_ID/SECRET`,个人用户上手成本较高 |

---

适合人群

  • 团队运营/行政: 批量发送节日祝福、活动海报
  • 开发者/DevOps: 集成到 CI/CD 流程,发送构建状态通知(带趣味表情包)
  • 社群管理员: 自动化管理飞书群组互动氛围

---

常规风险

  • Token 泄露: 缓存文件默认权限未限制(建议 chmod 600),多用户环境存在信息泄露风险
  • 网络超时: 部分 fetch 调用未配置 timeout,弱网环境可能挂起
  • 版权合规: 贴纸库图片需确保合法授权,商用场景注意肖像权/著作权问题

feishu-sticker 内容

手动下载zip · 11.0 kB
find.jstext/javascript
请选择文件