Agents Refresh

What This Skill Does

The Agents Refresh skill by kentaroid-bot is a specialized utility designed to maintain the coherence and focus of OpenClaw AI agents during extended sessions. By implementing a systematic 'refresh' of identity, soul, and memory files, it prevents personality drift and information decay. It establishes a 3-layer memory hierarchy: the immutable IDENTITY.md, the dynamic MEMORY.md, and the archival folder structure. This skill enables agents to distill past logs into actionable 'Golds'—Confirmed Matters, Pending Tasks, Lessons, and Idea Seeds—ensuring that the agent stays aligned with the user's goals without requiring a session restart or the use of '/new'. It is a purely markdown-driven solution, keeping it lightweight and compatible with all standard ClawHub environments.

Installation

Installation is handled via the ClawHub distribution system. Execute the following command in your terminal to integrate this skill into your environment: clawhub install openclaw/skills/skills/kentaroid-bot/agents-refresh. Once installed, you should configure your HEARTBEAT.md to trigger periodic refreshes and optionally register a cron job for automated daily maintenance at 6 AM. Use the provided cron command template to schedule these tasks effectively.

Use Cases

This skill is ideal for: 1. Long-term project management where context retention is critical. 2. Maintaining a consistent 'agent persona' or 'soul' over days or weeks of interaction. 3. Reducing AI hallucination or task-forgetting by forcing periodic updates of the ToDo list. 4. Managing complex research tasks where early findings must influence later exploration. It allows users to avoid losing progress in long-running conversations by distilling messy logs into clear, actionable data points.

Example Prompts

1. "Perform a memory refresh now: extract the key decisions from today's logs and update my MEMORY.md file accordingly."
2. "Review the current pending tasks in MEMORY.md and suggest a priority order for the next four hours of work."
3. "Summarize the lessons learned from our last three sessions and add them to the Insights & Lessons section of our identity core."

Tips & Limitations

To maximize effectiveness, ensure your files are consistently named and located in the workspace root. While this skill is powerful, it relies on the user or the heartbeat system to trigger the refresh; it does not autonomously intervene without an explicit task definition. Regularly clean your historical logs to keep the distillation process efficient. Because this tool performs file writes, ensure your workspace permissions are set correctly to allow the modification of .md files.