Agent Health Optimizer

🩺 代理健康诊断与保守修复专家

专业诊断 OpenClaw 代理健康状态,提供保守修复建议,追踪历史趋势,避免盲目自动化风险。

收藏
6.4k
安装
1.6k
版本
1.4.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

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 规则

Agent Health Optimizer 内容

scripts文件夹
手动下载zip · 18.9 kB
cron_optimizer.pytext/plain
请选择文件