# Send Fractal Memory to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "fractal-memory", "name": "Fractal Memory", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/bugmaker2/fractal-memory", "canonicalUrl": "https://clawhub.ai/bugmaker2/fractal-memory", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/fractal-memory", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fractal-memory", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "assets/heartbeat-state.json", "assets/rollup-state.json", "references/architecture.md", "references/cron-setup.md", "references/migration-guide.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "fractal-memory", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-01T13:39:49.025Z", "expiresAt": "2026-05-08T13:39:49.025Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fractal-memory", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fractal-memory", "contentDisposition": "attachment; filename=\"fractal-memory-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "fractal-memory" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/fractal-memory" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/fractal-memory", "downloadUrl": "https://openagent3.xyz/downloads/fractal-memory", "agentUrl": "https://openagent3.xyz/skills/fractal-memory/agent", "manifestUrl": "https://openagent3.xyz/skills/fractal-memory/agent.json", "briefUrl": "https://openagent3.xyz/skills/fractal-memory/agent.md" } } ``` ## Documentation ### Fractal Memory System Automated hierarchical memory compression that prevents context overflow. Like human sleep, compress raw experience into patterns, patterns into principles—keeping essence while managing scale. ### Philosophy Memory is not accumulation — it is compression with intention. Each layer compresses the one below without losing essence: Conversation → Daily → Weekly → Monthly → Core Memory ↓ Timeless Facts (sticky-notes) ### 1. Set Up Directory Structure mkdir -p memory/diary/{2026/{daily,weekly,monthly},sticky-notes/{workflows,apis,commands,facts}} ### 2. Initialize State Files Copy templates from assets/: cp assets/rollup-state.json memory/ cp assets/heartbeat-state.json memory/ ### 3. Install Scripts Copy all scripts from scripts/ to your workspace scripts/ directory: cp scripts/*.py ~/.openclaw/workspace/scripts/ chmod +x ~/.openclaw/workspace/scripts/*.py ### 4. Set Up Cron Jobs See references/cron-setup.md for detailed cron configuration. Quick version: Daily rollup: 23:59 every day Weekly rollup: 23:59 every Sunday Monthly rollup: 23:59 last day of month ### 5. Update Session Startup Add to your AGENTS.md: ## Every Session 1. Read \`SOUL.md\` 2. Read \`USER.md\` 3. Read \`memory/diary/YYYY/daily/YYYY-MM-DD.md\` (today + yesterday) 4. **If in MAIN SESSION**: Also read \`MEMORY.md\` **Context loading order:** TODAY → THIS WEEK → THIS MONTH → MEMORY.md ### ensure_daily_log.py Creates today's daily log if it doesn't exist. Run this in heartbeats or at session start. python3 scripts/ensure_daily_log.py ### append_to_daily.py Append events to today's daily log programmatically. python3 scripts/append_to_daily.py "Event description" ### rollup-daily.py Compress today's diary into this week's summary. Runs automatically at 23:59 daily. python3 scripts/rollup-daily.py ### rollup-weekly.py Compress this week's summary into this month's summary. Runs automatically at 23:59 every Sunday. python3 scripts/rollup-weekly.py ### rollup-monthly.py Distill this month's summary into MEMORY.md. Runs automatically at 23:59 on the last day of each month. python3 scripts/rollup-monthly.py ### verify_memory_integrity.py Check memory system integrity and detect anomalies. python3 scripts/verify_memory_integrity.py ### 1. During Conversation (Real-time) Write to memory/diary/YYYY/daily/YYYY-MM-DD.md immediately. Don't rely on memory—write it down. ### 2. Daily Rollup (23:59 every day) Extract patterns, decisions, key events → append to memory/diary/YYYY/weekly/YYYY-Wnn.md ### 3. Weekly Rollup (23:59 every Sunday) Compress to themes, trajectory, milestones → append to memory/diary/YYYY/monthly/YYYY-MM.md ### 4. Monthly Rollup (Last day of month) Distill major themes, lessons learned → update MEMORY.md ### 5. Timeless Facts (Anytime) Extract facts that recur 3+ times → store in memory/diary/sticky-notes/{category}/ ### 1. Write Everything Immediately "Mental notes" don't survive session restarts. Files do. ### 2. Compress, Don't Accumulate Files that grow forever become unreadable. Extract patterns, discard noise. ### 3. Curate Ruthlessly Not everything deserves to persist. Keep what defines you, release what doesn't. ### 4. Automate Discipline Scripts handle rollups so you don't have to remember. ### Context Loading Strategy Load memory in this order for attention optimization: TODAY - memory/diary/YYYY/daily/YYYY-MM-DD.md THIS WEEK - memory/diary/YYYY/weekly/YYYY-Wnn.md THIS MONTH - memory/diary/YYYY/monthly/YYYY-MM.md MEMORY.md - Core index (main session only) Relevant sticky-notes - As needed Why this order? Primacy + recency optimization. Most recent first, highest level early. ### Security Considerations Memory systems create attack surface. The system includes: Provenance tracking - Timestamps and metadata Integrity verification - verify_memory_integrity.py detects tampering Anomaly detection - Flags unusual patterns Run integrity checks periodically: python3 scripts/verify_memory_integrity.py ### Migration Migrating from existing memory systems? See references/migration-guide.md for: Flat daily files → Fractal structure Manual MEMORY.md only → Automated system Other hierarchical systems → Fractal memory ### Daily log not created Run ensure_daily_log.py manually or add to heartbeat checks. ### Rollup failed Check cron job runs: cron(action="runs", jobId="") ### Context still overflowing Verify rollups are running (check memory/rollup-state.json) Manually run rollup scripts to catch up Check MEMORY.md isn't growing too large (should be curated, not accumulated) ### Scripts not executable chmod +x scripts/*.py ### Custom Rollup Schedule Modify cron expressions in references/cron-setup.md ### Sticky Notes Categories Add custom categories in memory/diary/sticky-notes/: mkdir memory/diary/sticky-notes/my-category ### Manual Rollup Run rollup scripts manually anytime: python3 scripts/rollup-daily.py python3 scripts/rollup-weekly.py python3 scripts/rollup-monthly.py ### Architecture Details For deep dive into system design, philosophy, and implementation details, see references/architecture.md. ### References Deva's Fractal Memory v1.0.0 - Original inspiration Arcturus's Memory is Resurrection - Philosophical foundation Logi's Memory Architecture as Agency - Agency perspective "What grows from chaos is structure. What emerges from structure is memory. What persists through memory is self." — Deva ## Trust - Source: tencent - Verification: Indexed source record - Publisher: bugmaker2 - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-01T13:39:49.025Z - Expires at: 2026-05-08T13:39:49.025Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/fractal-memory) - [Send to Agent page](https://openagent3.xyz/skills/fractal-memory/agent) - [JSON manifest](https://openagent3.xyz/skills/fractal-memory/agent.json) - [Markdown brief](https://openagent3.xyz/skills/fractal-memory/agent.md) - [Download page](https://openagent3.xyz/downloads/fractal-memory)