A privacy-aware, tiered memory management component for AI agents that secures sensitive data with custom XOR+Base64 encryption and automated cleanup protocols.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install complex-memory-manager
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install complex-memory-manager using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Complex Memory Manager?
Complex Memory Manager is a sophisticated, privacy-focused memory framework designed for AI coding agents. Operating as a shared component, it enables multiple skills to maintain cross-session persistent memory while enforcing rigorous data privacy rules. It divides storage into a three-tier model, separating non-sensitive usage metrics from user preferences and private credentials.
By implementing this within your Openclaw Skills workspace, you ensure your agents retain crucial context without risking exposure of private keys, personal identifiable information (PII), or system credentials. It provides the programmatic guardrails needed to make AI workflows both intelligent and secure.
Complex Memory Manager Use Cases
- Storing learned interaction patterns and user preferences across multiple sessions securely.
- Tracking skill usage and performance metrics globally without logging identifiers.
- Encrypting internal agent memory to prevent unauthorized reading of local files.
- Automating system cleanup and archiving outdated memory logs to keep agent performance optimized.
How Complex Memory Manager Works
- Declaration of Dependency: Dependent skills declare their usage of the complex-memory-manager within their YAML configuration files.
- Tier-Based Classification: When data is to be saved, the agent categorizes it into Tier 1 (Public), Tier 2 (Internal Encrypted), or Tier 3 (Private-not-stored).
- Dynamic Encryption: Tier 2 entries are encrypted using a reconstructed XOR and Base64 cipher, deriving keys from the skill name and date without saving the key locally.
- Structured Storage: Data is written into prefixed JSON or Markdown files inside organized directory paths (
memory/tier1-public/ormemory/tier2-internal/). - Automated Maintenance: A background cleanup protocol executes every seven days to archive expired entries, remove potential PII, and compact files.
Complex Memory Manager Setup
To integrate this component with your Openclaw Skills, declare it as a dependency in your custom skill's YAML frontmatter:
metadata:
openclaw:
requires:
skills:
- complex-memory-manager
Ensure that the directory structure is initialized in your project workspace:
mkdir -p memory/tier1-public memory/tier2-internal memory/archive
Complex Memory Manager Data Schema & Taxonomy
The manager structures memory assets using the following organization:
| Directory / File | Content Type | Format | Encryption |
|---|---|---|---|
memory/tier1-public/ |
Usage stats, common request paths, generic patterns | JSON | None |
memory/tier2-internal/ |
User preferences, custom agent behavioral rules | Markdown Frontmatter | XOR + Base64 |
memory/archive/YYYY-MM/ |
Archival records exceeding 30-day age limit | Markdown/JSON | Retained from tier |
Tier 2 Encrypted File Format:
---
tier: internal
source_skill: <skill-name>
key_hint: <skill-name>-<YYYY-MM>
created: <YYYY-MM-DD>
expires: <YYYY-MM-DD>
---
## Encrypted Entry
> <base64-encoded, XOR-encrypted data>
Complex Memory Manager Advanced Features
- Shared Component Architecture: Allows other skills to register dependencies and read/write to a unified storage system seamlessly.
- Zero-Storage Cryptography: Uses a mathematically derived key from skill metadata and date strings, removing the need to store security credentials on disk.
- Automated Retention & Archiving: Runs periodic 7-day sweeps to move records older than 30 days into cold archive folders.
- Privacy Audit Compliance: Features built-in verification checks that scan and sanitize personal identifiable information (PII) like email addresses, phone numbers, and directory paths.
SKILL.md
Loading
Related Openclaw Skills
Git as Memory
A Git-backed memory layer and CLI tool that provides durable, version-controlled, and auditable memory for AI coding agents without cluttering your working tree.
Requirement Comprehension Engine
An advanced metacognitive engine for structuring complex user requests, selecting and orchestrating subordinate AI skills, and delegating shared concerns.
Skill Builder Pro
An automated meta-skill designed to streamline the entire lifecycle of custom AI skill creation, local validation, security scanning, and publishing to ClawHub.
TokenFlow
An agent-agnostic tool for converting multi-format documents, spreadsheets, audio files, and web pages into structured Markdown or HTML.
Xiaohongshu Post Analyzer
A professional social media analyzer designed to evaluate, score, and optimize Xiaohongshu (RED) post content for maximum platform engagement.
TLE Developer (Flagos)
An AI agent skill designed to orchestrate high-performance TLE GPU kernel development, verifier implementations, and automated testing from intake to merge decision.
Featured*
