# Send Enhanced 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": "openclaw-enhanced-memory", "name": "Enhanced Memory", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/fatcatMaoFei/openclaw-enhanced-memory", "canonicalUrl": "https://clawhub.ai/fatcatMaoFei/openclaw-enhanced-memory", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/openclaw-enhanced-memory", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-enhanced-memory", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/architecture.md", "scripts/memory_lifecycle_manager.py", "scripts/memory_retrieval_strategy.py", "scripts/memory_tag_search.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "openclaw-enhanced-memory", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-01T09:27:21.984Z", "expiresAt": "2026-05-08T09:27:21.984Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-enhanced-memory", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-enhanced-memory", "contentDisposition": "attachment; filename=\"openclaw-enhanced-memory-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "openclaw-enhanced-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/openclaw-enhanced-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/openclaw-enhanced-memory", "downloadUrl": "https://openagent3.xyz/downloads/openclaw-enhanced-memory", "agentUrl": "https://openagent3.xyz/skills/openclaw-enhanced-memory/agent", "manifestUrl": "https://openagent3.xyz/skills/openclaw-enhanced-memory/agent.json", "briefUrl": "https://openagent3.xyz/skills/openclaw-enhanced-memory/agent.md" } } ``` ## Documentation ### Enhanced Memory A structured memory system that gives your OpenClaw agent organized, searchable, long-lived memory instead of a single monolithic MEMORY.md. ### Why? The default MEMORY.md approach hits a wall fast: One file grows endlessly → slow to read, expensive on tokens No categorization → food logs mixed with project notes mixed with relationship context No retrieval strategy → agent re-reads everything or misses what matters No lifecycle → old entries clutter active memory forever Tagged Memory fixes all of this. ### 1. Hierarchical Directory Organization Memories are stored in purpose-built directories: memory/ ├── current/ # Active memories (last 6 months) ├── archived/ # Auto-archived older memories (permanent, never deleted) │ └── YYYY-MM/ # Organized by month ├── RELATION/ # One file per person (relationship context) ├── food/ # Meal and food logs ├── training/ # Exercise and workout records ├── connections.md # Global relationship graph ├── system/ # System config and logs └── misc/ # Everything else ### 2. Tag-Based Indexing Tag any line in any memory file with [category:value] markers: ## 2026-02-20 - Had lunch with Zhang Hao [人物:张浩东] [类型:聚餐] [地点:campus] - Discussed the new project deadline [项目:openclaw] [类型:会议] - Yoyo learned a new trick today [宠物:悠悠] [类型:milestone] Tags support multi-tag AND search — find the exact memory you need: # Single tag search python3 scripts/memory_tag_search.py "人物:张浩东" # Multi-tag AND search (all tags must match) python3 scripts/memory_tag_search.py "人物:王隆哲" "类型:开票信息" # List all tags in the system python3 scripts/memory_tag_search.py --list-tags # List tags under a specific category python3 scripts/memory_tag_search.py --list-tags --category 人物 ### 3. Lifecycle Management Memories age gracefully — never lost, always accessible: AgeLocationStatus0–6 monthsmemory/current/Active, auto-retrieved6–12 monthsmemory/archived/YYYY-MM/Archived, searchable on demand12+ monthsmemory/archived/Permanent archive, manual query Run the lifecycle manager manually or via cron: # Default: archive memories older than 6 months python3 scripts/memory_lifecycle_manager.py # Custom threshold (e.g., 90 days) python3 scripts/memory_lifecycle_manager.py 90 ### 4. Smart Cross-Category Retrieval The retrieval strategy script auto-classifies queries and searches the right directories: python3 scripts/memory_retrieval_strategy.py "What did I eat yesterday?" # → Searches memory/food/ + memory/current/ python3 scripts/memory_retrieval_strategy.py "How is Yoyo doing?" # → Searches memory/RELATION/悠悠.md + memory/connections.md python3 scripts/memory_retrieval_strategy.py "Yang Lingxiao" # → Searches memory/RELATION/ + memory/connections.md Query type detection covers: food, training, relationships, pets, system, mood, projects, and more. ### Scripts ScriptPurposescripts/memory_tag_search.pyTag-based indexing and search (single/multi-tag AND queries, tag listing)scripts/memory_retrieval_strategy.pySmart retrieval — auto-classifies queries and routes to relevant memory directoriesscripts/memory_lifecycle_manager.pyAutomatic archival of old memories (configurable threshold, never deletes) ### AGENTS.md Add the following to your AGENTS.md memory section: ## Memory ### Directory Structure - \`memory/current/\` — active memories (6 months) - \`memory/archived/\` — permanent archive - \`memory/RELATION/\` — per-person relationship files - \`memory/food/\` — meal logs - \`memory/training/\` — workout logs ### Retrieval Strategy - Exact queries (names, dates, codes) → \`grep\` the file system - Fuzzy/semantic queries → \`python3 scripts/memory_retrieval_strategy.py ""\` - Tag search → \`python3 scripts/memory_tag_search.py ":"\` ### Tagging Convention When writing memory entries, tag important lines: [人物:name] [类型:type] [地点:place] [项目:project] [情绪:mood] ### HEARTBEAT.md Add periodic memory maintenance to your heartbeat checklist: ## Memory Maintenance (every few days) - [ ] Run \`python3 scripts/memory_lifecycle_manager.py\` to archive old memories - [ ] Run \`python3 scripts/memory_tag_search.py --list-tags\` to review tag health - [ ] Check \`memory/current/\` file count — if growing large, verify archival is running ### Cron (optional) Set up monthly auto-archival: # Run on the 1st of every month at 03:00 0 3 1 * * cd /path/to/workspace && python3 scripts/memory_lifecycle_manager.py ### Customization Archive threshold: Edit ARCHIVE_THRESHOLD_DAYS in memory_lifecycle_manager.py (default: 180 days) Query patterns: Add new regex patterns to QUERY_TYPES in memory_retrieval_strategy.py Memory directories: Add new modules to MODULES_TO_ARCHIVE in memory_lifecycle_manager.py Tag categories: Tags are freeform — just use [category:value] in any .md file ### Requirements Python 3.8+ No external dependencies (stdlib only) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: fatcatMaoFei - 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-01T09:27:21.984Z - Expires at: 2026-05-08T09:27:21.984Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/openclaw-enhanced-memory) - [Send to Agent page](https://openagent3.xyz/skills/openclaw-enhanced-memory/agent) - [JSON manifest](https://openagent3.xyz/skills/openclaw-enhanced-memory/agent.json) - [Markdown brief](https://openagent3.xyz/skills/openclaw-enhanced-memory/agent.md) - [Download page](https://openagent3.xyz/downloads/openclaw-enhanced-memory)