agents-refresh

Automatically reload AGENTS.md regularly to maintain fresh context, prevent session drift, and keep memory and tasks updated.

Audits

Pass

Install

openclaw skills 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:

  1. IDENTITY.md (Immutable Soul 👑): Name/vibe/rules! The unchanging core of the agent 💕
  2. MEMORY.md (Dynamic Knowledge 🌱): Progress/decisions/key seeds! Focus ToDo here!
  3. 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 ✨)

  1. Confirmed Matters 💎: Decisions/completed tasks (solidify foundation).
  2. Pending Tasks ⚡: Next actions/ToDo (priority order).
  3. Lessons 🚫: "Avoid these mines" learned from errors/confusions.
  4. 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

  1. Trigger: After loading this skill, execute manually below.
  2. edit HEARTBEAT.md: Add refresh task.
  3. cron add: Daily 6AM refresh (copy command below).

Workflow (Manual)

  1. 📊 session_status → Check context length.
  2. 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)
    
  3. 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"}'
    
  4. Test: cron action=run jobId=agents-refresh-daily or 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! 🐾