@poprobertdaniel/openclaw-memory 0.1.0

package/dist/server.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkNMUPGLJWcjs = require('./chunk-NMUPGLJW.cjs');
+require('./chunk-CRPEAZ44.cjs');
+require('./chunk-ZY2C2CJQ.cjs');
+
+
+exports.createServer = _chunkNMUPGLJWcjs.createServer;
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/robertpop/work/personal/openclaw-memory/dist/server.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACF,sDAAC","file":"/Users/robertpop/work/personal/openclaw-memory/dist/server.cjs"}

package/dist/server.d.cts

@@ -0,0 +1,2 @@
+import 'elysia';
+export { y as createServer } from './server-BTbRv-yX.cjs';

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import 'elysia';
+export { y as createServer } from './server-BTbRv-yX.js';

package/dist/server.js

@@ -0,0 +1,9 @@
+import {
+  createServer
+} from "./chunk-RFLG2CCR.js";
+import "./chunk-JSQBXYDM.js";
+import "./chunk-JNWCMHOB.js";
+export {
+  createServer
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/docker/full.yml

@@ -0,0 +1,45 @@
+# openclaw-memory — Full tier infrastructure
+# SQLite (local) + Qdrant (Docker) + PostgreSQL/AGE (Docker)
+#
+# Usage:
+#   docker compose -f full.yml up -d
+
+services:
+  qdrant:
+    image: qdrant/qdrant:v1.12.0
+    container_name: openclaw-memory-qdrant
+    ports:
+      - "6333:6333"
+      - "6334:6334"
+    volumes:
+      - qdrant_data:/qdrant/storage
+    environment:
+      QDRANT__SERVICE__GRPC_PORT: 6334
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:6333/healthz"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  postgres-age:
+    image: apache/age:PG16-v1.5.0
+    container_name: openclaw-memory-age
+    ports:
+      - "5432:5432"
+    environment:
+      POSTGRES_USER: openclaw
+      POSTGRES_PASSWORD: openclaw-memory
+      POSTGRES_DB: agent_memory
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U openclaw"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  qdrant_data:
+  postgres_data:

package/docker/standard.yml

@@ -0,0 +1,26 @@
+# openclaw-memory — Standard tier infrastructure
+# SQLite (local) + Qdrant (Docker)
+#
+# Usage:
+#   docker compose -f standard.yml up -d
+
+services:
+  qdrant:
+    image: qdrant/qdrant:v1.12.0
+    container_name: openclaw-memory-qdrant
+    ports:
+      - "6333:6333"
+      - "6334:6334"
+    volumes:
+      - qdrant_data:/qdrant/storage
+    environment:
+      QDRANT__SERVICE__GRPC_PORT: 6334
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:6333/healthz"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  qdrant_data:

package/package.json

@@ -0,0 +1,109 @@
+{
+  "name": "@poprobertdaniel/openclaw-memory",
+  "version": "0.1.0",
+  "description": "Triple-layer memory system for AI agents — SQLite + Qdrant + Postgres/AGE",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      },
+      "require": {
+        "types": "./dist/server.d.cts",
+        "default": "./dist/server.cjs"
+      }
+    }
+  },
+  "bin": {
+    "openclaw-memory": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist/",
+    "templates/",
+    "docker/",
+    "skill/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "bun --watch run src/server.ts",
+    "start": "bun run src/server.ts",
+    "test": "echo 'No tests yet'",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "memory",
+    "agents",
+    "sqlite",
+    "qdrant",
+    "graph",
+    "knowledge-graph",
+    "semantic-search",
+    "vector-database",
+    "openclaw",
+    "llm",
+    "rag",
+    "apache-age",
+    "triple-layer"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/openclaw-memory"
+  },
+  "homepage": "https://github.com/openclaw/openclaw-memory#readme",
+  "bugs": {
+    "url": "https://github.com/openclaw/openclaw-memory/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@elysiajs/cors": "^1.2.0",
+    "commander": "^13.0.0",
+    "elysia": "^1.2.0",
+    "openai": "^4.80.0",
+    "picocolors": "^1.1.0",
+    "uuid": "^11.1.0"
+  },
+  "optionalDependencies": {
+    "better-sqlite3": "^11.0.0"
+  },
+  "peerDependencies": {
+    "@qdrant/js-client-rest": ">=1.0.0",
+    "pg": "^8.13.0"
+  },
+  "peerDependenciesMeta": {
+    "@qdrant/js-client-rest": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^22.0.0",
+    "@types/pg": "^8.11.0",
+    "@types/uuid": "^10.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: memory
+version: 0.1.0
+description: Persistent triple-layer memory — store, search, and connect knowledge across sessions
+author: openclaw
+license: MIT
+tags: [memory, knowledge-graph, vector-search, persistence]
+tier: core
+---
+
+# Memory Skill
+
+Give your agent persistent memory that survives across sessions. Store facts, search by meaning, and traverse entity relationships.
+
+## What This Skill Does
+
+When installed, your agent gains the ability to:
+
+- **Remember** facts, decisions, conversations, and context
+- **Search** memories by keyword (FTS) or meaning (semantic vectors)
+- **Connect** entities — people, projects, teams, decisions — in a knowledge graph
+- **Recall** memories by time, tags, agent, or metadata filters
+- **Forget** specific memories when asked
+
+## How Agents Should Use It
+
+### Storing Memories
+
+Store important information as it comes up in conversation. Don't store everything — store what matters: decisions, facts about people, project context, preferences, and lessons learned.
+
+**Good memories to store:**
+- "The user prefers dark mode and Vim keybindings"
+- "Decided to use PostgreSQL instead of MongoDB for the user service"
+- "Alice Chen is the VP of Engineering, reports to CEO David Park"
+- "The deploy pipeline takes ~12 minutes and requires 2 approvals"
+
+**Don't store:**
+- Routine greetings or small talk
+- Information already in files the agent can read
+- Temporary context that won't matter tomorrow
+
+### Searching Memories
+
+Before answering questions about people, projects, or past decisions, search memory first. This prevents the agent from asking the user to repeat themselves.
+
+### Graph Traversal
+
+When the user asks relationship questions ("who reports to Alice?", "what projects is the platform team working on?"), use graph queries instead of text search.
+
+## Quick Start
+
+The memory service is available at `http://localhost:7777`. Check health:
+
+```bash
+curl http://localhost:7777/api/health
+```
+
+## Storing Memories
+
+```bash
+curl -X POST http://localhost:7777/api/memories \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $MEMORY_TOKEN" \
+  -d '{
+    "agent_id": "YOUR_AGENT_ID",
+    "scope": "user",
+    "subject_id": "USER_ID",
+    "content": "The fact or preference to remember",
+    "tags": ["optional", "tags"]
+  }'
+```
+
+### Scopes
+- `user` — About a specific person (requires subject_id)
+- `agent` — Agent's private knowledge
+- `global` — Shared across all agents
+- `project` — About a specific project (subject_id = project slug)
+- `session` — Conversation summaries
+
+## Searching Memories
+
+```bash
+curl -X POST http://localhost:7777/api/search \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $MEMORY_TOKEN" \
+  -d '{
+    "agent_id": "YOUR_AGENT_ID",
+    "query": "natural language question",
+    "limit": 5
+  }'
+```
+
+The search auto-selects the best strategy:
+- **Semantic** for broad/exploratory queries
+- **Fulltext** for specific keyword lookups
+- **Graph** for relationship queries
+
+## When to Use
+
+- **Store** when the user tells you something important about themselves
+- **Store** decisions, preferences, project details
+- **Search** at the start of each session for relevant context
+- **Search** when the user asks "do you remember..."
+- **Summarize** conversations at session end
+
+## Example Conversations
+
+### Building Memory Over Time
+
+```
+User: We just hired Sarah Kim as the new DevOps lead. She'll report to Alice.
+
+Agent: Got it — I'll remember that.
+       [stores: "Sarah Kim hired as DevOps lead, reports to Alice Chen"]
+       [graph: Sarah Kim (Person, DevOps Lead) -[REPORTS_TO]-> Alice Chen]
+
+User: (3 days later) Who's on Alice's team now?
+
+Agent: [graph query: related entities for Alice Chen]
+       Based on what I know, Alice Chen's direct reports include:
+       • Bob Smith (Team Lead)
+       • Sarah Kim (DevOps Lead, joined recently)
+```
+
+### Semantic Recall
+
+```
+User: What did we decide about the message queue situation?
+
+Agent: [search: "message queue decision"]
+       Found a relevant memory from January 15th:
+       "Decided to switch from Kafka to NATS for the event bus.
+        Reasons: simpler ops, lower latency for our workload."
+```
+
+## Environment
+
+- `MEMORY_URL` — Service URL (default: http://localhost:7777)
+- `MEMORY_TOKEN` — Auth token

package/templates/.env.example

@@ -0,0 +1,42 @@
+# ── openclaw-memory environment variables ────────────────────────────────
+
+# Server
+# OPENCLAW_MEMORY_PORT=7777
+# OPENCLAW_MEMORY_HOST=0.0.0.0
+# OPENCLAW_MEMORY_TIER=lite
+
+# Authentication
+MEMORY_AUTH_TOKEN=change-me-to-a-secure-token
+
+# SQLite (all tiers)
+# SQLITE_PATH=~/.openclaw-memory/memory.sqlite
+
+# ── Standard tier ────────────────────────────────────────────────────────
+
+# Qdrant
+# QDRANT_URL=http://localhost:6333
+# QDRANT_COLLECTION=openclaw_memories
+
+# Embedding provider (any OpenAI-compatible API)
+# OPENAI_API_KEY=sk-your-key-here
+# EMBEDDING_MODEL=text-embedding-3-small
+# EMBEDDING_BASE_URL=https://api.openai.com/v1
+
+# Or use OpenRouter
+# OPENROUTER_API_KEY=sk-or-v1-your-key
+# EMBEDDING_BASE_URL=https://openrouter.ai/api/v1
+# EMBEDDING_MODEL=openai/text-embedding-3-small
+
+# Entity extraction LLM
+# EXTRACTION_MODEL=gpt-4o-mini
+# EXTRACTION_BASE_URL=https://api.openai.com/v1
+
+# ── Full tier ────────────────────────────────────────────────────────────
+
+# PostgreSQL + Apache AGE
+# PGHOST=localhost
+# PGPORT=5432
+# PGUSER=openclaw
+# PGPASSWORD=your-password
+# PGDATABASE=agent_memory
+# AGE_GRAPH=agent_memory

package/templates/docker-compose.full.yml

@@ -0,0 +1,45 @@
+# openclaw-memory — Full tier infrastructure
+# SQLite (local) + Qdrant (Docker) + PostgreSQL/AGE (Docker)
+#
+# Usage:
+#   docker compose -f full.yml up -d
+
+services:
+  qdrant:
+    image: qdrant/qdrant:v1.12.0
+    container_name: openclaw-memory-qdrant
+    ports:
+      - "6333:6333"
+      - "6334:6334"
+    volumes:
+      - qdrant_data:/qdrant/storage
+    environment:
+      QDRANT__SERVICE__GRPC_PORT: 6334
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:6333/healthz"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  postgres-age:
+    image: apache/age:PG16-v1.5.0
+    container_name: openclaw-memory-age
+    ports:
+      - "5432:5432"
+    environment:
+      POSTGRES_USER: openclaw
+      POSTGRES_PASSWORD: openclaw-memory
+      POSTGRES_DB: agent_memory
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U openclaw"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  qdrant_data:
+  postgres_data:

package/templates/docker-compose.standard.yml

@@ -0,0 +1,26 @@
+# openclaw-memory — Standard tier infrastructure
+# SQLite (local) + Qdrant (Docker)
+#
+# Usage:
+#   docker compose -f standard.yml up -d
+
+services:
+  qdrant:
+    image: qdrant/qdrant:v1.12.0
+    container_name: openclaw-memory-qdrant
+    ports:
+      - "6333:6333"
+      - "6334:6334"
+    volumes:
+      - qdrant_data:/qdrant/storage
+    environment:
+      QDRANT__SERVICE__GRPC_PORT: 6334
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:6333/healthz"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  qdrant_data:

package/templates/openclaw-memory.config.ts

@@ -0,0 +1,49 @@
+import { defineConfig } from 'openclaw-memory';
+
+export default defineConfig({
+  // Tier: 'lite' (SQLite only), 'standard' (+Qdrant), 'full' (+Qdrant+AGE)
+  tier: 'lite',
+
+  // HTTP server
+  port: 7777,
+  host: '0.0.0.0',
+
+  // Authentication
+  auth: {
+    token: process.env.MEMORY_AUTH_TOKEN || 'change-me',
+    enabled: true,
+  },
+
+  // SQLite — always required (all tiers)
+  sqlite: {
+    path: '~/.openclaw-memory/memory.sqlite',
+  },
+
+  // ── Uncomment for Standard tier ─────────────────────────────────────
+
+  // qdrant: {
+  //   url: 'http://localhost:6333',
+  //   collection: 'openclaw_memories',
+  // },
+  // embedding: {
+  //   apiKey: process.env.OPENAI_API_KEY || '',
+  //   model: 'text-embedding-3-small',
+  //   dimensions: 1536,
+  // },
+  // extraction: {
+  //   apiKey: process.env.OPENAI_API_KEY || '',
+  //   model: 'gpt-4o-mini',
+  //   enabled: true,
+  // },
+
+  // ── Uncomment for Full tier ─────────────────────────────────────────
+
+  // age: {
+  //   host: 'localhost',
+  //   port: 5432,
+  //   user: 'openclaw',
+  //   password: process.env.PGPASSWORD || '',
+  //   database: 'agent_memory',
+  //   graph: 'agent_memory',
+  // },
+});