← Back to Skills Marketplace
6917
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 after reviewing the privacy and scripting risks. Avoid enabling cron or whole-history processing unless you explicitly want historical conversations summarized into persistent plaintext memory. Do not use this around secrets or sensitive personal data until the code-injection, prompt-injection, dashboard escaping, retention, permissions, approval, and deletion controls are fixed.
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
Credentials
The skill reads all JSONL session transcripts for the selected OpenClaw agent, writes plaintext intermediate and long-term memory files under the workspace, and generates a dashboard from memory and related brain-skill state without documented retention, deletion, filtering, or file-permission safeguards.
Install Mechanism
The manifest install path recommends running install.sh with cron, and the installer can add recurring encoding and decay cron jobs, chmod scripts, initialize memory files, generate dashboard output, and recommend automatic RAG loading; no remote payload retrieval was found.
Instruction Scope
The instructions disclose memory capture and recall, but raw transcript-derived signals are presented adjacent to agent instructions for summarization, creating a prompt-injection path into persistent memory; self-reflection prompts also encourage durable agent self-concept formation.
Persistence & Privilege
Persistence is central to the purpose, but it is high impact: cron jobs continue processing over time, HIPPOCAMPUS_CORE.md is intended for future context loading, unquoted heredocs allow Python code injection through parameters such as recall queries or thresholds, and dashboard content is rendered unsafely with innerHTML.
Purpose & Capability
The package coherently implements a persistent OpenClaw memory system, but it captures user, relationship, emotional, and agent-identity facts into long-lived memory and core context; the claimed default limit of the last 100 signals is not enforced by the encoding pipeline on a fresh install.
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 6917 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