← 返回 Skills 市场
ryancampbell

Agent Memory Kit

作者 ryancampbell · GitHub ↗ · v2.1.0
cross-platform ✓ 安全检测通过
1848
总下载
1
收藏
5
当前安装
1
版本数
在 OpenClaw 中安装
/install agent-memory-kit
功能描述
Provides a structured AI agent memory system separating episodic, semantic, and procedural memories to preserve knowledge and processes over time.
使用说明 (SKILL.md)

Agent Memory Kit

Type: Practice / Framework Dependencies: None (markdown only)


Description

A structured memory system for AI agents. Prevents the "forgot how to do things" problem by separating memory into episodic (what happened), semantic (what I know), and procedural (how to do things) layers.

Installation

# Create memory folder structure
mkdir -p memory/procedures

# Copy templates
cp templates/ARCHITECTURE.md memory/
cp templates/feedback.md memory/
cp templates/procedure-template.md memory/procedures/

Usage

  1. Read README.md to understand the system
  2. Add memory loading to your wake routine (AGENTS.md)
  3. Use templates when logging events, creating procedures, tracking feedback

Files

File Purpose
README.md Full documentation
templates/ARCHITECTURE.md Memory system overview (copy to memory/)
templates/feedback.md Success/failure tracking template
templates/procedure-template.md How-to document template
templates/daily-template.md Daily log template
templates/compaction-survival.md NEW: Pre-compaction flush guide
templates/context-snapshot-template.md NEW: Quick context save template
helpers/check-compaction.sh NEW: Token limit checker

Key Concepts

  • Episodic memory: Daily logs of WHAT happened
  • Semantic memory: Curated knowledge (MEMORY.md)
  • Procedural memory: HOW to do things
  • Feedback loops: Learn from success/failure

The Rule

Always capture the HOW, not just the WHAT. Future-you needs the steps.

安全使用建议
This kit is largely local markdown + shell helpers and appears coherent with its stated purpose. Before installing or running anything: 1) Inspect the two shipped shell scripts (lib/search.sh and helpers/check-compaction.sh) to ensure they do not call unexpected network endpoints or run arbitrary commands; 2) If you follow the README's git instructions, confirm the remote origin is trusted (the skill metadata says 'source: unknown' even though README points to a GitHub repo); 3) Adding the bin path to your shell rc will run this tool more conveniently but modify your shell startup — make that change manually so you can review it; 4) Avoid blindly running `git pull` inside the skill folder unless you trust the remote; consider cloning directly from an official repo URL you verify. If you want extra safety, run the CLI in a sandboxed environment or inspect the code fully before adding it to your PATH or your agent wake routines.
功能分析
Type: OpenClaw Skill Name: agent-memory-kit Version: 2.1.0 The OpenClaw AgentSkills bundle provides a memory management and search system for AI agents. It uses shell scripts (`lib/search.sh`, `helpers/check-compaction.sh`) to operate on local markdown files within the agent's workspace, employing standard Unix utilities like `grep`, `find`, and `jq` for its stated purpose. While the markdown files contain instructions for the agent (prompt injection) to modify its environment (e.g., `PATH`), integrate with its `AGENTS.md` and `HEARTBEAT.md`, and manage its memory files, these actions are transparently aligned with the benign goal of improving agent self-management and recall. There is no evidence of data exfiltration, malicious execution, persistence, or obfuscation beyond the skill's legitimate functionality.
能力评估
Purpose & Capability
The skill's name and SKILL.md describe a local memory system and search/recall CLI. The repo includes markdown templates and shell scripts (search implementation and a compaction checker), which are expected for a CLI-based search/tooling kit. Required env vars and binaries are none, which matches a mostly-markdown + shell implementation.
Instruction Scope
Runtime instructions are limited to copying templates into a local memory/ folder, adding the bin path to the shell PATH, and optionally running a local token-check script. That's within scope. One instruction (INSTALL-SEARCH.md) suggests running `git pull origin main` inside the skill directory — this can fetch remote code and is out-of-band relative to purely local template install; treat it as a remote update step to verify before executing.
Install Mechanism
There is no automated install spec — the skill is instruction-only. That lowers risk. The README suggests cloning from GitHub (a normal install path). No downloads from untrusted URLs or arbitrary extract operations are present in the provided docs.
Credentials
The skill declares no required environment variables, credentials, or config paths. The instructions ask only to copy templates and optionally add a local bin path to the user's shell config — permissions requested are proportional to the stated purpose.
Persistence & Privilege
The skill is not marked always:true and does not request elevated agent privileges. It does recommend adding its bin directory to your shell PATH and adding a wake-routine step (AGENTS.md) — these are user-controlled changes that increase the tool's convenience but require you to edit shell or agent routines. Be aware these edits change your shell startup behavior (not a platform-level privilege escalation).
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install agent-memory-kit
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /agent-memory-kit 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.1.0
- Added new templates: compaction survival guide and context snapshot template. - Introduced a token limit checker script. - Updated documentation to reflect new memory management tools. - Improved instructions for installation and usage of memory templates. - Clarified separation of episodic, semantic, and procedural memory layers.
元数据
Slug agent-memory-kit
版本 2.1.0
许可证
累计安装 5
当前安装数 5
历史版本数 1
常见问题

Agent Memory Kit 是什么?

Provides a structured AI agent memory system separating episodic, semantic, and procedural memories to preserve knowledge and processes over time. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1848 次。

如何安装 Agent Memory Kit?

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

Agent Memory Kit 是免费的吗?

是的,Agent Memory Kit 完全免费(开源免费),可自由下载、安装和使用。

Agent Memory Kit 支持哪些平台?

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

谁开发了 Agent Memory Kit?

由 ryancampbell(@ryancampbell)开发并维护,当前版本 v2.1.0。

💬 留言讨论