核心用法
飞书文件发送助手是一个 OpenClaw 平台的辅助工具技能，专门解决飞书插件因核心路径白名单机制导致的文件发送限制。其核心工作流程分为三步：
1. 权限配置：首次使用需运行 perm-config.js 脚本，在"限制级"/"中等"/"宽松"三档权限中选择，自动写入 ~/.openclaw/openclaw.json 配置文件
2. 文件中转：通过 prepare.js 将目标文件复制到白名单内的临时目录（如 /tmp 或 ~/.openclaw/media）
3. 发送与清理：调用飞书插件发送后，使用 clean.js 删除临时文件
配套脚本包括权限检查（check-perm.js）、文件列表（list.js）、系统检测（detect-system.js）等，形成完整的文件中转管理工具链。
显著优点
- 精准解决痛点：直接针对 OpenClaw 飞书插件的路径白名单限制，无需修改核心配置即可突破发送限制
- 权限分级设计：提供三档权限选项，兼顾安全性与便利性，推荐"中等"权限在实用与安全间取得平衡
- 自动化脚本链：从权限配置、文件准备到清理的完整脚本支持，降低手动操作复杂度
- 多系统适配：内置系统检测逻辑，自动适配不同运行环境
潜在缺点与局限性
- 首次配置门槛：必须执行权限配置脚本，对不熟悉命令行操作的用户存在学习成本
- 临时文件残留风险：若未执行
clean.js清理，临时文件可能残留于系统中 - 额外 I/O 开销：文件复制操作增加磁盘读写，大文件场景下可能影响性能
- 非官方解决方案：属于社区 workaround 方案，非飞书/OpenClaw 官方支持的标准流程
- 权限放宽隐患：选择"宽松"权限（/**）虽最便利，但实质上削弱了 OpenClaw 的安全隔离机制
适合人群
- 使用 OpenClaw 平台且需频繁通过飞书发送本地文件的用户
- 具备基础命令行操作能力的技术人员或运维人员
- 对安全性有认知、能合理评估权限等级选择后果的理性用户
- 需要在自动化工作流中集成飞书文件发送功能的开发者
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 权限过度开放 | 选择宽松权限会暴露更多系统路径 | 优先使用"中等"或"限制级" |
| 临时文件泄露 | 未及时清理可能导致敏感文件残留 | 在脚本中集成 `clean.js` 调用 |
| 路径注入风险 | 若 `prepare.js` 输入未严格校验 | 验证输入路径合法性 |
| 依赖环境变动 | OpenClaw 或飞书 API 更新可能失效 | 关注上游更新，预留维护窗口 |