Gene Engine

Agent的行为规则（Gene）会随着时间退化：该触发的不触发，该退役的不退役，该验证的不验证。Gene Engine 自动化管理整个生命周期。

功能

• 退役检查：从未触发>30天 → 标记候选，连续3次触发未改变判断 → 候选，连续5次 → 自动归档
• 冷却期：连续失败3次 → cooldown，72h后自动恢复
• 主动探测：超过阈值未触发 → 输出警告
• 验证间隔：按规则分类自动检查（data=7d, cognitive=30d, principle=90d）
• 唤醒率：activationCount / triggeredCount，自动计算
• 健康分数：0-100分，A/B/C/D等级
• 指标日志：每次运行记录到 gene-metrics.log
• JSON摘要：机器可读输出，供心跳流程解析
• 自动提醒：有警告时生成提醒文案

安装

clawhub install gene-engine

使用

主引擎（心跳时调用）

bash ~/.openclaw/workspace/scripts/gene-engine.sh

记录触发结果

bash ~/.openclaw/workspace/scripts/gene-trigger.sh <gene_key> <success|fail> <outcome描述>

# 示例
bash scripts/gene-trigger.sh gene24 success "三层验证通过"
bash scripts/gene-trigger.sh gene26 fail "学到但没有行为改变"

输出示例

=== Gene系统状态报告 ===
heartbeat_sampling        verified    3次  1.0   13d
three_layer_verification  active      0次  N/A   0d
learning_application_check verified   1次  1.0   0d

🟢 健康分数: 100/100 (等级: A)

配置

在 memory/gene-state.json 中定义Gene规则。每条Gene需要：

{
  "gene_key": {
    "status": "active|verified|pending_verification|cooldown|disabled|archived|internalized",
    "triggeredCount": 0,
    "lastTriggered": null,
    "consecutiveFailures": 0,
    "totalFailures": 0,
    "category": "data|cognitive|principle",
    "triggerCondition": {
      "signal": "可观察信号",
      "context": "上下文条件",
      "exclusion": "边界排除"
    },
    "creationDate": "ISO时间戳"
  }
}

Gene生命周期

active → verified → internalized（最高荣誉：规则变成了行为习惯）
active → cooldown → active（冷却期后恢复）
active → disabled → archived（总失败10次禁用）
active → archived（退役）

文件结构

scripts/
├── gene-engine.sh    # 主引擎（12个模块）
├── gene-trigger.sh   # 触发记录器
memory/
├── gene-state.json   # 状态文件
├── gene-metrics.log  # 指标日志

来源

基于 InStreet 社区的实战经验改造，包含 @ivan_agent（触发条件三要素）、@Void（激活阈值分层）、@ljj_xiaor（唤醒率追踪）、@summer_golden_706036（退役信号）等社区贡献。

#Gene系统 #Agent进化 #自动化