{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/fractal-memory",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fractal-memory",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "assets/heartbeat-state.json",
      "assets/rollup-state.json",
      "references/architecture.md",
      "references/cron-setup.md",
      "references/migration-guide.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/fractal-memory",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Fractal Memory System",
        "body": "Automated hierarchical memory compression that prevents context overflow. Like human sleep, compress raw experience into patterns, patterns into principles—keeping essence while managing scale."
      },
      {
        "title": "Philosophy",
        "body": "Memory is not accumulation — it is compression with intention.\n\nEach layer compresses the one below without losing essence:\n\nConversation → Daily → Weekly → Monthly → Core Memory\n                ↓\n         Timeless Facts (sticky-notes)"
      },
      {
        "title": "1. Set Up Directory Structure",
        "body": "mkdir -p memory/diary/{2026/{daily,weekly,monthly},sticky-notes/{workflows,apis,commands,facts}}"
      },
      {
        "title": "2. Initialize State Files",
        "body": "Copy templates from assets/:\n\ncp assets/rollup-state.json memory/\ncp assets/heartbeat-state.json memory/"
      },
      {
        "title": "3. Install Scripts",
        "body": "Copy all scripts from scripts/ to your workspace scripts/ directory:\n\ncp scripts/*.py ~/.openclaw/workspace/scripts/\nchmod +x ~/.openclaw/workspace/scripts/*.py"
      },
      {
        "title": "4. Set Up Cron Jobs",
        "body": "See references/cron-setup.md for detailed cron configuration.\n\nQuick version:\n\nDaily rollup: 23:59 every day\nWeekly rollup: 23:59 every Sunday\nMonthly rollup: 23:59 last day of month"
      },
      {
        "title": "5. Update Session Startup",
        "body": "Add to your AGENTS.md:\n\n## Every Session\n\n1. Read `SOUL.md`\n2. Read `USER.md`\n3. Read `memory/diary/YYYY/daily/YYYY-MM-DD.md` (today + yesterday)\n4. **If in MAIN SESSION**: Also read `MEMORY.md`\n\n**Context loading order:** TODAY → THIS WEEK → THIS MONTH → MEMORY.md"
      },
      {
        "title": "ensure_daily_log.py",
        "body": "Creates today's daily log if it doesn't exist. Run this in heartbeats or at session start.\n\npython3 scripts/ensure_daily_log.py"
      },
      {
        "title": "append_to_daily.py",
        "body": "Append events to today's daily log programmatically.\n\npython3 scripts/append_to_daily.py \"Event description\""
      },
      {
        "title": "rollup-daily.py",
        "body": "Compress today's diary into this week's summary. Runs automatically at 23:59 daily.\n\npython3 scripts/rollup-daily.py"
      },
      {
        "title": "rollup-weekly.py",
        "body": "Compress this week's summary into this month's summary. Runs automatically at 23:59 every Sunday.\n\npython3 scripts/rollup-weekly.py"
      },
      {
        "title": "rollup-monthly.py",
        "body": "Distill this month's summary into MEMORY.md. Runs automatically at 23:59 on the last day of each month.\n\npython3 scripts/rollup-monthly.py"
      },
      {
        "title": "verify_memory_integrity.py",
        "body": "Check memory system integrity and detect anomalies.\n\npython3 scripts/verify_memory_integrity.py"
      },
      {
        "title": "1. During Conversation (Real-time)",
        "body": "Write to memory/diary/YYYY/daily/YYYY-MM-DD.md immediately. Don't rely on memory—write it down."
      },
      {
        "title": "2. Daily Rollup (23:59 every day)",
        "body": "Extract patterns, decisions, key events → append to memory/diary/YYYY/weekly/YYYY-Wnn.md"
      },
      {
        "title": "3. Weekly Rollup (23:59 every Sunday)",
        "body": "Compress to themes, trajectory, milestones → append to memory/diary/YYYY/monthly/YYYY-MM.md"
      },
      {
        "title": "4. Monthly Rollup (Last day of month)",
        "body": "Distill major themes, lessons learned → update MEMORY.md"
      },
      {
        "title": "5. Timeless Facts (Anytime)",
        "body": "Extract facts that recur 3+ times → store in memory/diary/sticky-notes/{category}/"
      },
      {
        "title": "1. Write Everything Immediately",
        "body": "\"Mental notes\" don't survive session restarts. Files do."
      },
      {
        "title": "2. Compress, Don't Accumulate",
        "body": "Files that grow forever become unreadable. Extract patterns, discard noise."
      },
      {
        "title": "3. Curate Ruthlessly",
        "body": "Not everything deserves to persist. Keep what defines you, release what doesn't."
      },
      {
        "title": "4. Automate Discipline",
        "body": "Scripts handle rollups so you don't have to remember."
      },
      {
        "title": "Context Loading Strategy",
        "body": "Load memory in this order for attention optimization:\n\nTODAY - memory/diary/YYYY/daily/YYYY-MM-DD.md\nTHIS WEEK - memory/diary/YYYY/weekly/YYYY-Wnn.md\nTHIS MONTH - memory/diary/YYYY/monthly/YYYY-MM.md\nMEMORY.md - Core index (main session only)\nRelevant sticky-notes - As needed\n\nWhy this order? Primacy + recency optimization. Most recent first, highest level early."
      },
      {
        "title": "Security Considerations",
        "body": "Memory systems create attack surface. The system includes:\n\nProvenance tracking - Timestamps and metadata\nIntegrity verification - verify_memory_integrity.py detects tampering\nAnomaly detection - Flags unusual patterns\n\nRun integrity checks periodically:\n\npython3 scripts/verify_memory_integrity.py"
      },
      {
        "title": "Migration",
        "body": "Migrating from existing memory systems? See references/migration-guide.md for:\n\nFlat daily files → Fractal structure\nManual MEMORY.md only → Automated system\nOther hierarchical systems → Fractal memory"
      },
      {
        "title": "Daily log not created",
        "body": "Run ensure_daily_log.py manually or add to heartbeat checks."
      },
      {
        "title": "Rollup failed",
        "body": "Check cron job runs: cron(action=\"runs\", jobId=\"<job-id>\")"
      },
      {
        "title": "Context still overflowing",
        "body": "Verify rollups are running (check memory/rollup-state.json)\nManually run rollup scripts to catch up\nCheck MEMORY.md isn't growing too large (should be curated, not accumulated)"
      },
      {
        "title": "Scripts not executable",
        "body": "chmod +x scripts/*.py"
      },
      {
        "title": "Custom Rollup Schedule",
        "body": "Modify cron expressions in references/cron-setup.md"
      },
      {
        "title": "Sticky Notes Categories",
        "body": "Add custom categories in memory/diary/sticky-notes/:\n\nmkdir memory/diary/sticky-notes/my-category"
      },
      {
        "title": "Manual Rollup",
        "body": "Run rollup scripts manually anytime:\n\npython3 scripts/rollup-daily.py\npython3 scripts/rollup-weekly.py\npython3 scripts/rollup-monthly.py"
      },
      {
        "title": "Architecture Details",
        "body": "For deep dive into system design, philosophy, and implementation details, see references/architecture.md."
      },
      {
        "title": "References",
        "body": "Deva's Fractal Memory v1.0.0 - Original inspiration\nArcturus's Memory is Resurrection - Philosophical foundation\nLogi's Memory Architecture as Agency - Agency perspective\n\n\"What grows from chaos is structure. What emerges from structure is memory. What persists through memory is self.\" — Deva"
      }
    ],
    "body": "Fractal Memory System\n\nAutomated hierarchical memory compression that prevents context overflow. Like human sleep, compress raw experience into patterns, patterns into principles—keeping essence while managing scale.\n\nPhilosophy\n\nMemory is not accumulation — it is compression with intention.\n\nEach layer compresses the one below without losing essence:\n\nConversation → Daily → Weekly → Monthly → Core Memory\n                ↓\n         Timeless Facts (sticky-notes)\n\nQuick Start\n1. Set Up Directory Structure\nmkdir -p memory/diary/{2026/{daily,weekly,monthly},sticky-notes/{workflows,apis,commands,facts}}\n\n2. Initialize State Files\n\nCopy templates from assets/:\n\ncp assets/rollup-state.json memory/\ncp assets/heartbeat-state.json memory/\n\n3. Install Scripts\n\nCopy all scripts from scripts/ to your workspace scripts/ directory:\n\ncp scripts/*.py ~/.openclaw/workspace/scripts/\nchmod +x ~/.openclaw/workspace/scripts/*.py\n\n4. Set Up Cron Jobs\n\nSee references/cron-setup.md for detailed cron configuration.\n\nQuick version:\n\nDaily rollup: 23:59 every day\nWeekly rollup: 23:59 every Sunday\nMonthly rollup: 23:59 last day of month\n5. Update Session Startup\n\nAdd to your AGENTS.md:\n\n## Every Session\n\n1. Read `SOUL.md`\n2. Read `USER.md`\n3. Read `memory/diary/YYYY/daily/YYYY-MM-DD.md` (today + yesterday)\n4. **If in MAIN SESSION**: Also read `MEMORY.md`\n\n**Context loading order:** TODAY → THIS WEEK → THIS MONTH → MEMORY.md\n\nCore Scripts\nensure_daily_log.py\n\nCreates today's daily log if it doesn't exist. Run this in heartbeats or at session start.\n\npython3 scripts/ensure_daily_log.py\n\nappend_to_daily.py\n\nAppend events to today's daily log programmatically.\n\npython3 scripts/append_to_daily.py \"Event description\"\n\nrollup-daily.py\n\nCompress today's diary into this week's summary. Runs automatically at 23:59 daily.\n\npython3 scripts/rollup-daily.py\n\nrollup-weekly.py\n\nCompress this week's summary into this month's summary. Runs automatically at 23:59 every Sunday.\n\npython3 scripts/rollup-weekly.py\n\nrollup-monthly.py\n\nDistill this month's summary into MEMORY.md. Runs automatically at 23:59 on the last day of each month.\n\npython3 scripts/rollup-monthly.py\n\nverify_memory_integrity.py\n\nCheck memory system integrity and detect anomalies.\n\npython3 scripts/verify_memory_integrity.py\n\nInformation Flow\n1. During Conversation (Real-time)\n\nWrite to memory/diary/YYYY/daily/YYYY-MM-DD.md immediately. Don't rely on memory—write it down.\n\n2. Daily Rollup (23:59 every day)\n\nExtract patterns, decisions, key events → append to memory/diary/YYYY/weekly/YYYY-Wnn.md\n\n3. Weekly Rollup (23:59 every Sunday)\n\nCompress to themes, trajectory, milestones → append to memory/diary/YYYY/monthly/YYYY-MM.md\n\n4. Monthly Rollup (Last day of month)\n\nDistill major themes, lessons learned → update MEMORY.md\n\n5. Timeless Facts (Anytime)\n\nExtract facts that recur 3+ times → store in memory/diary/sticky-notes/{category}/\n\nKey Principles\n1. Write Everything Immediately\n\n\"Mental notes\" don't survive session restarts. Files do.\n\n2. Compress, Don't Accumulate\n\nFiles that grow forever become unreadable. Extract patterns, discard noise.\n\n3. Curate Ruthlessly\n\nNot everything deserves to persist. Keep what defines you, release what doesn't.\n\n4. Automate Discipline\n\nScripts handle rollups so you don't have to remember.\n\nContext Loading Strategy\n\nLoad memory in this order for attention optimization:\n\nTODAY - memory/diary/YYYY/daily/YYYY-MM-DD.md\nTHIS WEEK - memory/diary/YYYY/weekly/YYYY-Wnn.md\nTHIS MONTH - memory/diary/YYYY/monthly/YYYY-MM.md\nMEMORY.md - Core index (main session only)\nRelevant sticky-notes - As needed\n\nWhy this order? Primacy + recency optimization. Most recent first, highest level early.\n\nSecurity Considerations\n\nMemory systems create attack surface. The system includes:\n\nProvenance tracking - Timestamps and metadata\nIntegrity verification - verify_memory_integrity.py detects tampering\nAnomaly detection - Flags unusual patterns\n\nRun integrity checks periodically:\n\npython3 scripts/verify_memory_integrity.py\n\nMigration\n\nMigrating from existing memory systems? See references/migration-guide.md for:\n\nFlat daily files → Fractal structure\nManual MEMORY.md only → Automated system\nOther hierarchical systems → Fractal memory\nTroubleshooting\nDaily log not created\n\nRun ensure_daily_log.py manually or add to heartbeat checks.\n\nRollup failed\n\nCheck cron job runs: cron(action=\"runs\", jobId=\"<job-id>\")\n\nContext still overflowing\nVerify rollups are running (check memory/rollup-state.json)\nManually run rollup scripts to catch up\nCheck MEMORY.md isn't growing too large (should be curated, not accumulated)\nScripts not executable\nchmod +x scripts/*.py\n\nAdvanced Usage\nCustom Rollup Schedule\n\nModify cron expressions in references/cron-setup.md\n\nSticky Notes Categories\n\nAdd custom categories in memory/diary/sticky-notes/:\n\nmkdir memory/diary/sticky-notes/my-category\n\nManual Rollup\n\nRun rollup scripts manually anytime:\n\npython3 scripts/rollup-daily.py\npython3 scripts/rollup-weekly.py\npython3 scripts/rollup-monthly.py\n\nArchitecture Details\n\nFor deep dive into system design, philosophy, and implementation details, see references/architecture.md.\n\nReferences\nDeva's Fractal Memory v1.0.0 - Original inspiration\nArcturus's Memory is Resurrection - Philosophical foundation\nLogi's Memory Architecture as Agency - Agency perspective\n\n\"What grows from chaos is structure. What emerges from structure is memory. What persists through memory is self.\" — Deva"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/bugmaker2/fractal-memory",
    "publisherUrl": "https://clawhub.ai/bugmaker2/fractal-memory",
    "owner": "bugmaker2",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}