← Back to Skills Marketplace
81
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install narrative-memory
Description
叙事记忆系统v2:捕捉生命中有意义的时刻,编织成连贯的个人叙事。三层过滤确保记忆精华,支持模式识别和决策反思。触发条件:里程碑事件、关键决策、价值判断、情感转折、首次体验、深度反思。
Usage Guidance
This skill appears to implement a local narrative-memory tool, but review and harden before trusting it with sensitive material: 1) Privacy mismatch — the docs claim 'local encrypted storage' and automatic desensitization but the shipped scripts write plaintext JSON files with no encryption or clear desensitization routine; do not feed sensitive PII until you confirm/implement encryption. 2) Packaging issues — package.json references bin/ files that are not present in the manifest; test the package in a sandboxed environment first. 3) Inspect and run tests locally (npm install in a sandbox, npm test, node scripts/test-basic.js) to see behavior and file locations. 4) If you will store sensitive memories, add encryption at write/read time or store the workspace on an encrypted volume, and limit access to the ~/.openclaw/workspace/.soul directory. 5) Consider running the skill in a disposable VM or container the first time and review any unexpectedly created files. If you want, I can point to the exact lines where plaintext writes occur and suggest code changes to add encryption/desensitization.
Capability Assessment
Purpose & Capability
Name/description match the code: CLI scripts detect signals, accumulate patterns, and write narrative records. Dependencies (NPM NLP libs) are reasonable for text analysis. Minor inconsistency: package.json declares a bin script (bin/soul_narrative.js) and includes bin/ in files, but the provided manifest does not include any bin/ file — packaging may be incomplete.
Instruction Scope
SKILL.md and references promise privacy features (sensitive-data desensitization, '本地加密存储,不上传云端') and user-access controls. The runtime code shown writes plaintext JSON files to ~/.openclaw/workspace/.soul (narratives.jsonl, accumulation-state.json, user-values.json, etc.) and I see no encryption or automated desensitization implementation in the provided scripts. The code will create and read files under the user's HOME and may persist sensitive content locally.
Install Mechanism
There is no install spec in the registry entry (instruction-only), but a package.json and package-lock.json are included. If a user runs npm install, many typical dependencies will be fetched (chalk, commander, date-fns, natural). These dependencies are reasonable for NLP/CLI, not obviously disproportionate. No external download URLs or obfuscated installers observed.
Credentials
The skill requires no environment variables or external credentials. It uses process.env.HOME (expected for locating user workspace). Requested config and files (user-values.json, daily_context.json) are consistent with the stated goal of personal memory capture.
Persistence & Privilege
The skill persists user data to disk in ~/.openclaw/workspace/.soul and will create files/directories in the user's HOME. Although always:false, the agent can invoke the skill autonomously; combined with persistent local storage and the mismatch about encryption, this raises privacy concerns. The skill does not modify other skills or system-wide settings in the shown code.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install narrative-memory - After installation, invoke the skill by name or use
/narrative-memory - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.6.0
- Removed the Chinese documentation file references/SKILL.zh.md.
- No changes to user functionality or features.
v0.5.0
- Introduces Narrative Memory 2.0: captures significant life moments and weaves them into a coherent narrative.
- Implements three-layer filtering to distill essential memories and support pattern recognition and decision reflection.
- Adds event triggers for milestones, key decisions, value judgments, emotional shifts, first experiences, and deep reflections.
- Provides new commands for adding memories, viewing timelines, and listing narrative entries.
- Supports integration with proactive-engine for automatic memory capture via signal processing.
v0.3.0
- 叙事记忆系统v2发布,支持三层过滤并提升记忆精华提取能力
- 增加模式识别与决策反思支持
- 新增信号处理模式,支持与proactive-engine集成自动捕获重要事件
- 明确了触发条件:里程碑、关键决策、价值判断、情感转折、首次体验、深度反思
- 优化命令行用法与说明示例
v0.4.0
Version 0.4.0
- 引入可执行脚本,实现自动化价值守护流程
- 支持实时检测用户边界(时间、精力、隐私、决策)
- 新增价值漂移量化评估与检测算法
- 实现渐进式四级干预决策,适应不同偏离情况
- 提供完善的安装指引与多种执行集成方式
v0.3.1
narrative-memory v0.3.1
- Added an updated and comprehensive SKILL.md with detailed usage, working principles, data structure, configuration, and integration instructions
- Clarified the 3-layer memory filtering mechanism and six key narrative triggers
- Expanded documentation for both CLI and proactive-engine collaborative use
- Provided clearer troubleshooting tips and installation guidance
- Included development, privacy, and contribution instructions for wider adoption and maintainability
v0.1.0
Initial release of the narrative-memory skill, focusing on capturing meaningful personal stories and experiences.
- Implements a three-layer memory filtering system to prioritize significant events and emotions.
- Introduces narrative memory creation for milestones, decisions, value judgments, emotional turning points, first-time experiences, and reflections.
- Supports a forgetting curve with adjustable importance and the ability to reinforce memories each time they're recalled.
- Integrates with other modules for memory strengthening and automated decay management.
Metadata
Frequently Asked Questions
What is Narrative Memory?
叙事记忆系统v2:捕捉生命中有意义的时刻,编织成连贯的个人叙事。三层过滤确保记忆精华,支持模式识别和决策反思。触发条件:里程碑事件、关键决策、价值判断、情感转折、首次体验、深度反思。 It is an AI Agent Skill for Claude Code / OpenClaw, with 81 downloads so far.
How do I install Narrative Memory?
Run "/install narrative-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Narrative Memory free?
Yes, Narrative Memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Narrative Memory support?
Narrative Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Narrative Memory?
It is built and maintained by Louis Z. (@zhaoguoqiang-hub); the current version is v0.6.0.
More Skills