核心功能
Agent Health Optimizer 是一套面向 OpenClaw 代理系统的综合诊断审计工具集,专注于"发现问题、保守修复、趋势追踪",而非激进的自动修复。它通过五个维度(内存、定时任务、技能、安全、连续性)对代理健康状态进行量化评分(0-100分),帮助用户系统性地识别系统隐患。
主要工具模块
- health_score.py: 五维健康评分,生成 A+ 至 F 等级报告
- memory_auditor.py: 检测指令性规则误用、来源标签缺失、过期条目等内存卫生问题
- cron_optimizer.py: 诊断定时任务冲突、时间碰撞、可疑配置,支持
--fix保守修复模式 - skill_comparator.py: 通过 ClawHub API 对比已安装技能与社区热门技能,发现功能重叠与覆盖缺口
- self_optimize.py: 统一调度入口,生成优先级分级(HIGH/MED/LOW)的综合报告与趋势追踪
显著优点
1. 审计优先于修复:设计理念明确区分诊断与修复,所有修改操作需显式触发 --fix
2. 保守修复策略:--fix 模式自动备份、仅针对高风险场景(整点高频任务)添加抖动,不强制修改 delivery=none 或精确时间任务
3. 非破坏性设计:默认运行只读系统文件,写入仅限于 memory/ 目录的报告文件
4. 趋势追踪能力:保存 JSON 历史数据,支持跨时间点的健康状态对比
5. 社区驱动:集成 ClawHub API,提供基于下载量、星标的社区信号参考
潜在局限
- 依赖外部 API:ClawHub 比对功能依赖
https://clawhub.ai/api/v1/的可用性 - 评分主观性:25/25/20/15/15 的权重分配为作者预设,未必适配所有使用场景
- 修复范围有限:
--fix仅处理 cron 抖动场景,不涉及内存结构重组或技能自动卸载 - Python 版本限制:要求 Python 3.8+,老旧环境可能受限
适合人群
- 拥有复杂 OpenClaw 配置、需要定期"体检"的中高级用户
- 计划调整代理架构前寻求现状基线的谨慎型用户
- 多代理协作场景下关注"记忆卫生"与"任务调度冲突"的系统管理员
常规风险
- 误报可能:重叠技能检测基于名称相似度与功能描述匹配,可能产生假阳性建议
- API 速率限制:频繁调用 ClawHub API 可能触发限流
- 备份依赖:虽
--fix自动备份,但用户需确认memory/cron-backup.json存在方可回滚 - 不替代人工审查:文档明确警告"不作为重大破坏性变更的替代方案"
安全设计亮点
- 所有破坏性操作需显式
--fix授权 - 强制隔离会话 (
--session isolated) 执行定时诊断任务 - 敏感目录外写入限制(仅
memory/子目录) - 符合 OpenClaw 原生安全模型,不绕过
safety规则