← Back to Skills Marketplace
panyuugit

Andrew Memory Layer

by PanyuuGit · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
94
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install andrew-memory
Description
Product-grade semantic memory layer for AI agents using LanceDB. Provides long-term memory with semantic search, Core Identity management, and conversation d...
README (SKILL.md)

Andrew Memory Layer

A product-grade semantic memory layer for AI agents, powered by LanceDB.

Overview

This skill provides long-term memory capabilities for AI agents using a local LanceDB vector database. It enables semantic search, Core Identity management, and conversation distillation.

Features

  • Semantic Memory Search - Find relevant memories using natural language queries
  • Core Identity Injection - Maintain consistent persona across sessions
  • Conversation Distillation - Automatically extract memory atoms from conversations
  • Dual LLM Support - Works with MiniMax API (cloud) or Ollama (local)
  • Rich Metadata - Tracks importance, confidence, and reuse count for each memory

Tools

Tool Description
andrew_memory_add Store a new memory with type, importance, and confidence
andrew_memory_search Search memories semantically using natural language
andrew_memory_set_identity Set the agent's Core Identity
andrew_memory_get_identity Retrieve the current Core Identity
andrew_memory_distill Extract key memories from a conversation
andrew_memory_regenerate_vectors Rebuild all vectors (after changing embedding model)

Configuration

{
  "plugins": {
    "entries": {
      "andrew-memory": {
        "enabled": true,
        "config": {
          "dataDir": "~/.andrew-memory/data",
          "llmMode": "api",
          "localLlmUrl": "http://localhost:11434"
        }
      }
    }
  }
}

Config Options

Option Default Description
dataDir ~/.andrew-memory/data LanceDB data directory
llmMode api api (MiniMax) or local (Ollama)
localLlmUrl http://localhost:11434 Ollama URL when using local mode

Requirements

  • OpenClaw
  • Node.js >= 22
  • LanceDB (auto-installed)
  • MiniMax API key (if using cloud mode): set MINIMAX_API_KEY env var

Memory Types

  • preference - User preferences and habits
  • fact - Factual information about the user or world
  • rule - Executable rules and guidelines
  • experience - Past experiences with success/failure outcomes
  • thought - Thoughts, observations, insights
  • distilled - Auto-extracted from conversations
  • general - Default general-purpose memory

Usage Example

User: Remember that I prefer short responses in the morning.
→ andrew_memory_add: { text: "User prefers short responses in the morning", memoryType: "preference" }

User: What did I say about my communication preferences?
→ andrew_memory_search: { query: "communication preferences morning responses" }
Usage Guidance
This plugin appears to do what it says: local LanceDB storage and optional cloud embeddings/distillation via MiniMax. Before installing, consider: (1) Privacy: stored memories are persisted under ~/.andrew-memory/data — review or change dataDir if you don't want data in your home directory. (2) Network: in 'api' mode conversation text and queries are sent to https://api.minimaxi.com (requires MINIMAX_API_KEY); use 'local' mode and run a local Ollama if you want to avoid sending data to the cloud. (3) Dependencies: the plugin relies on @lancedb/lancedb and Node >=22 — ensure those meet your environment/policy. (4) Robustness: index.js uses an absolute path to the OpenClaw SDK which may fail on some systems — inspect/adjust that path before enabling. If you have sensitive data, run the plugin in a sandboxed agent or review the source in full (already present) and prefer local LLM mode.
Capability Assessment
Purpose & Capability
Name, description, and code align: the plugin implements a LanceDB-backed memory layer (add/search/identity/distill/regenerate). Minor mismatch: SKILL.md and source reference an optional MINIMAX_API_KEY for cloud mode, but the registry metadata lists no required env vars — the key is optional in code (process.env.MINIMAX_API_KEY). The plugin also requires Node >=22 and @lancedb/lancedb (declared in package.json).
Instruction Scope
Runtime behavior stays within the described scope: memories are written to a dataDir (default ~/.andrew-memory/data), semantic search uses embeddings, and conversation distillation calls an LLM. Important runtime actions that affect privacy/security: conversation text and distilled memory content may be sent to external endpoints (https://api.minimaxi.com and optionally a local Ollama instance at the configured localLlmUrl). The SKILL.md warns about MiniMax API key but the plugin will still operate in local mode. There is no instruction to read unrelated system files or other skills' configs.
Install Mechanism
No explicit install spec is included in the registry entry (instruction-only install), but the package.json and package-lock.json are present and list @lancedb/lancedb and its transitive deps. There are no downloads from arbitrary URLs or URL shorteners. One oddity: index.js uses an absolute require path ('/usr/lib/node_modules/openclaw/dist/plugin-sdk/plugin-entry.js') to load the OpenClaw SDK — this is fragile and assumes a specific global install location, but not obviously malicious.
Credentials
The plugin accesses only a small set of environment or system items: process.env.MINIMAX_API_KEY (optional), os.homedir() for default dataDir, and network access for LLM/embedding endpoints. The registry metadata lists no required env vars even though SKILL.md documents MINIMAX_API_KEY for cloud mode — this is an omission but not a functional mismatch. No other unrelated secrets or credentials are requested.
Persistence & Privilege
The plugin writes persistent data to its own directory (default ~/.andrew-memory/data) and creates LanceDB tables. always:false and it does not modify other skills or system-wide settings. Persistent storage of user conversations is expected behavior for a memory layer; users should be aware that stored memories are retained on disk.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install andrew-memory
  3. After installation, invoke the skill by name or use /andrew-memory
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug andrew-memory
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Andrew Memory Layer?

Product-grade semantic memory layer for AI agents using LanceDB. Provides long-term memory with semantic search, Core Identity management, and conversation d... It is an AI Agent Skill for Claude Code / OpenClaw, with 94 downloads so far.

How do I install Andrew Memory Layer?

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

Is Andrew Memory Layer free?

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

Which platforms does Andrew Memory Layer support?

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

Who created Andrew Memory Layer?

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

💬 Comments