核心用法
Agent Health Optimizer 是一套面向 OpenClaw 生态的系统性审计工具,通过五个独立脚本提供分层的诊断能力:
- health_score.py:五维度健康评分(满分 100),涵盖内存管理、定时任务、技能配置、安全策略与连续性保障
- memory_auditor.py:检测指令式规则误用、缺失来源标签、陈旧待处理条目、外部内容内嵌等内存卫生问题
- cron_optimizer.py:识别任务错误状态、时间冲突、突发风险调度、可疑投递配置,并提供保守的
--fix修复模式 - skill_comparator.py:对接 ClawHub API,分析已装技能与热门技能的社区信号差异,提示功能重叠与覆盖缺口
- self_optimize.py:统一调度器,生成带优先级(HIGH/MED/LOW)的合并报告及历史趋势追踪
显著优点
分层审计设计:从宏观评分到微观条目检查,覆盖架构健康度与执行细节。
保守修复哲学:--fix 模式严格限制作用域(仅对 burst-prone 的整点任务添加 stagger),强制备份,不覆盖用户显式配置。
趋势可观测性:JSON 报告沉淀于 memory/ 目录,支持跨周期对比与外部系统集成。
生态感知能力:直接对接 ClawHub API,将本地配置与社区实践进行量化对比。
潜在局限
生态绑定过深:全量功能依赖 OpenClaw CLI 与特定文件结构(MEMORY.md、SOUL.md 等),无法移植至其他 Agent 框架。
修复能力有限:--fix 不处理内存内容改写、技能卸载/更新、安全策略调整等高风险操作,重大决策仍需人工介入。
API 依赖风险:ClawHub 对比功能受外部服务可用性与数据 freshness 制约。
评分主观性:健康评分权重(如内存 25 分、安全 15 分)为内置固定模型,未开放用户自定义。
适合人群
- 运行 OpenClaw 生产/半生产环境的开发者与运维者
- 需要定期健康检查与配置漂移检测的 Agent 管理员
- 偏好保守策略、拒绝「黑箱自动修复」的审慎用户
常规风险
| 场景 | 风险说明 | 缓解措施 |
|------|---------|---------|
| `--fix` 误触 | 用户可能误执行修复模式 | 需显式添加 `--fix` 参数;修复前强制备份至 `memory/cron-backup.json` |
| 报告膨胀 | 长期运行导致 `memory/` JSON 堆积 | 定期清理或配置日志轮转 |
| 评分焦虑 | 用户过度追求满分而过度优化 | 文档明确声明「比较提示而非权威标准」 |
| API 泄露 | ClawHub 请求可能携带技能列表元数据 | 仅查询公共 API,不传输敏感配置内容 |
总结
这是一款定位清晰的「诊断优先」工具,以可观测性换取自动化野心,适合将 Agent 健康治理纳入常规运维节奏的场景。