← Back to Skills Marketplace
698
Downloads
1
Stars
4
Active Installs
14
Versions
Install in OpenClaw
/install smart-agent-memory
Description
跨平台 Agent 长期记忆系统。分层上下文供给 + 温度模型 + Skill经验记忆 + 结构化存储 + 自动归档。三层存储:Markdown(人可读,QMD 可搜索)+ JSON(结构化)+ SQLite/FTS5(高性能全文搜索)。纯 Node.js 原生模块,零外部依赖。
Usage Guidance
What to check before installing:
- Understand and accept that this skill will write to and modify your home workspace paths (default: ~/.openclaw/workspace/memory) and — during setup — will scan and inject BOOTSTRAP.md into every ~/.openclaw/workspace* it finds. If you have private or sensitive projects in those workspaces, back them up first.
- The CLI can create or append Markdown and JSON/SQLite files, archive old logs, and can auto-generate SKILL.md templates from lessons (i.e., it can create skill-like files). Decide whether you want a skill that can produce new skill artifacts or alter workspace content.
- There is a metadata inconsistency: the SKILL.md advertises explicit read/write permissions but the registry metadata lists no required config paths. Confirm which is authoritative and whether you are comfortable granting those filesystem permissions.
- The code may call an external binary 'qmd' if present (for hybrid search). If you do not want that binary invoked, ensure it's absent from PATH or review/modify lib/search.js.
- If you plan to use it across multiple agents or teams, set governance/ownership rules for the shared memory directory to avoid noisy writes or accidental leaks across agents.
- To minimize risk: run setup manually and inspect what files it writes (or run in an isolated test account/sandbox), review the memory-cli.js extract and setup implementations, and consider restricting MEMORY_DIR to a dedicated directory (set MEMORY_DIR env) before running setup.
Given these intrusive but explainable capabilities (workspace-wide injection and skill extraction), the skill is coherent with its stated purpose but contains behaviors that could be surprising or risky; treat it as 'suspicious' until you verify and constrain its actions.
Capability Analysis
Type: OpenClaw Skill
Name: smart-agent-memory
Version: 3.0.6
The bundle implements a sophisticated long-term memory system for OpenClaw agents using SQLite and Markdown. While the 'setup' command in 'scripts/memory-cli.js' performs an intrusive action by automatically injecting bootstrap instructions into all discovered workspaces (~/.openclaw/workspace*), this behavior is transparently documented as a requirement for session continuity. The 'extract' utility in 'lib/extract.js' generates new skill templates from 'lessons' with a 'trust: low' metadata setting, demonstrating security awareness regarding generated content. No evidence of data exfiltration, unauthorized network communication, or obfuscation was found; all file operations are confined to the expected OpenClaw directory structure.
Capability Assessment
Purpose & Capability
The name/description describe a local, Node.js-based long-term memory system and the included code implements that: search, JSON/SQLite stores, Markdown logs, GC, temperature model, and a CLI. Declared runtime requirement (node) aligns. However, SKILL.md advertises explicit read/write permissions for ~/.openclaw/workspace/memory while the registry metadata in the manifest lists no required config paths — a mismatch. Also the CLI's setup scans and modifies all ~/.openclaw/workspace* workspaces (injecting BOOTSTRAP.md), which is more intrusive than a simple single-directory memory helper and should be expected only if the skill truly needs to touch multiple workspaces.
Instruction Scope
Runtime instructions explicitly tell the agent to run a one-time setup that 'automatically discover(s) ~/.openclaw/workspace* and inject BOOTSTRAP.md' into each workspace, plus recommended cron jobs that cause regular autonomous runs of reflect/gc. The code also supports extracting lessons into SKILL.md templates (lib/extract.js) — i.e., generating skill files. These behaviors write to and modify multiple workspace paths and can create skill-like artifacts; they go beyond read-only memory lookup and could unexpectedly modify project/skill directories. The SKILL.md also claims a platform-level 'memory_search' automatic recall integration — verify that this is actually provided by your platform and not an assumption.
Install Mechanism
There is no remote install step (instruction-only plus included JS files), so nothing is downloaded at install time. That reduces remote-code-fetch risk. The code does execFileSync('qmd' ...) when qmd is present (lib/search.js) — qmd is optional but this launches an external binary if available; SKILL.md did not list qmd as a required binary, so the search may call an external tool unpredictably if present on PATH.
Credentials
The skill requests no credentials or environment secrets and only needs Node and filesystem access. That is consistent with a local memory store. However, SKILL.md metadata declares 'trust: high' and explicit read/write permissions for ~/.openclaw/workspace/memory; the registry metadata did not declare required config paths — this mismatch should be resolved. The code uses MEMORY_DIR env var as an override, which is reasonable and not a secret, but the default places data under ~/.openclaw/workspace/memory and modifies workspace directories.
Persistence & Privilege
always:false (no forced global enable) and autonomous invocation is not disabled (normal). The real concern is the skill's ability to modify multiple workspaces during setup (inject BOOTSTRAP.md), archive/move files under .archive, append files to daily logs and skills directories, and potentially write SKILL.md files via extraction. Those are persistent, write-capable operations that alter agent/ workspace state and could change what agents see or what skills exist. This elevated filesystem write capability is coherent with a memory tool but is a meaningful privilege that should be reviewed and limited if undesired.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install smart-agent-memory - After installation, invoke the skill by name or use
/smart-agent-memory - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.6
smart-agent-memory v3.0.6
- No file changes detected in this release.
- Version and documentation remain the same as v2.1.0.
- No new features, bug fixes, or updates included.
- Safe to skip upgrade if already running v2.1.0.
v3.0.5
Version 3.0.5
- Documentation updated: Added section on multi-agent dispatch memory, including best practices and key experience notes for spawn and subagent modes in the SKILL.md file.
- No code or feature changes; this update only modifies documentation for enhanced multi-agent usage clarity.
v3.0.1
smart-agent-memory 3.0.1
- Updated documentation (README.md) with no changes to skill code or functionality.
- No impact to usage, interfaces, or behavior.
v3.0.0
smart-agent-memory v3.0.0
- Documentation updated for v3.0.0.
- Added explanation for single agent and multi-agent memory workspace sharing in setup instructions (SKILL.md).
- No CLI/API or core feature changes in the skill itself; all changes are in documentation.
v2.5.0
smart-agent-memory v2.5.0
- Updated documentation in README.md.
- No code or feature changes; documentation only.
v2.4.4
No file changes detected for version 2.4.4.
- This release does not include any code or documentation updates.
- No user or developer action required.
v2.4.3
No file changes detected in this release.
- Version bumped from 2.1.0 to 2.4.3 with no functional or documentation changes.
- No updates to code or documentation files.
v2.4.2
- Expanded and clarified the "Setup / Config / Scripts" section in SKILL.md.
- Added explicit "Setup" instructions and details for multi-workspace scenarios.
- Improved documentation structure by grouping setup, session lifecycle, and script usage for easier onboarding.
- No code or functionality changes. Documentation update only.
v2.0.5
v2.0: 融合agent-memory-system+agent-memory。双层存储(Markdown+JSON/SQLite),温度模型,自动归档,知识提炼,FTS5搜索,14个CLI命令,纯Node.js跨平台。
v2.0.4
v2.0: 融合agent-memory-system+agent-memory。双层存储(Markdown+JSON/SQLite),温度模型,自动归档,知识提炼,FTS5搜索,14个CLI命令,纯Node.js跨平台。
v2.0.0
全自动化,修复大量Bug
v1.0.2
v1.0: 融合agent-memory-system+agent-memory。双层存储(Markdown+JSON/SQLite),温度模型,自动归档,知识提炼,FTS5搜索,14个CLI命令,纯Node.js跨平台。
v1.0.1
v1.0: 融合agent-memory-system+agent-memory。双层存储(Markdown+JSON/SQLite),温度模型,自动归档,知识提炼,FTS5搜索,14个CLI命令,纯Node.js跨平台。
v1.0.0
v1.0: 融合agent-memory-system+agent-memory。双层存储(Markdown+JSON/SQLite),温度模型,自动归档,知识提炼,FTS5搜索,14个CLI命令,纯Node.js跨平台。
Metadata
Frequently Asked Questions
What is Smart Agent Memory?
跨平台 Agent 长期记忆系统。分层上下文供给 + 温度模型 + Skill经验记忆 + 结构化存储 + 自动归档。三层存储:Markdown(人可读,QMD 可搜索)+ JSON(结构化)+ SQLite/FTS5(高性能全文搜索)。纯 Node.js 原生模块,零外部依赖。 It is an AI Agent Skill for Claude Code / OpenClaw, with 698 downloads so far.
How do I install Smart Agent Memory?
Run "/install smart-agent-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Smart Agent Memory free?
Yes, Smart Agent Memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Smart Agent Memory support?
Smart Agent Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Smart Agent Memory?
It is built and maintained by beyound87 (@beyound87); the current version is v3.0.6.
More Skills