@contextableai/openclaw-memory-graphiti 0.1.1 → 0.1.2

package/README.md

@@ -1,4 +1,4 @@
-# @openclaw/memory-graphiti
+# @contextableai/openclaw-memory-graphiti
 
 Two-layer memory plugin for OpenClaw: **SpiceDB** for authorization, **Graphiti** for knowledge graph storage.
 
@@ -30,7 +30,21 @@ Agents remember conversations as structured entities and facts in a knowledge gr
 
 **SpiceDB** determines which `group_id`s a subject (agent or person) can access, then **Graphiti** searches or stores memories scoped to those groups.
 
-## Quick Start
+## Installation
+
+```bash
+openclaw plugins install @contextableai/openclaw-memory-graphiti
+```
+
+Or with npm:
+
+```bash
+npm install @contextableai/openclaw-memory-graphiti
+```
+
+Then restart the gateway. On first start, the plugin automatically:
+- Writes the SpiceDB authorization schema (if not already present)
+- Creates group membership for the configured agent in the default group
 
 ### Prerequisites
 
@@ -43,45 +57,26 @@ Agents remember conversations as structured entities and facts in a knowledge gr
 cd docker
 cp .env.example .env
 # Edit .env — set OPENAI_API_KEY at minimum
-docker compose up -d falkordb graphiti-mcp spicedb
+docker compose up -d
 ```
 
 This starts:
 - **FalkorDB** on port 6379 (graph database, web UI on port 3000)
 - **Graphiti MCP Server** on port 8000 (knowledge graph API)
+- **PostgreSQL** on port 5432 (persistent datastore for SpiceDB)
 - **SpiceDB** on port 50051 (authorization engine)
 
-### 2. Configure the Plugin
-
-Add to your OpenClaw plugin configuration:
-
-```json
-{
-  "spicedb": {
-    "endpoint": "localhost:50051",
-    "token": "dev_token",
-    "insecure": true
-  },
-  "graphiti": {
-    "endpoint": "http://localhost:8000",
-    "defaultGroupId": "main"
-  },
-  "subjectId": "my-agent"
-}
-```
-
-### 3. Initialize SpiceDB Schema
+### 2. Restart the Gateway
 
 ```bash
-openclaw graphiti-mem schema-write
+openclaw gateway restart
 ```
 
-### 4. Add Group Membership
+The plugin auto-initializes on startup — no manual `schema-write` or `add-member` needed for basic use. The SpiceDB schema is written automatically on first run, and the configured `subjectId` is added to the `defaultGroupId`.
 
-```bash
-# Add the agent to a group
-openclaw graphiti-mem add-member main my-agent --type agent
+### 3. (Optional) Add More Group Members
 
+```bash
 # Add people to groups
 openclaw graphiti-mem add-member family mom --type person
 openclaw graphiti-mem add-member family dad --type person
@@ -271,16 +266,16 @@ The `docker/` directory contains a full-stack Docker Compose configuration:
 | `spicedb` | 50051, 8443, 9090 | Authorization engine (gRPC, HTTP, metrics) |
 | `openclaw-gateway` | 18789, 18790 | OpenClaw gateway (optional) |
 
-### Infrastructure Only
+### Infrastructure (default)
 
 ```bash
-docker compose up -d falkordb graphiti-mcp postgres spicedb-migrate spicedb
+docker compose up -d
 ```
 
-### Full Stack (Gateway + Infrastructure)
+### With OpenClaw Gateway
 
 ```bash
-docker compose up -d
+docker compose --profile gateway up -d
 ```
 
 When running inside Docker Compose, use service hostnames in the plugin config:

package/docker/docker-compose.yml

@@ -1,24 +1,26 @@
-# Full-stack: OpenClaw gateway + memory-graphiti infrastructure
-#
-# All services share the same Docker network, so the gateway plugin
-# reaches Graphiti and SpiceDB by service hostname — no localhost hacks.
+# memory-graphiti infrastructure: FalkorDB + Graphiti MCP + PostgreSQL + SpiceDB
 #
 # Usage:
-#   cp .env.example .env        # Fill in OPENAI_API_KEY and other vars
-#   docker compose up -d        # Start everything
+#   cp .env.example .env        # Fill in OPENAI_API_KEY at minimum
+#   docker compose up -d        # Start infrastructure
 #   docker compose logs -f      # Watch startup
 #
-# The gateway will be available at http://localhost:18789
-# FalkorDB web UI at http://localhost:3000
+# Infrastructure services are available at:
+#   FalkorDB:        localhost:6379 (Redis protocol), localhost:3000 (web UI)
+#   Graphiti MCP:    http://localhost:8000
+#   SpiceDB gRPC:    localhost:50051
+#   SpiceDB HTTP:    localhost:8443
+#   PostgreSQL:      localhost:5432
 #
-# To run without the gateway (infra only, for dev/testing):
-#   docker compose up -d falkordb graphiti-mcp spicedb
+# To also run the OpenClaw gateway (optional):
+#   docker compose --profile gateway up -d
 
 services:
   # --------------------------------------------------------------------------
-  # OpenClaw Gateway
+  # OpenClaw Gateway (opt-in via --profile gateway)
   # --------------------------------------------------------------------------
   openclaw-gateway:
+    profiles: [gateway]
     image: ${OPENCLAW_IMAGE:-openclaw:local}
     environment:
       HOME: /home/node
@@ -27,8 +29,6 @@ services:
       CLAUDE_AI_SESSION_KEY: ${CLAUDE_AI_SESSION_KEY:-}
       CLAUDE_WEB_SESSION_KEY: ${CLAUDE_WEB_SESSION_KEY:-}
       CLAUDE_WEB_COOKIE: ${CLAUDE_WEB_COOKIE:-}
-      # Memory-graphiti plugin will read these from the plugin config,
-      # but we also pass them as env vars for ${...} interpolation in config
       OPENAI_API_KEY: ${OPENAI_API_KEY}
       SPICEDB_TOKEN: ${SPICEDB_TOKEN:-dev_token}
     volumes:

package/index.ts

@@ -909,8 +909,17 @@ const memoryGraphitiPlugin = {
         const graphitiOk = await graphiti.healthCheck();
         let spicedbOk = false;
         try {
-          await spicedb.readSchema();
+          const existing = await spicedb.readSchema();
           spicedbOk = true;
+
+          // Auto-write schema if SpiceDB has no schema yet
+          if (!existing || !existing.includes("memory_group")) {
+            api.logger.info("memory-graphiti: writing SpiceDB schema (first run)");
+            const schemaPath = join(dirname(fileURLToPath(import.meta.url)), "schema.zed");
+            const schema = readFileSync(schemaPath, "utf-8");
+            await spicedb.writeSchema(schema);
+            api.logger.info("memory-graphiti: SpiceDB schema written successfully");
+          }
         } catch {
           // Will be retried on first use
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextableai/openclaw-memory-graphiti",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "OpenClaw two-layer memory plugin: SpiceDB authorization + Graphiti knowledge graph",
   "type": "module",
   "license": "MIT",
@@ -46,6 +46,11 @@
   "openclaw": {
     "extensions": [
       "./index.ts"
-    ]
+    ],
+    "install": {
+      "npmSpec": "@contextableai/openclaw-memory-graphiti",
+      "localPath": "extensions/memory-graphiti",
+      "defaultChoice": "npm"
+    }
   }
 }