← Back to Skills Marketplace
6207
Downloads
24
Stars
26
Active Installs
10
Versions
Install in OpenClaw
/install hippocampus-memory
Description
Persistent memory system for AI agents. Automatic encoding, decay, and semantic reinforcement — just like the hippocampus in your brain. Based on Stanford Generative Agents (Park et al., 2023).
Usage Guidance
Install only if you intentionally want long-lived agent memory built from your conversations. Prefer a manual non-cron setup first, avoid --whole unless you really want historical ingestion, inspect and periodically delete ~/.openclaw/workspace/memory/ and HIPPOCAMPUS_CORE.md, keep these files out of git, and enable cron or the silent background-agent mode only if you understand how to disable it.
Capability Analysis
Type: OpenClaw Skill
Name:
Developer:
Version:
Description: OpenClaw Agent Skill
Suspicious High-Entropy/Eval files: 10
The OpenClaw Hippocampus skill is designed to provide persistent memory for AI agents by processing conversation history. Its core functionality involves reading all session transcripts (`preprocess.sh`), storing and managing memories in `index.json` within the agent's workspace, and running cron jobs for encoding and decay. While accessing conversation history is a sensitive operation, it is fundamental to the skill's stated purpose. The instructions for the AI agent (found in `SKILL.md`, `install.sh`'s `--agent-turn` arguments, `summarize-pending.sh`, and `agents/hippocampus-agent.md`) are detailed but consistently focused on memory management tasks, without any evidence of intentional harmful behavior, data exfiltration to external endpoints, or unauthorized system manipulation. All observed capabilities, including file access and agent instructions, are plausibly and transparently aligned with the benign objective of building an AI memory system.
Capability Assessment
Purpose & Capability
The scripts and prompts coherently implement persistent agent memory: transcript preprocessing, scoring, summarization, decay, recall, dashboard generation, and OpenClaw memory integration. I found no artifact evidence of credential theft, destructive behavior, or external exfiltration.
Instruction Scope
The scope is broad: preprocess.sh scans OpenClaw session transcripts across session files, relationship prompts prioritize vulnerable or emotional disclosures, and core memories are written into files that can be reused in future sessions. The artifacts disclose this behavior, but they do not provide strong consent, redaction, exclusion, or retention controls.
Install Mechanism
Installation is manual and local, creates memory directories and index files, makes scripts executable, and can optionally add OpenClaw cron jobs. The recommended install command includes --with-cron, which is purpose-aligned but should be treated as enabling recurring automation.
Credentials
For a memory system, reading conversation history and writing memory files is expected, but the implementation can ingest broad private conversation history and sensitive relationship/emotional content into persistent workspace files and HIPPOCAMPUS_CORE.md without clear data minimization safeguards.
Persistence & Privilege
The skill supports scheduled cron processing and documents a silent background-agent configuration that monitors the main session and updates memory files. This is aligned with the stated memory purpose, but it is high-impact persistence with limited visible user control.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install hippocampus-memory - After installation, invoke the skill by name or use
/hippocampus-memory - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.8.6
- Skill name updated to "hippocampus-memory" and title clarified.
- Description rewritten for clarity and conciseness.
- Metadata version bumped to 3.8.6.
- Documentation restructured for easier reading; headings clarified and formatting improved.
- No changes to scripts, features, or usage—documentation improvements only.
v3.8.5
- Renamed skill from "hippocampus-memory" to "hippocampus" and simplified the title and description.
- Updated `metadata.openclaw.version` from 3.8.3 to 3.8.4.
- Clarified that the skill runs separately from the main agent.
- Minor streamlining and restructuring throughout documentation for clarity and conciseness.
- No functional or implementation changes—documentation update only.
v3.8.3
v3.8.3 - Multi-session memory support
- FIXED: preprocess.sh now scans ALL session files (not just one)
- NEW: Datetime watermark (lastProcessedTimestamp) for cross-session tracking
- NEW: CHANGELOG.md added
- Renamed to "Hippocampus - Memory System" for better discoverability
v3.7.3
Fix: Dashboard generator was using wrong variable for amygdala data (HIPPOCAMPUS_FILE defined twice, second line overwrote first)
Fix: Removed hardcoded Europe/Warsaw timezone from consolidation-guide.md
v3.7.2
- Fixed the skill version number in metadata (now matches release version 3.7.2).
- No other user-facing changes.
v3.8.0
- Adds scripts/generate-dashboard.sh to generate a unified brain dashboard (HTML) for all installed brain skills.
- Introduces a "Brain Dashboard" feature showcasing memory and cognitive skills, with auto-detection of related skills and install guidance for missing ones.
- Dashboard reads avatar and name from IDENTITY.md and is regenerated during install and cron runs.
- Updated documentation to describe the new dashboard and include notification instructions for agents after installation.
v3.7.0
- Adds semantic encoding pipeline: new memories are scored, checked for duplication, and either reinforced or summarized using LLM.
- Replaces manual `reinforce.sh` with automatic semantic reinforcement during encoding (no more manual boosts).
- Updates and expands available scripts: adds `encode-pipeline.sh`, removes `reinforce.sh` and duplicate checking scripts.
- Introduces new install options for controlling signal processing and enables whole-history encoding.
- Shifts cron workflow: encoding now runs periodically with reinforcement logic; decay and consolidation remain scheduled.
- Improves documentation—clarifies memory lifecycle, file structure, and agent integration for OpenClaw.
v3.1.3
- Added prompt for encoding memory signals (`prompts/encode-signals.md`)
- Added duplicate memory checker script (`scripts/check-duplicate.py`)
- Updated documentation to introduce the "AI Brain Series" section and list related skills
- Bumped version to 3.4.0
v3.1.2
Docs: Explain background processing concept
v3.1.1
Memory system with importance scoring, decay, reinforcement
Metadata
Frequently Asked Questions
What is Hippocampus?
Persistent memory system for AI agents. Automatic encoding, decay, and semantic reinforcement — just like the hippocampus in your brain. Based on Stanford Generative Agents (Park et al., 2023). It is an AI Agent Skill for Claude Code / OpenClaw, with 6207 downloads so far.
How do I install Hippocampus?
Run "/install hippocampus-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Hippocampus free?
Yes, Hippocampus is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Hippocampus support?
Hippocampus is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Hippocampus?
It is built and maintained by ImpKind (@impkind); the current version is v3.8.6.
More Skills