← Back to Skills Marketplace
braibaud

Memento

by Benjamin RAIBAUD · GitHub ↗ · v0.6.0
cross-platform ⚠ suspicious
845
Downloads
0
Stars
1
Active Installs
9
Versions
Install in OpenClaw
/install memento
Description
Local persistent memory for OpenClaw agents. Captures conversations, extracts structured facts via LLM, and auto-recalls relevant knowledge before each turn....
Usage Guidance
What to consider before installing: - Defaults are privacy-first, but extraction that sends text to cloud LLMs is opt-in (extraction.autoExtract defaults to false). Keep autoExtract off if you do not want any conversation text sent to external providers. - If you want fully air-gapped operation, run a local Ollama model and configure extractionModel to an ollama/* model; no cloud API key needed. - Migration is powerful: the migrate tooling can read workspace files specified in ~/.engram/migration-config.json or via MEMENTO_WORKSPACE_MAIN. Only run migration if you trust the configured paths and have reviewed which files will be ingested (these can include large or sensitive local files). - Data is stored at ~/.engram/conversations.sqlite and ~/.engram/segments/*.jsonl — inspect, back up, or encrypt these files if needed. - The plugin delegates model routing to OpenClaw when run inside the platform and may use platform tokens (CLAUDE_CODE_OAUTH_TOKEN) for routing; verify your OpenClaw auth policy if you want to limit which models/providers are used. - The install is via npm (@openclaw/memento). As with any third-party package, consider reviewing the package source or installing in a sandbox before granting it access to production workspaces. Confidence note: High — the repository, SKILL.md, and changelog are internally consistent. The main risks are user-configured behaviors (enabling autoExtract or running migration) rather than silent or unexpected access.
Capability Analysis
Type: OpenClaw Skill Name: memento Version: 0.6.0 The OpenClaw Memento plugin is designed for local, privacy-first memory management, but exhibits 'suspicious' characteristics due to its broad local filesystem scanning and inherent risks of sending data to external LLMs. The `src/cli/deep-consolidate.ts` script broadly scans `homedir()` for agent databases in `~/.openclaw/workspace-*/` and `~/*/` (non-dot directories), which, while intended for legitimate discovery, represents a wide scope of local file access. Additionally, while transparent and opt-in, the plugin's core functionality in `src/extraction/extractor.ts` and `src/consolidation/relation-sweep.ts` involves sending conversation segments or fact summaries to external cloud LLM providers (e.g., Anthropic, OpenAI) if configured, which inherently carries data exfiltration risks, even with explicit privacy safeguards like `secret` fact filtering in `src/extraction/classifier.ts` and `relation-sweep.ts`. These capabilities, while plausibly aligned with the stated purpose, introduce high-risk behaviors that warrant a 'suspicious' classification rather than 'benign' due to the potential for misuse or unintended data exposure.
Capability Assessment
Purpose & Capability
Name/description (local persistent memory + LLM extraction) match the code, data paths (~/.engram/conversations.sqlite and JSONL backups), optional LLM API keys, and an npm install. No unrelated credentials, binaries, or unexpected system paths are required.
Instruction Scope
Runtime instructions and SKILL.md are explicit about behavior: capture every conversation, store locally, and only send text to an external LLM when `autoExtract` (opt-in) is enabled. Migration tooling can read user workspaces (via a user-provided migration-config.json or MEMENTO_WORKSPACE_MAIN) to bootstrap the KB — this is powerful and documented, but it means large local files (including potential secrets) can be ingested if the user opts into migration. The docs warn about cloud LLM leakage and recommend local Ollama for air-gapped operation.
Install Mechanism
Install uses an npm package (@openclaw/memento). That is proportionate for a TypeScript/Node plugin. Package files (package.json, package-lock.json, source files) are present; no arbitrary external download URLs or opaque extract steps are declared in SKILL.md.
Credentials
No required env vars; optional env vars map directly to supported LLM providers (ANTHROPIC_API_KEY, OPENAI_API_KEY, MISTRAL_API_KEY, MEMENTO_API_KEY) and migration settings. CLAUDE_CODE_OAUTH_TOKEN is listed as an OpenClaw internal token that may be auto-used when running inside OpenClaw — this is expected for a plugin that delegates model routing to the host, but users should know platform-level tokens may be consulted when Memento runs inside OpenClaw.
Persistence & Privilege
always:false and user-invocable:true. The plugin stores data locally and registers capture/recall hooks (normal for a memory plugin). It does not demand always-on inclusion or system-wide config changes beyond its own data files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install memento
  3. After installation, invoke the skill by name or use /memento
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.6.0
v0.6.0: Phase 1/2/3 pipeline redesign — history-agnostic extraction (prompt in .md file), embedding-based deduplication (cosine similarity replaces LLM hints), Phase 3 relation sweep background job (auto-builds knowledge graph edges). Secret facts excluded from all LLM operations.
v0.5.2
fix: trigger.ts now correctly passes openClawConfig to extractFacts(), ensuring OpenClaw model routing is used on every auto-extraction (was silently bypassed since v0.5.0)
v0.5.1
causality edges, query planning, temporal transitions
v0.5.0
Use OpenClaw model routing for extraction. Inherits agent model config, fallbacks, auth. No standalone API keys needed.
v0.3.2
Fix registry metadata: flat env var list, install spec, declared config paths and data storage locations
v0.3.1
Trust fixes: honest privacy messaging, declared env vars, opt-in extraction (autoExtract defaults false), cleaned stale deps
v0.3.0
Provider-agnostic model support: Anthropic, OpenAI, Mistral, Ollama. Removed credential snooping. Environment-based auth only.
v0.2.1
Initial public release — conversation capture, LLM extraction, auto-recall, cross-agent KB, privacy controls
v0.2.0
Initial public release
Metadata
Slug memento
Version 0.6.0
License
All-time Installs 1
Active Installs 1
Total Versions 9
Frequently Asked Questions

What is Memento?

Local persistent memory for OpenClaw agents. Captures conversations, extracts structured facts via LLM, and auto-recalls relevant knowledge before each turn.... It is an AI Agent Skill for Claude Code / OpenClaw, with 845 downloads so far.

How do I install Memento?

Run "/install memento" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Memento free?

Yes, Memento is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Memento support?

Memento is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Memento?

It is built and maintained by Benjamin RAIBAUD (@braibaud); the current version is v0.6.0.

💬 Comments