实际踩过的坑,技术细节展开,代码可直接用。
OpenClaw 内置飞书插件与 openclaw-lark 第三方插件共存时形成死锁:启用旧插件工具全崩,禁用旧插件主账号掉线。折腾半天后发现根因是两个隐藏的设计约定,最终一次性解决了冲突和流式输出不一致两个问题。
OpenClaw cron 从 UTC 切到 Asia/Shanghai 后,调度器误判「今日已执行」,任务静默跳过,0 报错。根因是 lastRunAt 存的是旧 UTC 时间戳。
openclaw-lark 升级换了 appId,飞书 open_id 随之改变。jobs.json、.env、脚本共 19 处硬编码失效,报错 99992361 open_id cross app。
openclaw gateway 启动报 [warn] Duplicate plugin detected: feishu,原因是显式声明和自动加载同时触发。功能不受影响时不必处理,洁癖可删掉 openclaw.json 里的显式 entry。
第三方聚合平台按张收费,底层其实是 Imagen/Gemini。直接用 google-genai SDK + GEMINI_API_KEY,免费额度内每天 1500 张,成本为零。
nano-banana-pro 安装后调用失败,原因是 GRSAI_API_KEY 未配置。安装 ≠ 可用。每次装完技能,应立即跑冒烟测试验证依赖。
开启 CloudFront Standard Logs,S3 里没有任何日志文件。IAM 和 S3 策略都没问题,就是不来。根因:Standard Logging 在免费套餐下不生效。推荐改用 Cloudflare Web Analytics。