智能体自反思维

技能简介

Self-Reflection 是一款面向 AI 智能体的持续改进工具，通过结构化反思与记忆管理，帮助智能体记录失误、总结经验并在后续任务中规避重复错误。该技能依托 OpenClaw 的心跳机制，以固定周期触发反思检查，形成”检测-回顾-记录”的闭环。

能做什么

• 按设定时间间隔自动检查是否需要开展反思
• 记录带标签的错误场景与修正方案
• 读取历史反思条目供上下文参考
• 统计反思频次与分布，量化改进轨迹
• 支持手动重置计时器，灵活调整节奏

使用说明

安装依赖

需预先安装 jq 与 date 命令行工具：

# macOS
brew install jq coreutils

# Ubuntu/Debian
sudo apt-get install jq coreutils

配置步骤

1. 在 ~/.openclaw/openclaw.json 中启用心跳：

   {
     "agents": {
       "defaults": {
         "heartbeat": { "every": "60m", "activeHours": { "start": "08:00", "end": "22:00" } }
       }
     }
   }

2. 在工作区 HEARTBEAT.md 中添加触发指令：

   ## Self-Reflection Check (required)
   Run `self-reflection check` at each heartbeat.
   If ALERT: read past lessons, reflect, then log insights.

3. 创建配置文件 ~/.openclaw/self-reflection.json（可选，使用默认值可跳过）

常用命令

# 检查是否需要反思
self-reflection check

# 记录新反思：标签、失误描述、修正措施
self-reflection log "error-handling" "Forgot timeout on API call" "Always add timeout=30"

# 查看最近 5 条反思
self-reflection read

# 查看统计数据
self-reflection stats

输入与输出

见下方输入与输出表格。

风险提示

• 反思记录默认存储于本地文件，未做加密处理，敏感业务数据需谨慎脱敏
• 心跳频率过高可能导致频繁中断正常任务流，建议生产环境不低于 60 分钟
• 若 jq 或 date 缺失，技能将无法正常解析状态与执行时间计算
• 手动 reset 会清空计时器，可能造成反思窗口遗漏

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/hopyky/self-reflection/SKILL.md
来源类型：GitHub 开源仓库