核心用法
feishu-sheet 是面向飞书电子表格（Lark Sheets）的自动化操作工具，通过封装飞书开放平台 API，提供从表格创建、数据读写、样式美化到图片插入的全链路能力。用户需在 ~/.openclaw/openclaw.json 配置飞书应用凭证（channels.feishu.appId 与 appSecret），并确保应用开通 sheets:spreadsheet 权限。
主要操作模式为通过 exec 调用 Bash 脚本执行指令，涵盖：
- 表格生命周期：
create创建表格并返回 token、meta获取工作表元数据 - 数据操作：
read/read_multi读取范围数据，write覆盖写入，append/prepend增删行数据 - 视觉增强：
style/style_batch设置单元格样式（字体、颜色、对齐），insert_image/float_image插入本地或网络图片 - 结构管理：
merge/unmerge合并单元格，add_sheet/delete_sheet/copy_sheet管理工作表，add_rows/delete_cols等行列操作 - 数据检索：
find/replace在指定工作表内查找替换文本
显著优点
1. 功能覆盖全面：几乎涵盖飞书表格 API 的所有核心能力，从基础 CRUD 到样式渲染、图片浮层，满足自动化报表需求
2. 自动化友好：纯命令行交互，易于集成到 CI/CD 或定时任务中，生成带格式的业务报表无需人工介入
3. 权限最小化设计：官方明确建议使用仅含表格权限的最小化飞书应用，降低凭证泄露后的 blast radius
4. Token 缓存优化：租户级 access token 按用户隔离缓存在 $TMPDIR，减少重复鉴权开销
潜在缺点与局限性
1. 配置门槛较高：需自行在飞书开放平台创建应用、获取凭证、配置权限，对非开发者用户不够友好
2. Range 格式严格：所有操作必须带 sheetId! 前缀，且需先调用 meta 获取 sheet ID，增加调用复杂度
3. Shell 转义陷阱：JSON 参数在 Bash 中需复杂转义，易因引号处理不当导致解析失败
4. 网络依赖单一：仅支持 open.feishu.cn 域名，海外网络环境可能出现延迟或连接不稳定
5. 无实时协作感知：纯 API 操作无法感知其他用户的实时编辑，存在数据覆盖风险
适合人群
- 需要将业务数据自动同步到飞书表格的开发者/DevOps 工程师
- 希望用代码生成带格式报表、替代手动 Excel 操作的数据分析师
- 构建内部工具、需集成飞书生态的企业 IT 团队
常规风险
- 凭证泄露风险：
appId/appSecret存储在本地 JSON 文件，若文件权限不当（非 600）可能被其他进程读取 - 数据覆盖风险：
write操作为覆盖模式，无版本控制，误操作可能导致数据丢失 - 权限扩散风险：虽建议最小权限，但用户可能为方便而授予过多权限（如读取全企业通讯录）
- API 限流风险：飞书开放平台存在 QPS 限制，高频批量操作可能触发限流