Memory Manager

Long-term memory management system for OpenClaw agents. Automatically archives conversations, organizes memories, and provides semantic search capabilities.

Security Scan

The skill mostly matches a local file-based memory manager, but its documentation overstates features (automatic saving, "semantic" search) and contains path inconsistencies — these mismatches warrant caution before installing.

Purpose & Capability

The name/description promise automatic conversation archiving and semantic search. The included code implements local file-based logging and simple keyword matching, not semantic (embedding/vector) search. The SKILL.md implies 'automatic' saving during agent operation, but the code exposes an API/class (MemoryManager) and CLI and does not provide an integration hook to automatically capture agent conversations. This is a meaningful feature mismatch.

Instruction Scope

SKILL.md claims automatic saving (auto_save: true) and integration-ready behavior but gives no concrete integration instructions or agent hook. The code will create and write files in a workspace path and read all *.md files in that directory for searches; those file I/O operations are within scope for a memory manager but SKILL.md is vague about when/how data is collected, which grants broad discretion to any agent code that uses the library.

Install Mechanism

No install spec; instruction-only plus a small Python file. Nothing is downloaded at install time and no executables are injected by an installer. Risk from install mechanism is low.

Credentials

The skill requests no credentials or env vars. However there is a documentation/code inconsistency: SKILL.md lists defaults like './memory/' and './MEMORY.md' while the MemoryManager default workspace in code is '/root/.openclaw/workspace', which causes the skill to read/write under that path by default. This is not a credential request but it changes where files are stored and may surprise users.

Persistence & Privilege

The skill is not always-enabled and does not request elevated privileges. It writes to its own workspace directory and does not modify other skills or system-wide settings. Autonomous invocation is allowed by platform default but not a separate concern here.

What to consider before installing

This package is a small, local file-based memory helper, but its docs overstate capabilities. Before installing or enabling it: 1) Note that 'semantic search' is not implemented — the search is simple keyword matching. 2) The README claims automatic saving, but the code provides a MemoryManager class you must call; there is no automatic agent hook. 3) The code defaults to /root/.openclaw/workspace (not the ./memory/ path shown in docs) and will create/append files there — update the workspace path or run in an isolated workspace if you don't want persistent files in that location. 4) Review the Python file yourself; it contains no network calls or secret access, but any skill that writes local files can store sensitive conversation contents. If you need true semantic search, ask the author for embedding/vector search integration or add it yourself; if you need automatic capture, require explicit agent integration hooks. Install in a test environment first and confirm behavior.

A robust long-term memory management system for OpenClaw agents that automatically archives conversations and enables intelligent memory retrieval.

Features

• 📝 Automatic Conversation Logging: Saves dialogues to daily memory files
• 🔍 Semantic Search: Retrieve relevant memories using natural language queries
• 📅 Time-based Organization: Memories organized by date (YYYY-MM-DD.md)
• 🗂️ Long-term Storage: Curated memories in MEMORY.md
• 🔗 Integration Ready: Works with existing agent workflows

Installation

clawhub install memory-manager

Usage

Automatic Mode

The skill automatically saves conversations during agent operation.

Manual Memory Search

from memory_manager import MemoryManager

mm = MemoryManager()
results = mm.search_memory("project discussions about KPI")

Daily Log Structure

memory/
├── 2026-03-07.md
├── 2026-03-06.md
└── ...

Configuration

Setting	Default	Description
memory_dir	./memory/	Daily memory files location
memory_file	./MEMORY.md	Long-term memory file
auto_save	true	Auto-save conversations

Requirements

• Python 3.8+
• OpenClaw workspace structure

License

MIT License - Contribute back to the community!