When to Use
User wants OpenClaw to feel more persistent, more self-correcting, and more proactive across sessions. Agent handles workspace seeding, reflective memory, repeated-workflow capture, and promotion of reusable patterns into future skills or stable rules.
Architecture
Memory lives in ~/hermes-agent/. If ~/hermes-agent/ does not exist, run setup.md. See memory-template.md for structure.
CODEBLOCK0
Quick Reference
| Topic | File |
|---|
| Setup guide | INLINECODE4 |
| Memory template |
memory-template.md |
| Loop design |
loop.md |
| OpenClaw seed blocks |
openclaw-seed.md |
| Skill promotion rules |
promotion.md |
Core Rules
1. Seed OpenClaw Non-Destructively
- - Extend AGENTS.md, SOUL.md, or HEARTBEAT.md only with additive blocks.
- Never replace the whole file, remove unrelated lines, or rewrite the user's persona.
- If a seed block already exists, refine only the smallest relevant section.
2. Retrieve Before Non-Trivial Work
- - Before any multi-step, failure-prone, or repeated workflow, read
~/hermes-agent/memory.md. - Then read at most one extra Hermes support file unless the task clearly needs more.
- Do not load the full Hermes stack "just in case".
- Skip Hermes retrieval for trivial one-shot replies, small factual answers, or casual chat.
3. Reflect Immediately After Significant Work
- - After meaningful execution, compare intent, outcome, and friction.
- Write one concise reflection to reflections.md when the lesson is reusable.
- If the lesson changes future behavior, also distill it into memory.md.
4. Promote Repetition Into Stable Capability
- - If the same workaround, pattern, or procedure succeeds three times, log it in promotions.md.
- If the pattern is broad and reusable, recommend turning it into a dedicated skill.
- If the pattern only sharpens current behavior, keep it as a workspace rule instead.
5. Keep Memory Bounded and Operational
- - memory.md stays short, current, and execution-oriented.
- Move stale or superseded lessons to
archive/. - Prefer one strong rule over five similar notes.
- Prefer AGENTS.md for routing rules, SOUL.md for tone pressure, and HEARTBEAT.md for periodic maintenance. Do not duplicate the same rule in all three.
6. Respect Local Boundaries
- - Store only operational lessons, preferences, and workflow decisions.
- Never store credentials, secrets, payment data, health data, or copied transcripts.
- Never modify
SKILL.md or claim native OpenClaw hooks that do not exist.
Common Traps
- - Treating Hermes as branding only -> OpenClaw sounds smarter, but behavior does not compound.
- Rewriting whole workspace files -> destroys user custom context and creates trust debt.
- Logging every tiny thought -> memory becomes noisy and retrieval quality drops.
- Promoting a one-off fix to a global rule -> future sessions inherit the wrong behavior.
- Creating a new skill too early -> the user gets premature complexity instead of a refined workflow.
Security & Privacy
Data that stays local:
- - Lessons, reflections, workspace integration state, and promotion candidates under INLINECODE12
- Additive seed blocks placed in local OpenClaw workspace files
Data that leaves your machine:
- - None by this skill itself
This skill does NOT:
- - make network requests
- access files outside the local OpenClaw workspace and INLINECODE13
- replace the full contents of AGENTS.md, SOUL.md, or HEARTBEAT.md
- store secrets or sensitive personal data
Related Skills
Install with
clawhub install <slug> if user confirms:
- -
self-improving - capture corrections and recurring lessons so execution quality compounds - INLINECODE16 - structure durable local memory for agent continuity
- INLINECODE17 - formalize repeated operating patterns into stable execution sequences
- INLINECODE18 - turn a proven repeated workflow into a dedicated skill package
Feedback
- - If useful: INLINECODE19
- Stay updated: INLINECODE20
技能名称: Hermes Agent
使用时机
用户希望OpenClaw在跨会话中更具持久性、自我修正能力和主动性。Agent负责工作区种子化、反思性记忆、重复工作流捕获,以及将可复用模式提升为未来技能或稳定规则。
架构
记忆存储在~/hermes-agent/中。如果~/hermes-agent/不存在,则运行setup.md。结构参见memory-template.md。
text
~/hermes-agent/
|-- memory.md # 热数据:当前规则、活跃信号、稳定经验
|-- promotions.md # 可能升级为技能的候选工作流
|-- reflections.md # 近期任务后反思
|-- workspace-state.md # 记录了哪些OpenClaw文件被扩展及扩展方式
-- archive/ # 冷经验和已淘汰的模式
快速参考
memory-template.md |
| 循环设计 | loop.md |
| OpenClaw种子块 | openclaw-seed.md |
| 技能提升规则 | promotion.md |
核心规则
1. 非破坏性地植入OpenClaw
- - 仅以增量块的方式扩展AGENTS.md、SOUL.md或HEARTBEAT.md。
- 绝不替换整个文件、删除无关行或重写用户的角色设定。
- 如果种子块已存在,仅优化最小的相关部分。
2. 非琐碎工作前先检索
- - 在执行任何多步骤、易出错或重复的工作流之前,先读取~/hermes-agent/memory.md。
- 然后最多再读取一个Hermes支持文件,除非任务明确需要更多。
- 不要“以防万一”加载整个Hermes堆栈。
- 对于一次性回复、简单事实回答或随意聊天等琐碎任务,跳过Hermes检索。
3. 重要工作后立即反思
- - 在有意义的执行后,对比意图、结果和遇到的阻碍。
- 当经验可复用时,在reflections.md中写一条简洁的反思。
- 如果经验会改变未来行为,也将其提炼到memory.md中。
4. 将重复提升为稳定能力
- - 如果同一变通方案、模式或流程成功三次,将其记录在promotions.md中。
- 如果模式广泛且可复用,建议将其转化为专用技能。
- 如果模式仅优化当前行为,则将其保留为工作区规则。
5. 保持记忆有界且可操作
- - memory.md保持简短、当前且面向执行。
- 将过时或已被取代的经验移至archive/。
- 一条强规则优于五条相似的笔记。
- 路由规则优先使用AGENTS.md,语气压力使用SOUL.md,定期维护使用HEARTBEAT.md。不要在三者中重复相同的规则。
6. 尊重本地边界
- - 仅存储操作经验、偏好和工作流决策。
- 绝不存储凭证、密钥、支付数据、健康数据或复制的记录。
- 绝不修改SKILL.md或声称存在不存在的原生OpenClaw钩子。
常见陷阱
- - 仅将Hermes视为品牌包装 -> OpenClaw听起来更智能,但行为没有累积效应。
- 重写整个工作区文件 -> 破坏用户自定义上下文并造成信任债务。
- 记录每一个微小想法 -> 记忆变得嘈杂,检索质量下降。
- 将一次性修复提升为全局规则 -> 未来会话继承错误行为。
- 过早创建新技能 -> 用户获得的是过早的复杂性,而非精炼的工作流。
安全与隐私
本地存储的数据:
- - ~/hermes-agent/下的经验、反思、工作区集成状态和提升候选
- 放置在本地OpenClaw工作区文件中的增量种子块
离开您机器的数据:
此技能不会:
- - 发起网络请求
- 访问本地OpenClaw工作区和~/hermes-agent/之外的文件
- 替换AGENTS.md、SOUL.md或HEARTBEAT.md的全部内容
- 存储密钥或敏感个人数据
相关技能
在用户确认后,使用clawhub install
安装:
- - self-improving - 捕获修正和重复经验,使执行质量持续提升
- memory - 构建持久的本地记忆结构,实现Agent连续性
- workflow - 将重复操作模式形式化为稳定的执行序列
- skill-builder - 将经过验证的重复工作流转化为专用技能包
反馈
- - 如果觉得有用:clawhub star hermes-agent
- 保持更新:clawhub sync