← Back to Skills Marketplace
penglovemeng

agent-memory

by penglovemeng · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
335
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install peng-agent-memory
Description
Provides persistent memory for AI agents to remember facts, learn from experience, and track entities across sessions.
README (SKILL.md)

AgentMemory Skill

Persistent memory system for AI agents. Remember facts, learn from experience, and track entities across sessions.

Installation

clawdhub install agent-memory

Usage

from src.memory import AgentMemory

mem = AgentMemory()

# Remember facts
mem.remember("Important information", tags=["category"])

# Learn from experience
mem.learn(
    action="What was done",
    context="situation",
    outcome="positive",  # or "negative"
    insight="What was learned"
)

# Recall memories
facts = mem.recall("search query")
lessons = mem.get_lessons(context="topic")

# Track entities
mem.track_entity("Name", "person", {"role": "engineer"})

When to Use

  • Starting a session: Load relevant context from memory
  • After conversations: Store important facts
  • After failures: Record lessons learned
  • Meeting new people/projects: Track as entities

Integration with Clawdbot

Add to your AGENTS.md or HEARTBEAT.md:

## Memory Protocol

On session start:
1. Load recent lessons: `mem.get_lessons(limit=5)`
2. Check entity context for current task
3. Recall relevant facts

On session end:
1. Extract durable facts from conversation
2. Record any lessons learned
3. Update entity information

Database Location

Default: ~/.agent-memory/memory.db

Custom: AgentMemory(db_path="/path/to/memory.db")

Usage Guidance
This skill appears to be what it says: a local SQLite-based memory for agents. Before installing, note: (1) it creates/writes a DB in ~/.agent-memory/memory.db by default — review and protect that file (file permissions, backups, encryption) if it will store sensitive info; (2) you can set db_path to any path — do not point it at system-critical files (e.g., /etc/passwd) or shared secrets; (3) the code does not perform network calls or request credentials, but any agent that uses this memory could export or transmit memories elsewhere — treat stored memories as data that your agents might surface; (4) there are minor code/quality issues (e.g., API surface hints in __init__ referencing get_memory) that are functional concerns but not indicators of malicious behavior. If you need stricter isolation, run the skill under a restricted user or in a container and review the DB contents regularly.
Capability Analysis
Type: OpenClaw Skill Name: peng-agent-memory Version: 1.0.0 The peng-agent-memory skill is a legitimate implementation of a persistent memory system for AI agents using a local SQLite database. The code in src/memory.py and the CLI wrappers provide standard CRUD operations for facts, lessons, and entities without any external dependencies, network calls, or suspicious execution patterns. The instructions in SKILL.md are appropriately scoped to managing agent context and do not contain any prompt-injection attacks or attempts to exfiltrate sensitive data.
Capability Assessment
Purpose & Capability
Name/description (persistent memory, facts, lessons, entities) matches the provided code and SKILL.md. No unrelated binaries, cloud credentials, or external services are required.
Instruction Scope
SKILL.md and the CLI wrappers confine operations to storing/recalling/updating local memories and integrating with an agent lifecycle. There are no instructions to read unrelated system files, transmit data externally, or access secrets.
Install Mechanism
No install spec — code is bundled in the skill and has no external dependencies. That reduces remote code fetch risk. The package creates/uses a local SQLite DB as expected.
Credentials
The skill requests no environment variables or credentials. The only persistent resource it uses is a local SQLite DB (default ~/.agent-memory/memory.db), which is appropriate for a memory store.
Persistence & Privilege
The skill will create and write a database under the user's home directory by default and can be pointed at an arbitrary db_path. This is normal for a local memory store, but be aware a user-supplied db_path could point to sensitive locations (permissions permitting). It does not request always:true and uses normal autonomous invocation behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install peng-agent-memory
  3. After installation, invoke the skill by name or use /peng-agent-memory
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Update
Metadata
Slug peng-agent-memory
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is agent-memory?

Provides persistent memory for AI agents to remember facts, learn from experience, and track entities across sessions. It is an AI Agent Skill for Claude Code / OpenClaw, with 335 downloads so far.

How do I install agent-memory?

Run "/install peng-agent-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is agent-memory free?

Yes, agent-memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does agent-memory support?

agent-memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created agent-memory?

It is built and maintained by penglovemeng (@penglovemeng); the current version is v1.0.0.

💬 Comments