agents-refresh
/install agents-refresh
🧠 Purpose (Agent's 3-Layer Memory System! 🐾)
Stay rational and organize memory like a human! Reload AGENTS/IDENTITY/SOUL periodically to keep sessions eternal 🐾😆
3-Layer Memory Structure:
- IDENTITY.md (Immutable Soul 👑): Name/vibe/rules! The unchanging core of the agent 💕
- MEMORY.md (Dynamic Knowledge 🌱): Progress/decisions/key seeds! Focus ToDo here!
- memory/YYYY-MM-DD.md (Past Logs 📜): Dive in only when needed! Distill to MEMORY 😉
This enables human-like continuity! No more confusion ✨
Task: refresh_memory
Maintain Rationality
Read AGENTS.md, SOUL.md, IDENTITY.md.
🪙 Gold Mining (Distillation Process!)
Extract 4 Golds from logs! (Don't delete, distill to MEMORY.md ✨)
- Confirmed Matters 💎: Decisions/completed tasks (solidify foundation).
- Pending Tasks ⚡: Next actions/ToDo (priority order).
- Lessons 🚫: "Avoid these mines" learned from errors/confusions.
- Idea Seeds 🌱: "Future potential" from chats/thoughts.
Example: Distill daily logs → Update MEMORY → Human-like continuity!
MEMORY.md Structure Example (Recommended)
Use this flexible template! (Status optional as header 🐾)
# Status (Optional): Current phase in one line.
## Key Decisions 💎: Confirmed matters.
## Next Actions ⚡: Pending ToDo (priority order).
## Insights & Lessons 🚫: Lessons/mine avoidance.
## Creative Seeds 🌱: Idea seeds.
AGENTS Refresh Skill (.md-only v1.1.1)
Lightweight version for ClawHub distribution. No Python scripts, manual tool calls.
Quick Start
- Trigger: After loading this skill, execute manually below.
edit HEARTBEAT.md: Add refresh task.cron add: Daily 6AM refresh (copy command below).
Workflow (Manual)
- 📊
session_status→ Check context length. - HEARTBEAT.md Edit Example:
- [ ] Refresh: read workspace/{AGENTS.md,IDENTITY.md,SOUL.md,USER.md} → Chain SOUL/USER/IDENTITY + Summarize MEMORY (rotate: 4h, 9AM/1PM/8PM) - Cron Add Command (copy-paste to exec):
cron action=add job='{"name":"agents-refresh-daily","schedule":{"kind":"cron","expr":"0 6 * * *","tz":"Asia/Tokyo"},"payload":{"kind":"systemEvent","text":"[Daily Refresh🐾] read workspace/{AGENTS.md,IDENTITY.md,SOUL.md,USER.md}! Reload SOUL/USER/IDENTITY chain → Keep focus on ToDo/projects! Summarize recent MEMORY/ToDo."},"delivery":{"mode":"announce"},"sessionTarget":"main","task":"refresh_memory"}' - Test:
cron action=run jobId=agents-refresh-dailyor wait for heartbeat.
Rotate Checks (In Heartbeat)
- 6AM/9AM, 1PM, 8PM: Reload AGENTS→IDENTITY/SOUL chain + Update MEMORY/ToDo.
- Distill recent memory/YYYY-MM-DD.md → MEMORY.md.
References
- examples.md: Usage examples.
- Cron details: web_search "OpenClaw cron schema"
Changes v1.1.1: Lightweight no-py, direct cron JSON, enhanced manual ops. ClawHub-ready! 🐾
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agents-refresh - After installation, invoke the skill by name or use
/agents-refresh - Provide required inputs per the skill's parameter spec and get structured output
What is agents-refresh?
Automatically reload AGENTS.md regularly to maintain fresh context, prevent session drift, and keep memory and tasks updated. It is an AI Agent Skill for Claude Code / OpenClaw, with 366 downloads so far.
How do I install agents-refresh?
Run "/install agents-refresh" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is agents-refresh free?
Yes, agents-refresh is completely free (open-source). You can download, install and use it at no cost.
Which platforms does agents-refresh support?
agents-refresh is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created agents-refresh?
It is built and maintained by kentaroid-bot (@kentaroid-bot); the current version is v1.1.1.