核心用法
feishu-evolver-wrapper 是 capability-evolver 的轻量级封装层,专为飞书(Feishu)生态设计。它通过注入 EVOLVE_REPORT_TOOL 环境变量,将原本命令行输出的进化过程转化为飞书富卡片消息,实现研发团队的实时协同与可视化追踪。
三大核心功能模块:
1. 进化循环执行:index.js 启动 GEP(Gene Expression Programming)进化主循环,在保留原技能算法能力的同时,将每一代适应度、最优个体、收敛曲线等关键指标推送至飞书群聊或机器人会话。
2. 仪表盘可视化:visualize_dashboard.js 读取 assets/gep/events.jsonl 中的历史事件流,生成 Markdown 格式的多维数据看板,支持趋势分析、代际对比和异常检测。
3. 生命周期管理:lifecycle.js 提供标准的 daemon 管控接口(start/stop/status/ensure),配合 OpenClaw Cron 的 evolver_watchdog_robust 任务(每 10 分钟执行一次 ensure),实现故障自恢复,彻底替代脆弱的系统 crontab 方案。
显著优点
- 零侵入集成:无需修改
capability-evolver源码,通过环境变量注入即可激活飞书能力 - 团队协同友好:富卡片消息支持折叠、@提醒、快捷操作,降低算法迭代的信息摩擦
- 生产级可靠性:Watchdog 机制 +
ensure幂等设计,确保 7×24 小时稳定运行 - 可审计追溯:
events.jsonl结构化日志 + 飞书文档导出,满足研发合规要求
潜在缺点与局限性
- 强依赖飞书生态:若组织未部署飞书或机器人权限受限,核心功能降级为本地日志
- 事件流存储风险:
assets/gep/events.jsonl为本地文件,无内置分布式存储或备份机制 - 权限配置复杂:飞书机器人
app_id/app_secret、群聊 webhook、文档 API 需分别申请,初期配置成本较高 - Cron 任务隐性依赖:
evolver_watchdog_robust为 OpenClaw 内部任务,迁移至其他调度系统需手动适配
适合人群
- 已使用飞书作为主力协作平台的算法工程团队
- 需要将 GEP 进化过程从个人脚本升级为团队可见的研发管理者
- 追求无人值守、故障自愈的 MLOps 工程师
常规风险
- 敏感数据泄露:进化报告中可能包含业务指标、模型参数,需确认飞书机器人群聊为私有或加密
- Token 泄露:
EVOLVE_REPORT_TOOL通常承载飞书 API 凭证,应避免提交至版本控制 - 资源泄漏:
ensure逻辑异常可能导致僵尸进程累积,建议配合系统级systemd或pm2双重保险 - 存储膨胀:长期运行的
events.jsonl未配置轮转策略,可能占满磁盘