memorylake-openclaw 0.0.2 → 0.0.3

package/.github/workflows/release.yml

@@ -0,0 +1,23 @@
+name: Publish Package to npmjs
+on:
+  # Trigger on tag push
+  push:
+    tags:
+      - 'v*.*.*'
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v5
+      # Setup .npmrc file to publish to npm
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm i && npm ci
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/docs/openclaw.mdx

@@ -0,0 +1,98 @@
+---
+title: OpenClaw
+---
+
+Add long-term memory to [OpenClaw](https://github.com/openclaw/openclaw) agents with the `memorylake-openclaw` plugin. Your agent forgets everything between sessions — this plugin fixes that by automatically watching conversations, extracting what matters, and bringing it back when relevant.
+
+## Overview
+
+{/*<Frame>
+  <img src="/images/openclaw-architecture.png" alt="OpenClaw MemoryLake Architecture" />
+</Frame>*/}
+
+The plugin provides:
+1. **Auto-Recall** — Before the agent responds, memories matching the current message are injected into context
+2. **Auto-Capture** — After the agent responds, the exchange is sent to MemoryLake which decides what's worth keeping
+3. **Agent Tools** — Five tools for explicit memory operations during conversations
+
+Both auto-recall and auto-capture run silently with no manual configuration required.
+
+## Installation
+
+```bash
+openclaw plugins install memorylake-openclaw
+```
+
+## Setup and Configuration
+
+<Note>Get your API key and project ID from [app.memorylake.ai](https://app.memorylake.ai).</Note>
+
+Add to your `openclaw.json`:
+
+```json5
+// plugins.entries
+"memorylake-openclaw": {
+  "enabled": true,
+  "config": {
+    "apiKey": "${MEMORYLAKE_API_KEY}",
+    "projectId": "proj-...",
+    "userId": "your-user-id"
+  }
+}
+```
+
+## Agent Tools
+
+The agent gets five tools it can call during conversations:
+
+| Tool | Description |
+|------|-------------|
+| `memory_search` | Search memories by natural language |
+| `memory_list` | List all stored memories for a user |
+| `memory_store` | Explicitly save a fact |
+| `memory_get` | Retrieve a memory by ID |
+| `memory_forget` | Delete a memory by ID |
+
+## CLI Commands
+
+```bash
+# Search memories
+openclaw memorylake search "what languages does the user know"
+
+# View stats
+openclaw memorylake stats
+```
+
+## Configuration Options
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `apiKey` | `string` | — | **Required.** MemoryLake API key (supports `${MEMORYLAKE_API_KEY}`) |
+| `projectId` | `string` | — | **Required.** MemoryLake project ID |
+| `host` | `string` | `https://app.memorylake.ai` | MemoryLake server endpoint URL |
+| `userId` | `string` | `"default"` | Scope memories per user |
+| `autoRecall` | `boolean` | `true` | Inject memories before each turn |
+| `autoCapture` | `boolean` | `true` | Store facts after each turn |
+| `topK` | `number` | `5` | Max memories per recall |
+| `searchThreshold` | `number` | `0.3` | Min similarity (0–1) |
+| `rerank` | `boolean` | `true` | Rerank search results for better relevance |
+
+## Key Features
+
+1. **Zero Configuration** — Auto-recall and auto-capture work out of the box with no prompting required
+2. **Async Processing** — Memory extraction runs asynchronously via MemoryLake's API
+3. **Session Tracking** — Conversations are tagged with `chat_session_id` for traceability
+4. **Rich Tool Suite** — Five agent tools for explicit memory operations when needed
+
+## Conclusion
+
+The `memorylake-openclaw` plugin gives OpenClaw agents persistent memory with minimal setup. Your agents can remember user preferences, facts, and context across sessions automatically.
+
+{/*<CardGroup cols={2}>
+  <Card title="MemoryLake" icon="brain" href="https://app.memorylake.ai">
+    MemoryLake platform
+  </Card>
+  <Card title="OpenClaw" icon="robot" href="https://github.com/openclaw/openclaw">
+    OpenClaw agent framework
+  </Card>
+</CardGroup>*/}

package/index.ts

@@ -213,16 +213,6 @@ function normalizeAddResult(raw: any): AddResult {
 // Config Parser
 // ============================================================================
 
-function resolveEnvVars(value: string): string {
-  return value.replace(/\$\{([^}]+)\}/g, (_, envVar) => {
-    const envValue = process.env[envVar];
-    if (!envValue) {
-      throw new Error(`Environment variable ${envVar} is not set`);
-    }
-    return envValue;
-  });
-}
-
 // ============================================================================
 // Config Schema
 // ============================================================================
@@ -267,10 +257,10 @@ const memoryLakeConfigSchema = {
     return {
       host:
         typeof cfg.host === "string" && cfg.host
-          ? resolveEnvVars(cfg.host)
+          ? cfg.host
           : "https://app.memorylake.ai",
-      apiKey: resolveEnvVars(cfg.apiKey),
-      projectId: resolveEnvVars(cfg.projectId),
+      apiKey: cfg.apiKey as string,
+      projectId: cfg.projectId as string,
       userId:
         typeof cfg.userId === "string" && cfg.userId ? cfg.userId : "default",
       autoCapture: cfg.autoCapture !== false,

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "memorylake-openclaw",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "description": "MemoryLake memory backend for OpenClaw",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/memorylake-ai/memorylake-openclaw.git"
+  },
   "keywords": [
     "openclaw",
     "plugin",