核心用法
fast-image 是一个基于 Node.js 的本地图片发送工具,专为 openclaw 生态设计。用户通过命令行调用脚本,指定图片路径、目标频道、接收方及可选附言,即可将本地图片快速推送至 Telegram 等支持的通讯平台。
工作流程:脚本首先检测图片体积——小于 10MB 的直接复制到 openclaw 媒体目录;大于等于 10MB 的调用 sharp 库进行压缩处理。随后通过 openclaw message send --media 指令完成发送,并自动清理临时文件。
显著优点
- 自动化处理:无需手动压缩或格式转换,大小文件智能分流
- 集成度高:深度绑定 openclaw CLI,命令简洁
- 临时文件清理:发送后自动删除,避免磁盘堆积
潜在局限
- 生态依赖:必须预装 openclaw CLI 及 Node.js 环境,独立使用价值有限
- 平台锁定:目前仅支持 openclaw 定义的频道类型
- 压缩黑盒:未暴露压缩质量参数,用户无法自定义压缩策略
- 10MB 阈值固定:缺乏配置灵活性
适合人群
- 已部署 openclaw 自动化工作流的技术用户
- 需要批量/脚本化发送图片的开发者或运营人员
- 对 Telegram 等平台有自动化消息推送需求的场景
常规风险
- 路径注入风险:
image_path参数若未经严格校验,可能引发目录遍历或任意文件读取 - 依赖供应链:
sharp原生模块的编译依赖与 openclaw 的更新维护构成潜在断点 - 敏感文件误发:自动化脚本缺乏发送前确认机制,可能误触敏感图片传播