← Back to Skills Marketplace
cxz9909

Cxz9909 Agent Memory

by cxz9909 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
51
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install cxz9909-agent-memory
Description
Persistent memory system for AI agents to remember facts, learn from experience, track entities, and recall context 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
What to consider before installing/using this skill: - Origin and provenance: The package metadata and README/installation hints don't fully match the registry entry (different slug/owner references and no homepage). Only install from a source you trust. Ask the maintainer for a canonical repo or signed release if provenance matters. - Code sanity review: There are some coherence/quality issues in the bundle that could break usage (e.g., __init__.py exports get_memory but that function is not present in the visible memory.py, and some SQL/FTS uses look incorrect — e.g., ORDER BY fts.rank which may not exist). Run the included tests locally before deploying (tests are bundled). Expect small bugs rather than malicious behavior. - Data sensitivity: This skill persists arbitrary facts to a local SQLite DB (default ~/.agent-memory/memory.db). Do not allow the agent to store secrets (passwords, API keys, private tokens) in this DB unless you add encryption and strong filesystem permissions. Consider custom db_path pointing to an encrypted volume or in-memory DB for sensitive deployments. - Permissions and filesystem: The DB will be created with the process user permissions. Ensure the DB file has restrictive permissions (chmod 600) and is stored somewhere appropriate. - Network/exfiltration: The code shown contains no network calls or external endpoints. That reduces remote-exfil risk, but always assume an agent that can execute code and access the filesystem might be able to leak data via other skills or tooling. Limit what the agent can access or run if you have strict data controls. - Functional checks: Before using in production, run the bundled tests, and exercise common flows (remember/retrieve/export). Verify export_json and other functions behave as expected. Also inspect memory.py fully to confirm there are no hidden network calls or dynamic import/execution paths not visible in the truncated listing. - Fixes to request from author or apply locally: (1) fix the get_memory export or remove it from __init__, (2) reconcile README/install command and registry slug, (3) verify FTS usage (MATCH and ORDER BY) and ensure queries are safe and robust, (4) consider adding optional DB encryption or advice in SKILL.md about sensitive data handling. If you cannot validate the code or provenance, treat this skill as untrusted for storing or handling any secrets or PII.
Capability Analysis
Type: OpenClaw Skill Name: cxz9909-agent-memory Version: 1.0.0 The AgentMemory skill is a well-documented and straightforward implementation of a local persistent memory system for AI agents using SQLite. The code (primarily in src/memory.py) handles facts, lessons, and entities locally without any external network dependencies, obfuscation, or high-risk execution patterns. The instructions in SKILL.md are strictly aligned with the stated purpose of maintaining session context and do not contain any prompt-injection attacks or malicious directives.
Capability Tags
crypto
Capability Assessment
Purpose & Capability
The name/description (persistent agent memory) aligns with the included Python code: facts, lessons, entities stored in a local SQLite DB. However there are inconsistencies: SKILL.md/README show an installation command 'clawdhub install agent-memory' and a GitHub repo/author, while the registry slug is 'cxz9909-agent-memory' and source/homepage are unknown. __init__.py exports get_memory but no get_memory definition is visible in memory.py (likely a missing symbol). These mismatches suggest the package bundle or metadata wasn't fully synchronized.
Instruction Scope
SKILL.md runtime instructions are narrowly scoped to creating/reading/updating the local memory DB and integrating mem.get_lessons/get_entity/remember at session boundaries — which is appropriate for a memory skill. It does direct persistent reads/writes to ~/.agent-memory/memory.db by default (and shows a custom db_path option). That persistence is expected but means stored content may include sensitive information the agent writes; SKILL.md does not mention encryption or access controls.
Install Mechanism
No install spec is declared (instruction-only), and the package includes source files. No external downloads or third-party dependencies are requested (requirements.txt claims 'No external dependencies'). This is lower risk from an install perspective, but the runtime will write a local SQLite DB to disk — verify filesystem permissions.
Credentials
The skill declares no required environment variables, no credentials, and no config paths beyond the default DB location. That is proportionate to the stated purpose. Note: because it persists arbitrary facts, users should avoid storing secrets in it or should configure an encrypted DB path.
Persistence & Privilege
The skill is not forced-always and allows user invocation; it will create and maintain a persistent SQLite DB by default at ~/.agent-memory/memory.db. Autonomous invocation is allowed by default (normal for skills) — consider whether you want an agent with autonomous access to a persistent memory store that can be read/written across sessions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cxz9909-agent-memory
  3. After installation, invoke the skill by name or use /cxz9909-agent-memory
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of AgentMemory Skill. - Adds persistent memory storage for AI agents, allowing recall of facts, lessons learned, and entity tracking across sessions. - Includes simple Python API for remembering, learning from experience, recalling information, and entity management. - Provides integration guidance for Clawdbot and customizable database location.
Metadata
Slug cxz9909-agent-memory
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Cxz9909 Agent Memory?

Persistent memory system for AI agents to remember facts, learn from experience, track entities, and recall context across sessions. It is an AI Agent Skill for Claude Code / OpenClaw, with 51 downloads so far.

How do I install Cxz9909 Agent Memory?

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

Is Cxz9909 Agent Memory free?

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

Which platforms does Cxz9909 Agent Memory support?

Cxz9909 Agent Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Cxz9909 Agent Memory?

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

💬 Comments