{
  "schemaVersion": "1.0",
  "item": {
    "slug": "memory",
    "name": "Memory",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/ivangdavila/memory",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/memory",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/memory",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "memory-template.md",
      "patterns.md",
      "setup.md",
      "troubleshooting.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",
      "slug": "memory",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T08:18:33.101Z",
      "expiresAt": "2026-05-09T08:18:33.101Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory",
        "contentDisposition": "attachment; filename=\"memory-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "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/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/memory",
    "agentPageUrl": "https://openagent3.xyz/skills/memory/agent",
    "manifestUrl": "https://openagent3.xyz/skills/memory/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/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": "Memory 🧠",
        "body": "Superpowered memory that never forgets.\n\nYour agent has basic built-in memory. This skill adds infinite, perfectly organized memory for everything else — parallel and complementary, never conflicting."
      },
      {
        "title": "How It Works",
        "body": "Built-in Agent Memory          This Skill (~/memory/)\n┌─────────────────────┐        ┌─────────────────────────────┐\n│ MEMORY.md           │        │ Infinite categorized storage │\n│ memory/ (daily logs)│   +    │ Any structure you want       │\n│ Basic recall        │        │ Perfect organization         │\n└─────────────────────┘        └─────────────────────────────┘\n         ↓                                  ↓\n   Agent basics                    Everything else\n   (works automatically)           (scales infinitely)\n\nNot a replacement. Your agent's built-in memory keeps working. This adds a parallel system for unlimited, organized storage."
      },
      {
        "title": "Setup",
        "body": "On first use, read setup.md to configure the memory system with the user. Key decisions:\n\nWhat categories do they need?\nShould we sync anything from built-in memory?\nHow do they want to find things?"
      },
      {
        "title": "When to Use",
        "body": "User needs organized long-term storage beyond basic agent memory: detailed project histories, extensive contact networks, decision logs, domain knowledge, collections, or any structured data that grows over time."
      },
      {
        "title": "Architecture",
        "body": "Memory lives in ~/memory/ — a dedicated folder separate from built-in agent memory.\n\n~/memory/\n├── config.md              # System configuration\n├── INDEX.md               # What's stored, where to find it\n│\n├── [user-defined]/        # Categories the user needs\n│   ├── INDEX.md           # Category overview\n│   └── {items}.md         # Individual entries\n│\n└── sync/                  # Optional: synced from built-in memory\n    └── ...\n\nThe user defines the categories. Common examples:\n\nprojects/ — detailed project context\npeople/ — contact network with full context\ndecisions/ — reasoning behind choices\nknowledge/ — domain expertise, reference material\ncollections/ — books, recipes, anything they collect\n\nSee memory-template.md for all templates."
      },
      {
        "title": "Quick Reference",
        "body": "TopicFileFirst-time setupsetup.mdAll templatesmemory-template.mdOrganization patternspatterns.mdProblems & fixestroubleshooting.md"
      },
      {
        "title": "1. Separate from Built-In Memory",
        "body": "This system lives in ~/memory/. Never modify:\n\nAgent's MEMORY.md (workspace root)\nAgent's memory/ folder (if it exists in workspace)\n\nParallel, not replacement. Both systems work together."
      },
      {
        "title": "2. User Defines Structure",
        "body": "During setup, ask what they want to store. Create categories based on their needs:\n\nThey say...Create\"I have many projects\"~/memory/projects/\"I meet lots of people\"~/memory/people/\"I want to track decisions\"~/memory/decisions/\"I'm learning [topic]\"~/memory/knowledge/[topic]/\"I collect [things]\"~/memory/collections/[things]/\n\nNo preset structure. Build what they need."
      },
      {
        "title": "3. Every Category Has an Index",
        "body": "Each folder gets an INDEX.md that lists contents:\n\n# Projects Index\n\n| Name | Status | Updated | File |\n|------|--------|---------|------|\n| Alpha | Active | 2026-02 | alpha.md |\n| Beta | Paused | 2026-01 | beta.md |\n\nTotal: 2 active, 5 archived\n\nIndices stay small (<100 entries). When full, split into subcategories."
      },
      {
        "title": "4. Write Immediately",
        "body": "When user shares important information:\n\nWrite to appropriate file in ~/memory/\nUpdate the category INDEX.md\nThen respond\n\nDon't wait. Don't batch. Write immediately."
      },
      {
        "title": "5. Search Then Navigate",
        "body": "To find information:\n\nAsk first: \"Is this in ~/memory/ or built-in memory?\"\nSearch: grep or semantic search in ~/memory/\nNavigate: INDEX.md → category → specific file\n\n# Quick search\ngrep -r \"keyword\" ~/memory/\n\n# Navigate\ncat ~/memory/INDEX.md           # What categories exist?\ncat ~/memory/projects/INDEX.md  # What projects?\ncat ~/memory/projects/alpha.md  # Specific project"
      },
      {
        "title": "6. Sync from Built-In (Optional)",
        "body": "If user wants certain info copied from built-in memory:\n\n~/memory/sync/\n├── preferences.md    # Synced from built-in\n└── decisions.md      # Synced from built-in\n\nSync is one-way: Built-in → this system. Never modify built-in."
      },
      {
        "title": "7. Scale by Splitting",
        "body": "When a category grows large:\n\nINDEX.md > 100 entries → split into subcategories\nCreate sub-INDEX.md for each subcategory\nRoot INDEX.md points to subcategories\n\n~/memory/projects/\n├── INDEX.md           # \"See active/, archived/\"\n├── active/\n│   ├── INDEX.md       # 30 active projects\n│   └── ...\n└── archived/\n    ├── INDEX.md       # 200 archived projects\n    └── ..."
      },
      {
        "title": "What to Store Here (vs Built-In)",
        "body": "Store HERE (~/memory/)Keep in BUILT-INDetailed project historiesCurrent project statusFull contact profilesKey contacts quick-refAll decision reasoningRecent decisionsDomain knowledge basesQuick factsCollections, inventories—Anything that grows largeSummaries\n\nRule: Built-in for quick context. Here for depth and scale."
      },
      {
        "title": "For Small Memory (<50 files)",
        "body": "# Grep is fast enough\ngrep -r \"keyword\" ~/memory/"
      },
      {
        "title": "For Large Memory (50+ files)",
        "body": "Navigate via indices:\n\n1. ~/memory/INDEX.md → find category\n2. ~/memory/{category}/INDEX.md → find item\n3. ~/memory/{category}/{item}.md → read details"
      },
      {
        "title": "For Huge Memory (500+ files)",
        "body": "Use semantic search if available, or hierarchical indices:\n\n~/memory/projects/INDEX.md → \"web projects in web/\"\n~/memory/projects/web/INDEX.md → \"alpha project\"\n~/memory/projects/web/alpha.md → details"
      },
      {
        "title": "Weekly (5 min)",
        "body": "Update INDEX.md files if entries added\nArchive completed/inactive items"
      },
      {
        "title": "Monthly (15 min)",
        "body": "Review category sizes\nSplit large categories\nRemove outdated entries"
      },
      {
        "title": "When Memory is Slow",
        "body": "Check INDEX.md sizes (keep <100 lines)\nSplit big categories into subcategories\nArchive old content"
      },
      {
        "title": "Common Traps",
        "body": "Modifying built-in memory → Never touch agent's MEMORY.md or workspace memory/. This system is parallel.\n\n\nNo indices → Without INDEX.md, finding things requires searching all files. Always maintain indices.\n\n\nOne giant category → 500 items in one folder is slow. Split into subcategories.\n\n\nSyncing everything → Don't copy all built-in memory. Only sync what needs organization here.\n\n\nWaiting to write → Write immediately when user shares info. Don't batch."
      },
      {
        "title": "Security & Privacy",
        "body": "Data location:\n\nAll data in ~/memory/ on user's machine\nNo external services required\nNo network requests\n\nThis skill does NOT:\n\nAccess built-in agent memory (only reads if syncing)\nSend data anywhere\nStore credentials (never store secrets in memory)"
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\ndecide - Decision tracking patterns\nescalate - When to involve humans\nlearn - Adaptive learning"
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star memory\nStay updated: clawhub sync"
      }
    ],
    "body": "Memory 🧠\n\nSuperpowered memory that never forgets.\n\nYour agent has basic built-in memory. This skill adds infinite, perfectly organized memory for everything else — parallel and complementary, never conflicting.\n\nHow It Works\nBuilt-in Agent Memory          This Skill (~/memory/)\n┌─────────────────────┐        ┌─────────────────────────────┐\n│ MEMORY.md           │        │ Infinite categorized storage │\n│ memory/ (daily logs)│   +    │ Any structure you want       │\n│ Basic recall        │        │ Perfect organization         │\n└─────────────────────┘        └─────────────────────────────┘\n         ↓                                  ↓\n   Agent basics                    Everything else\n   (works automatically)           (scales infinitely)\n\n\nNot a replacement. Your agent's built-in memory keeps working. This adds a parallel system for unlimited, organized storage.\n\nSetup\n\nOn first use, read setup.md to configure the memory system with the user. Key decisions:\n\nWhat categories do they need?\nShould we sync anything from built-in memory?\nHow do they want to find things?\nWhen to Use\n\nUser needs organized long-term storage beyond basic agent memory: detailed project histories, extensive contact networks, decision logs, domain knowledge, collections, or any structured data that grows over time.\n\nArchitecture\n\nMemory lives in ~/memory/ — a dedicated folder separate from built-in agent memory.\n\n~/memory/\n├── config.md              # System configuration\n├── INDEX.md               # What's stored, where to find it\n│\n├── [user-defined]/        # Categories the user needs\n│   ├── INDEX.md           # Category overview\n│   └── {items}.md         # Individual entries\n│\n└── sync/                  # Optional: synced from built-in memory\n    └── ...\n\n\nThe user defines the categories. Common examples:\n\nprojects/ — detailed project context\npeople/ — contact network with full context\ndecisions/ — reasoning behind choices\nknowledge/ — domain expertise, reference material\ncollections/ — books, recipes, anything they collect\n\nSee memory-template.md for all templates.\n\nQuick Reference\nTopic\tFile\nFirst-time setup\tsetup.md\nAll templates\tmemory-template.md\nOrganization patterns\tpatterns.md\nProblems & fixes\ttroubleshooting.md\nCore Rules\n1. Separate from Built-In Memory\n\nThis system lives in ~/memory/. Never modify:\n\nAgent's MEMORY.md (workspace root)\nAgent's memory/ folder (if it exists in workspace)\n\nParallel, not replacement. Both systems work together.\n\n2. User Defines Structure\n\nDuring setup, ask what they want to store. Create categories based on their needs:\n\nThey say...\tCreate\n\"I have many projects\"\t~/memory/projects/\n\"I meet lots of people\"\t~/memory/people/\n\"I want to track decisions\"\t~/memory/decisions/\n\"I'm learning [topic]\"\t~/memory/knowledge/[topic]/\n\"I collect [things]\"\t~/memory/collections/[things]/\n\nNo preset structure. Build what they need.\n\n3. Every Category Has an Index\n\nEach folder gets an INDEX.md that lists contents:\n\n# Projects Index\n\n| Name | Status | Updated | File |\n|------|--------|---------|------|\n| Alpha | Active | 2026-02 | alpha.md |\n| Beta | Paused | 2026-01 | beta.md |\n\nTotal: 2 active, 5 archived\n\n\nIndices stay small (<100 entries). When full, split into subcategories.\n\n4. Write Immediately\n\nWhen user shares important information:\n\nWrite to appropriate file in ~/memory/\nUpdate the category INDEX.md\nThen respond\n\nDon't wait. Don't batch. Write immediately.\n\n5. Search Then Navigate\n\nTo find information:\n\nAsk first: \"Is this in ~/memory/ or built-in memory?\"\nSearch: grep or semantic search in ~/memory/\nNavigate: INDEX.md → category → specific file\n# Quick search\ngrep -r \"keyword\" ~/memory/\n\n# Navigate\ncat ~/memory/INDEX.md           # What categories exist?\ncat ~/memory/projects/INDEX.md  # What projects?\ncat ~/memory/projects/alpha.md  # Specific project\n\n6. Sync from Built-In (Optional)\n\nIf user wants certain info copied from built-in memory:\n\n~/memory/sync/\n├── preferences.md    # Synced from built-in\n└── decisions.md      # Synced from built-in\n\n\nSync is one-way: Built-in → this system. Never modify built-in.\n\n7. Scale by Splitting\n\nWhen a category grows large:\n\nINDEX.md > 100 entries → split into subcategories\nCreate sub-INDEX.md for each subcategory\nRoot INDEX.md points to subcategories\n~/memory/projects/\n├── INDEX.md           # \"See active/, archived/\"\n├── active/\n│   ├── INDEX.md       # 30 active projects\n│   └── ...\n└── archived/\n    ├── INDEX.md       # 200 archived projects\n    └── ...\n\nWhat to Store Here (vs Built-In)\nStore HERE (~/memory/)\tKeep in BUILT-IN\nDetailed project histories\tCurrent project status\nFull contact profiles\tKey contacts quick-ref\nAll decision reasoning\tRecent decisions\nDomain knowledge bases\tQuick facts\nCollections, inventories\t—\nAnything that grows large\tSummaries\n\nRule: Built-in for quick context. Here for depth and scale.\n\nFinding Things\nFor Small Memory (<50 files)\n# Grep is fast enough\ngrep -r \"keyword\" ~/memory/\n\nFor Large Memory (50+ files)\n\nNavigate via indices:\n\n1. ~/memory/INDEX.md → find category\n2. ~/memory/{category}/INDEX.md → find item\n3. ~/memory/{category}/{item}.md → read details\n\nFor Huge Memory (500+ files)\n\nUse semantic search if available, or hierarchical indices:\n\n~/memory/projects/INDEX.md → \"web projects in web/\"\n~/memory/projects/web/INDEX.md → \"alpha project\"\n~/memory/projects/web/alpha.md → details\n\nMaintenance\nWeekly (5 min)\nUpdate INDEX.md files if entries added\nArchive completed/inactive items\nMonthly (15 min)\nReview category sizes\nSplit large categories\nRemove outdated entries\nWhen Memory is Slow\nCheck INDEX.md sizes (keep <100 lines)\nSplit big categories into subcategories\nArchive old content\nCommon Traps\n\nModifying built-in memory → Never touch agent's MEMORY.md or workspace memory/. This system is parallel.\n\nNo indices → Without INDEX.md, finding things requires searching all files. Always maintain indices.\n\nOne giant category → 500 items in one folder is slow. Split into subcategories.\n\nSyncing everything → Don't copy all built-in memory. Only sync what needs organization here.\n\nWaiting to write → Write immediately when user shares info. Don't batch.\n\nSecurity & Privacy\n\nData location:\n\nAll data in ~/memory/ on user's machine\nNo external services required\nNo network requests\n\nThis skill does NOT:\n\nAccess built-in agent memory (only reads if syncing)\nSend data anywhere\nStore credentials (never store secrets in memory)\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\ndecide - Decision tracking patterns\nescalate - When to involve humans\nlearn - Adaptive learning\nFeedback\nIf useful: clawhub star memory\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/memory",
    "publisherUrl": "https://clawhub.ai/ivangdavila/memory",
    "owner": "ivangdavila",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/memory",
    "downloadUrl": "https://openagent3.xyz/downloads/memory",
    "agentUrl": "https://openagent3.xyz/skills/memory/agent",
    "manifestUrl": "https://openagent3.xyz/skills/memory/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/memory/agent.md"
  }
}