← 返回 Skills 市场
Memento
作者
Benjamin RAIBAUD
· GitHub ↗
· v0.6.0
845
总下载
0
收藏
1
当前安装
9
版本数
在 OpenClaw 中安装
/install memento
功能描述
Local persistent memory for OpenClaw agents. Captures conversations, extracts structured facts via LLM, and auto-recalls relevant knowledge before each turn....
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install memento - 安装完成后,直接呼叫该 Skill 的名称或使用
/memento触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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
元数据
常见问题
Memento 是什么?
Local persistent memory for OpenClaw agents. Captures conversations, extracts structured facts via LLM, and auto-recalls relevant knowledge before each turn.... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 845 次。
如何安装 Memento?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install memento」即可一键安装,无需额外配置。
Memento 是免费的吗?
是的,Memento 完全免费(开源免费),可自由下载、安装和使用。
Memento 支持哪些平台?
Memento 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Memento?
由 Benjamin RAIBAUD(@braibaud)开发并维护,当前版本 v0.6.0。
推荐 Skills