Feishu Api Cache Fix

核心用法

本技能通过为飞书API添加缓存机制，解决OpenClaw网关中probe.ts每分钟调用/open-apis/bot/v3/info检查机器人状态导致的额度耗尽问题。用户执行fix_feishu_cache.sh脚本即可自动完成修复，随后重启OpenClaw服务生效。

显著优点

• 配额节省效果显著：API调用频率从每分钟1次降至每2小时1次，节省99%的API配额
• 修复自动化：提供一键修复脚本，无需手动修改代码
• 风险可控：保留原始补丁备份，便于回滚
• 即时生效：重启服务后即可生效，无需等待

潜在缺点与局限性

• 状态延迟：2小时缓存可能导致机器人状态变更（如token失效、被封禁）无法及时感知
• 适用范围有限：仅针对特定API端点，非通用飞书SDK优化方案
• 依赖特定环境：需sudo权限执行，且针对OpenClaw网关架构
• 无官方背书：为社区个人作者(@bryan-chx)提供的修复方案

适合人群

• 使用OpenClaw网关并集成飞书机器人的开发者
• 遇到飞书API配额快速耗尽问题的运维人员
• 希望降低API调用成本的飞书机器人管理员

常规风险

• 权限风险：需sudo执行脚本，存在误操作可能
• 服务中断：重启OpenClaw会导致短暂服务不可用
• 缓存失效风险：极端情况下缓存策略可能导致状态误判
• 版本兼容性：未来OpenClaw更新可能使补丁失效

核心用法

feishu-api-cache-fix 是一个针对 OpenClaw 飞书扩展的性能修复 Skill。该工具通过修改系统内部的 probe.ts 文件，为飞书机器人状态检测 API 添加 2 小时缓存机制。用户只需执行 sudo bash fix_feishu_cache.sh 脚本，然后重启 OpenClaw 即可完成修复。修复后，原本每分钟调用一次的 /open-apis/bot/v3/info 接口将变为每 2 小时调用一次。

显著优点

配额节省效果显著：API 调用频率从每分钟 1 次降至每 2 小时 1 次，节省 99% 的 API 配额，对于企业级飞书机器人部署场景具有极高的成本效益。

部署简单零依赖：无需安装任何第三方依赖包，纯 Shell 脚本实现，修改后立即生效，无需等待官方更新。

自动备份机制：脚本会自动创建 .bak 备份文件，降低误操作风险。

潜在缺点与局限性

系统文件修改风险：需要 sudo 权限直接修改 /usr/local/lib/node_modules/openclaw/ 下的系统文件，若操作不当可能导致 OpenClaw 飞书扩展功能异常。

来源可信度限制：作者 @bryan-chx 为 T3 级别个人开发者，无企业背书，虽代码结构清晰但仍需用户自行审查。

功能单一性：仅针对特定版本的 OpenClaw 飞书扩展，若官方后续更新可能失效或产生冲突。

缓存时效权衡：2 小时缓存意味着机器人状态更新可能存在延迟，对于需要实时状态感知的场景不适用。

适合的目标群体

• 使用 OpenClaw 飞书扩展且遇到 API 配额快速耗尽问题的企业用户
• 具备一定技术能力、能够审查 Shell 脚本内容的运维人员
• 对飞书机器人稳定性有要求但配额有限的中小团队
• 熟悉 Node.js 模块结构、可手动恢复备份文件的开发者

使用风险

权限风险：sudo 执行意味着脚本拥有系统级写权限，若脚本被篡改可能导致更广泛的系统损害，务必从可信渠道获取。

兼容性风险：直接修改 node_modules 内的文件属于非标准操作，OpenClaw 官方更新时可能覆盖修改，需持续关注版本兼容性。

回滚依赖：虽自动备份，但 .bak 文件与目标文件同目录，若目录被清理或重装将丢失备份，建议额外手动备份。

状态延迟风险：缓存机制导致机器人状态检测延迟最高可达 2 小时，若用于关键业务监控需评估容忍度。