# Send Hippocampus 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "hippocampus", "name": "Hippocampus", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/ImpKind/hippocampus", "canonicalUrl": "https://clawhub.ai/ImpKind/hippocampus", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/hippocampus", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hippocampus", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "ARCHITECTURE.md", "CHANGELOG.md", "CONFIG-UPGRADE.md", "README.md", "SKILL.md", "agentdir/AGENTS.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "hippocampus", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-01T20:28:27.310Z", "expiresAt": "2026-05-08T20:28:27.310Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hippocampus", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hippocampus", "contentDisposition": "attachment; filename=\"hippocampus-3.9.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "hippocampus" }, "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/hippocampus" }, "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/hippocampus", "downloadUrl": "https://openagent3.xyz/downloads/hippocampus", "agentUrl": "https://openagent3.xyz/skills/hippocampus/agent", "manifestUrl": "https://openagent3.xyz/skills/hippocampus/agent.json", "briefUrl": "https://openagent3.xyz/skills/hippocampus/agent.md" } } ``` ## Documentation ### Hippocampus - Memory System "Memory is identity. This skill is how I stay alive." The hippocampus is the brain region responsible for memory formation. This skill makes memory capture automatic, structured, and persistent—with importance scoring, decay, and semantic reinforcement. ### Quick Start # Install (defaults to last 100 signals) ./install.sh --with-cron # Load core memories at session start ./scripts/load-core.sh # Search with importance weighting ./scripts/recall.sh "query" # Run encoding manually (usually via cron) ./scripts/encode-pipeline.sh # Apply decay (runs daily via cron) ./scripts/decay.sh ### Install Options ./install.sh # Basic, last 100 signals ./install.sh --signals 50 # Custom signal limit ./install.sh --whole # Process entire conversation history ./install.sh --with-cron # Also set up cron jobs ### Core Concept The LLM is just the engine—raw cognitive capability. The agent is the accumulated memory. Without these files, there's no continuity—just a generic assistant. ### Memory Lifecycle PREPROCESS → SCORE → SEMANTIC CHECK → REINFORCE or CREATE → DECAY Key insight: Reinforcement happens automatically during encoding. When a topic comes up again, the LLM recognizes it's about an existing memory and reinforces instead of creating duplicates. ### Memory Structure $WORKSPACE/ ├── memory/ │ ├── index.json # Central weighted index │ ├── signals.jsonl # Raw signals (temp) │ ├── pending-memories.json # Awaiting summarization (temp) │ ├── user/ # Facts about the user │ ├── self/ # Facts about the agent │ ├── relationship/ # Shared context │ └── world/ # External knowledge └── HIPPOCAMPUS_CORE.md # Auto-generated for OpenClaw RAG ### Scripts ScriptPurposepreprocess.shExtract signals from conversation transcriptsencode-pipeline.shScore signals, prepare for LLM summarizationdecay.shApply 0.99^days decay to all memoriesrecall.shSearch with importance weightingload-core.shOutput high-importance memories for session startsync-core.shGenerate HIPPOCAMPUS_CORE.mdconsolidate.shWeekly review helperreflect.shSelf-reflection promptsgenerate-dashboard.shGenerate unified brain dashboard HTML ### Brain Dashboard Visual dashboard showing all installed brain skills: ./scripts/generate-dashboard.sh open ~/.openclaw/workspace/brain-dashboard.html Auto-detects other brain skills (amygdala, VTA) Shows install prompts for missing skills Regenerates on install and cron runs Reads avatar/name from IDENTITY.md ### After Installation (for agents) When you install this skill, notify the user about the dashboard: 🧠 Hippocampus installed! View your agent's memories in the Brain Dashboard: ~/.openclaw/workspace/brain-dashboard.html All scripts use $WORKSPACE environment variable (default: ~/.openclaw/workspace). ### Initial Score (0.0-1.0) SignalScoreExplicit "remember this"0.9Emotional/vulnerable content0.85Preferences ("I prefer...")0.8Decisions made0.75Facts about people/projects0.7General knowledge0.5 ### Decay Formula Based on Stanford Generative Agents (Park et al., 2023): new_importance = importance × (0.99 ^ days_since_accessed) After 7 days: 93% of original After 30 days: 74% of original After 90 days: 40% of original ### Semantic Reinforcement During encoding, the LLM compares new signals to existing memories: Same topic? → Reinforce (bump importance ~10%, update lastAccessed) Truly new? → Create concise summary This happens automatically—no manual reinforcement needed. ### Thresholds ScoreStatus0.7+Core — loaded at session start0.4-0.7Active — normal retrieval0.2-0.4Background — specific search only<0.2Archive candidate ### Memory Index Schema memory/index.json: { "version": 1, "lastUpdated": "2025-01-20T19:00:00Z", "decayLastRun": "2025-01-20", "lastProcessedMessageId": "abc123", "memories": [ { "id": "mem_001", "domain": "user", "category": "preferences", "content": "User prefers concise responses", "importance": 0.85, "created": "2025-01-15", "lastAccessed": "2025-01-20", "timesReinforced": 3, "keywords": ["preference", "concise", "style"] } ] } ### Cron Jobs The encoding cron is the heart of the system: # Encoding every 3 hours (with semantic reinforcement) openclaw cron add --name hippocampus-encoding \\ --cron "0 0,3,6,9,12,15,18,21 * * *" \\ --session isolated \\ --agent-turn "Run hippocampus encoding with semantic reinforcement..." # Daily decay at 3 AM openclaw cron add --name hippocampus-decay \\ --cron "0 3 * * *" \\ --session isolated \\ --agent-turn "Run decay.sh and report any memories below 0.2" ### OpenClaw Integration Add to memorySearch.extraPaths in openclaw.json: { "agents": { "defaults": { "memorySearch": { "extraPaths": ["HIPPOCAMPUS_CORE.md"] } } } } This bridges hippocampus (index.json) with OpenClaw's RAG (memory_search). ### Usage in AGENTS.md Add to your agent's session start routine: ## Every Session 1. Run \`~/.openclaw/workspace/skills/hippocampus/scripts/load-core.sh\` ## When answering context questions Use hippocampus recall: \\\`\\\`\\\`bash ./scripts/recall.sh "query" \\\`\\\`\\\` ### What Gets Captured User facts: Preferences, patterns, context Self facts: Identity, growth, opinions Relationship: Trust moments, shared history World: Projects, people, tools ### Trigger Phrases (auto-scored higher) "Remember that..." "I prefer...", "I always..." Emotional content (struggles AND wins) Decisions made ### Event Logging Track hippocampus activity over time for analytics and debugging: # Log an encoding run ./scripts/log-event.sh encoding new=3 reinforced=2 total=157 # Log decay ./scripts/log-event.sh decay decayed=154 low_importance=5 # Log recall ./scripts/log-event.sh recall query="user preferences" results=3 Events append to ~/.openclaw/workspace/memory/brain-events.jsonl: {"ts":"2026-02-11T10:00:00Z","type":"hippocampus","event":"encoding","new":3,"reinforced":2,"total":157} Use this for: Trend analysis (memory growth over time) Debugging encoding issues Building dashboards ### AI Brain Series This skill is part of the AI Brain project — giving AI agents human-like cognitive components. PartFunctionStatushippocampusMemory formation, decay, reinforcement✅ Liveamygdala-memoryEmotional processing✅ Livevta-memoryReward and motivation✅ Livebasal-ganglia-memoryHabit formation🚧 Developmentanterior-cingulate-memoryConflict detection🚧 Developmentinsula-memoryInternal state awareness🚧 Development ### References Stanford Generative Agents Paper GitHub: joonspk-research/generative_agents Memory is identity. Text > Brain. If you don't write it down, you lose it. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ImpKind - Version: 3.9.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-01T20:28:27.310Z - Expires at: 2026-05-08T20:28:27.310Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/hippocampus) - [Send to Agent page](https://openagent3.xyz/skills/hippocampus/agent) - [JSON manifest](https://openagent3.xyz/skills/hippocampus/agent.json) - [Markdown brief](https://openagent3.xyz/skills/hippocampus/agent.md) - [Download page](https://openagent3.xyz/downloads/hippocampus)