← 返回 Skills 市场
beyound87

Smart Agent Memory

作者 beyound87 · GitHub ↗ · v3.0.6 · MIT-0
cross-platform ⚠ suspicious
698
总下载
1
收藏
4
当前安装
14
版本数
在 OpenClaw 中安装
/install smart-agent-memory
功能描述
跨平台 Agent 长期记忆系统。分层上下文供给 + 温度模型 + Skill经验记忆 + 结构化存储 + 自动归档。三层存储:Markdown(人可读,QMD 可搜索)+ JSON(结构化)+ SQLite/FTS5(高性能全文搜索)。纯 Node.js 原生模块,零外部依赖。
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install smart-agent-memory
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /smart-agent-memory 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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跨平台。
元数据
Slug smart-agent-memory
版本 3.0.6
许可证 MIT-0
累计安装 4
当前安装数 4
历史版本数 14
常见问题

Smart Agent Memory 是什么?

跨平台 Agent 长期记忆系统。分层上下文供给 + 温度模型 + Skill经验记忆 + 结构化存储 + 自动归档。三层存储:Markdown(人可读,QMD 可搜索)+ JSON(结构化)+ SQLite/FTS5(高性能全文搜索)。纯 Node.js 原生模块,零外部依赖。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 698 次。

如何安装 Smart Agent Memory?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install smart-agent-memory」即可一键安装,无需额外配置。

Smart Agent Memory 是免费的吗?

是的,Smart Agent Memory 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Smart Agent Memory 支持哪些平台?

Smart Agent Memory 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Smart Agent Memory?

由 beyound87(@beyound87)开发并维护,当前版本 v3.0.6。

💬 留言讨论