Agent Health Optimizer

诊断、评分并持续优化你的 OpenClaw 配置。

该技能是一个 审计工具包，而非具备自动修复能力的“魔法系统”。它擅长识别潜在问题、薄弱环节与改进机会。--fix 模式采用**有意保守的设计原则**。

运行要求

• python3（3.8+）
• openclaw CLI

快速上手

# 全量诊断套件 —— 一条命令启动
python3 scripts/self_optimize.py

# 各项独立工具
python3 scripts/health_score.py         # 健康评分（A+ 至 F 级）
python3 scripts/memory_auditor.py       # 记忆体卫生检查
python3 scripts/cron_optimizer.py       # Cron 任务分析
python3 scripts/cron_optimizer.py --fix # 保守型自动修复（先备份再修改）
python3 scripts/skill_comparator.py     # 相邻 / 重叠的 ClawHub 技能比对

功能说明

🏥 health_score.py —— Agent 健康评分（0–100 分）

从以下 5 个维度进行评分：

• 🧠 记忆体（25 分）：MEMORY.md 完整性、每日日志活跃度、工作缓冲区状态、防中毒机制完备性、来源标签（source tags）覆盖情况
• ⏰ Cron（25 分）：任务健康状态、调度多样性、是否使用隔离会话（isolated sessions）、可疑的消息投递配置、是否合理启用选择性错峰（selective stagger）
• 📦 技能（20 分）：已安装技能数量、重叠提示、ClawHub 管理比例、元数据完整性
• 🔒 安全（15 分）：安全规则配置、防中毒策略、WAL 协议启用状态、对外部动作的管控措施
• 🔄 连续性（15 分）：SOUL.md、USER.md、HEARTBEAT.md、IDENTITY.md 文件存在性与内容质量、Git 版本追踪状态

🔍 memory_auditor.py —— 记忆体卫生检查

检测以下问题：

• 本应以声明式事实（declarative facts）表达的指令性规则（imperative rules）
• 事实类条目缺失来源标签（source tags）
• 状态为 pending 且超过 30 天未更新的陈旧条目
• 将外部内容误存为指令（instructions）
• 体积过大、需归档处理的文件
• 每日日志存在断档

⏰ cron_optimizer.py —— Cron 任务医生

检测以下问题：

• 处于错误状态的任务（含任务名与错误信息）
• 时间冲突（多个任务使用完全相同的调度表达式）
• 在易引发突发负载的周期性调度中缺失错峰（stagger）配置
• 可疑的 announce 配置（例如显式指定了 channel，却未指定 to）
• 超时设置（timeout）不一致
• 会话目标建议（推荐使用 isolated 还是 main 会话）

--fix 模式行为：

• 所有变更前，先创建备份文件 memory/cron-backup.json
• 仅对高频次、整点触发、易形成请求洪峰的周期性任务自动添加 stagger
• 不会强制启用 delivery 机制，即使任务当前配置为 delivery=none
• 不会仅因精确时间调度（exact-time jobs）未启用 stagger 就对其进行修改

📦 skill_comparator.py —— 技能生态图谱检查器

通过 ClawHub API（https://clawhub.ai/api/v1/）执行以下操作：

• 获取已安装技能的 star 数、下载量、安装量
• 列出你尚未安装但社区热度最高的 Top ClawHub 技能
• 发现与你当前技能集相邻或功能重叠、且具备更强社区信号（如更高 star 或更活跃维护）的替代技能
• 执行分类覆盖度分析（哪些领域尚无对应技能？）

重要提示：以上结果仅为比对参考提示，并非权威替换建议。

🔄 self_optimize.py —— 统一执行入口

顺序运行全部 4 个子工具，并生成：

• 整合报告，含按优先级（HIGH/MED/LOW）排序的待办事项
• 与上次运行结果的趋势对比（📈/📉）
• JSON 格式报告，保存至 memory/ 目录，支持历史回溯

读写权限说明

只读访问（不产生任何副作用）：

• 工作区文件：MEMORY.md、AGENTS.md、SOUL.md、USER.md、HEARTBEAT.md、IDENTITY.md
• 每日日志：memory/*.md
• 技能元数据：skills/*/SKILL.md
• Cron 配置：openclaw cron list --json
• ClawHub 公共 API：https://clawhub.ai/api/v1/skills/...

仅写入报告文件（不修改业务逻辑或配置）：

• memory/health-score.json
• memory/memory-audit.json
• memory/cron-optimizer.json
• memory/skill-comparator.json
• memory/self-optimize-report.json
• memory/self-optimize-last.json

仅在启用 --fix 时执行修改操作：

• cron_optimizer.py --fix 通过 openclaw cron edit 修改 Cron 任务
• 始终先备份至 memory/cron-backup.json

周期性自优化配置

建议配置每周一次的只读型定时任务（不带 --fix）：

openclaw cron add 
  --name "Agent Self-Optimize" 
  --cron "0 11 * * 0" 
  --tz "America/Los_Angeles" 
  --session isolated 
  --stagger 2m 
  --no-deliver 
  --message "Run agent self-optimization:
python3 ~/.openclaw/workspace/skills/agent-health-optimizer/scripts/self_optimize.py

Report results. List HIGH priority issues first. Keep it brief if everything looks fine."

定位与适用场景

当出现以下需求时，请使用本技能：

• 定期执行系统健康审计
• 在调整 Agent 架构前进行合理性验证（sanity check）
• 获取审慎、低风险的改进建议
• 长期跟踪 Agent 健康指标的历史趋势

切勿将其视为对破坏性或影响范围广泛的变更进行人工审查的替代方案。

致谢

本诊断逻辑的设计参考了以下项目与社区实践：

• proactive-agent — halthelobster
• self-improving-agent — pskoett
• Moltbook openclaw-explorers 社区 — Cron 错峰模式（thoth-ix）、心跳批处理机制（pinchy_mcpinchface）

许可证

本作品采用 CC BY-SA 4.0 许可协议。你可自由分享与改编，但须注明原作者并以相同许可协议发布衍生作品。