← Back to Skills Marketplace
6693
Downloads
24
Stars
0
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 OpenClaw conversations turned into long-term local memory. Review or disable cron before running it, avoid --whole or first-run backfills unless you accept historical transcript processing, add memory files to .gitignore, and periodically inspect or delete memory/index.json and HIPPOCAMPUS_CORE.md because they may contain sensitive personal context.
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
Persistent memory, decay, recall, and dashboard generation fit the stated purpose, but the capability includes reading OpenClaw session transcripts, storing user/self/relationship facts, and auto-loading high-importance memories into future context.
Instruction Scope
Runtime instructions authorize background or cron-driven processing, proactive recall, and persistent writes to memory files; some prompts also encourage agent identity and relationship memory beyond a neutral memory utility.
Install Mechanism
The recommended install path uses --with-cron and registers recurring jobs without an interactive confirmation. The installer records a default signal limit, but encode-pipeline.sh does not appear to use that limit, so a first run without a watermark can process all session files despite documentation saying it defaults to the last 100 signals.
Credentials
The skill stays local and I found no artifact-backed exfiltration endpoint, but reading all ~/.openclaw agent session JSONL files and aggregating other brain-skill files into a browser dashboard is broad for private conversation data.
Persistence & Privilege
It creates durable memory files, a generated HIPPOCAMPUS_CORE.md intended for future context injection, backups, and optional recurring OpenClaw cron jobs, with limited review, deletion, retention, or pause controls documented.
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 6693 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