memorylake-openclaw 0.0.8 → 0.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorylake-openclaw",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "type": "module",
   "description": "MemoryLake memory backend for OpenClaw",
   "license": "MIT",

package/skills/common/get-config.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+// Parse --agent
+const args = process.argv.slice(2);
+const agentIdx = args.indexOf("--agent");
+if (agentIdx === -1 || !args[agentIdx + 1]) {
+  console.error("Usage: node get-config.mjs --agent <agentId>");
+  process.exit(1);
+}
+const agentId = args[agentIdx + 1];
+
+// Read global config
+const openclawPath = join(homedir(), ".openclaw", "openclaw.json");
+const openclaw = JSON.parse(readFileSync(openclawPath, "utf-8"));
+const globalCfg = openclaw?.plugins?.entries?.["memorylake-openclaw"]?.config;
+if (!globalCfg) {
+  console.error("Error: memorylake-openclaw plugin config not found");
+  process.exit(1);
+}
+
+// Resolve workspace
+const agents = openclaw?.agents;
+const agentEntry = agents?.list?.find((a) => a.id === agentId);
+const workspace = agentEntry?.workspace || agents?.defaults?.workspace;
+if (!workspace) {
+  console.error(`Error: no workspace found for agent "${agentId}"`);
+  process.exit(1);
+}
+
+// Merge per-agent overrides
+const merged = { ...globalCfg };
+const localPath = join(workspace, ".memorylake", "config.json");
+if (existsSync(localPath)) {
+  const raw = JSON.parse(readFileSync(localPath, "utf-8"));
+  if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+    Object.assign(merged, raw);
+  }
+}
+merged.host = merged.host || "https://app.memorylake.ai";
+merged.workspace = workspace;
+
+// Validate required fields
+if (!merged.apiKey || !merged.projectId) {
+  console.error("Error: apiKey and projectId are required");
+  process.exit(1);
+}
+
+console.log(JSON.stringify(merged, null, 2));

package/skills/memorylake-api/SKILL.md

@@ -19,21 +19,15 @@ Directly call MemoryLake's REST APIs by discovering endpoints from the live Open
 
 ## Step 1 — Read MemoryLake Config
 
-Read `~/.openclaw/openclaw.json` and extract the plugin config:
+Run the common config script (path is relative to **this skill's SKILL.md**, i.e. `../common/get-config.mjs`):
 
 ```bash
-cat ~/.openclaw/openclaw.json | jq '.plugins.entries["memorylake-openclaw"].config'
+node {path-to-this-skill}/../common/get-config.mjs --agent {agent}
 ```
 
-Extract these values:
+Where `{agent}` is the current agent ID. The script outputs JSON config with `host`, `apiKey`, `projectId`, etc.
 
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `host` | API host | `https://app.memorylake.ai` |
-| `apiKey` | API key for authentication | (required) |
-| `projectId` | MemoryLake project ID | (required) |
-
-If `apiKey` or `projectId` is missing, stop and inform the user.
+If the script exits with an error, stop and inform the user.
 
 Auth header for all requests:
 
@@ -185,15 +179,14 @@ All responses follow the same wrapper format:
 
 - **Wrong base URL**: The full URL must include `/openapi/memorylake` before the API path. E.g., `/openapi/memorylake/api/v1/projects`, NOT just `/api/v1/projects`
 - **Missing auth header**: Every request requires `Authorization: Bearer {apiKey}`
-- **Hardcoded project ID**: Always read `projectId` from `~/.openclaw/openclaw.json` config, not from user input (unless the user explicitly wants a different project)
+- **Hardcoded project ID**: Always read `projectId` from the config script output, not from user input (unless the user explicitly wants a different project)
 - **Pagination**: List endpoints default to `page=1, size=20`. Pass `page` and `size` query params if the user needs more results
 
 ## Quick Reference
 
 | Item | Value |
 |------|-------|
-| OpenClaw config | `~/.openclaw/openclaw.json` |
-| Plugin config key | `plugins.entries["memorylake-openclaw"].config` |
+| Config script | `{path-to-this-skill}/../common/get-config.mjs --agent {agent}` |
 | Server base path | `/openapi/memorylake` |
 | OpenAPI spec URL | `{host}/openapi/memorylake/api-docs/open-api` |
 | Auth header | `Authorization: Bearer {apiKey}` |

package/skills/memorylake-upload/SKILL.md

@@ -16,21 +16,15 @@ Upload local files to MemoryLake using the multipart upload API, then associate
 
 ## Step 1 -- Read MemoryLake Config
 
-Read `~/.openclaw/openclaw.json` and extract the plugin config:
+Run the common config script (path is relative to **this skill's SKILL.md**, i.e. `../common/get-config.mjs`):
 
 ```bash
-cat ~/.openclaw/openclaw.json | jq '.plugins.entries["memorylake-openclaw"].config'
+node {path-to-this-skill}/../common/get-config.mjs --agent {agent}
 ```
 
-Extract these values:
+Where `{agent}` is the current agent ID. The script outputs JSON config with `host`, `apiKey`, `projectId`, etc.
 
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `host` | API host | `https://app.memorylake.ai` |
-| `apiKey` | API key for authentication | (required) |
-| `projectId` | MemoryLake project ID | (required) |
-
-If `apiKey` or `projectId` is missing, stop and inform the user.
+If the script exits with an error, stop and inform the user.
 
 ## Step 2 -- Run the Upload Script
 
@@ -56,5 +50,5 @@ The script prints progress for each step (create upload, upload parts, complete,
 
 ## Common Mistakes
 
-- **Skipping Step 1**: Directly hardcoding host/apiKey/projectId instead of reading from `~/.openclaw/openclaw.json`
+- **Skipping Step 1**: Directly hardcoding host/apiKey/projectId instead of using the config script
 - **Relative file paths**: Always resolve the user's file path to an absolute path before passing to the script

package/skills/migrate-memories-to-memorylake/SKILL.md

@@ -17,8 +17,8 @@ Extract memory files and conversation history from session files, then submit th
 ## Prerequisites
 
 The caller must provide:
+- **`agent`**: The agent name (e.g., `main`). Used to resolve config (Step 1) and locate session files (Step 2).
 - **`user_id`**: The user ID for filtering sessions (e.g., a Feishu user ID like `ou_xxx`). **This is only used for session filtering, NOT for the API request.**
-- **`agent`**: The agent name (e.g., `main`)
 
 ## Preferred: Run the Migration Script
 
@@ -40,26 +40,15 @@ If the script fails, follow these steps manually.
 
 ### Step 1 — Read MemoryLake Config
 
-Read `~/.openclaw/openclaw.json` and extract the plugin config:
+Run the common config script (path is relative to **this skill's SKILL.md**, i.e. `../common/get-config.mjs`):
 
 ```bash
-cat ~/.openclaw/openclaw.json | jq '.plugins.entries["memorylake-openclaw"].config'
+node {path-to-this-skill}/../common/get-config.mjs --agent {agent}
 ```
 
-Extract these values:
-- **`host`** — API host (default: `https://app.memorylake.ai`)
-- **`apiKey`** — API key for authentication
-- **`projectId`** — MemoryLake project ID
+The script outputs JSON config with `host`, `apiKey`, `projectId`, `workspace`, etc. If the script exits with an error, stop and inform the user.
 
-### Step 2 — Identify User and Agent
-
-Use the `user_id` and `agent` provided by the caller:
-- `user_id` — only for filtering sessions in Step 3 (session keys contain the user ID)
-- `agent` — determines which agent's session directory to read
-
-**When POSTing to the API, always use `"user_id": "default"`. Do NOT use the caller-provided `user_id`.**
-
-### Step 3 — Filter Sessions by User ID
+### Step 2 — Filter Sessions by User ID
 
 **You MUST use `sessions.json` to filter sessions. Do NOT grep/search JSONL files directly.**
 
@@ -83,29 +72,21 @@ Use the `user_id` and `agent` provided by the caller:
    ~/.openclaw/agents/{agent}/sessions/{sessionId}.jsonl
    ```
 
-### Step 4 — Read Memory Files
-
-Resolve the workspace path for the agent:
-
-1. Check `agents.list` for an entry with `id` matching the agent. If it has a `workspace` field, use it.
-2. Otherwise, fall back to `agents.defaults.workspace`.
+### Step 3 — Read Memory Files
 
-```bash
-# Agent-specific workspace (e.g., agent "foo"):
-cat ~/.openclaw/openclaw.json | jq -r '.agents.list[] | select(.id == "{agent}") | .workspace'
-# Default workspace:
-cat ~/.openclaw/openclaw.json | jq -r '.agents.defaults.workspace'
-```
-
-Then read:
+Use the `workspace` path from the config output in Step 1. Then read:
 - `{workspace}/MEMORY.md`
 - All files in `{workspace}/memory/` directory
 
 These contain curated memory that should also be migrated.
 
-### Step 5 — Submit Data to MemoryLake
+### Step 4 — Submit Data to MemoryLake
+
+Use `host`, `apiKey`, `projectId` from the config output in Step 1.
+
+**When POSTing to the API, always use `"user_id": "default"`. Do NOT use the caller-provided `user_id`.**
 
-#### 5a — Submit Session Conversations
+#### 4a — Submit Session Conversations
 
 For each matched `.jsonl` session file:
 
@@ -156,7 +137,7 @@ For each matched `.jsonl` session file:
      }
    }
    ```
-#### 5b — Submit Memory Files
+#### 4b — Submit Memory Files
 
 For each memory file (`MEMORY.md` and files in `memory/`):
 
@@ -203,11 +184,10 @@ At the end, print a summary:
 
 | Item | Path / Value |
 |------|-------------|
-| Config file | `~/.openclaw/openclaw.json` |
-| Plugin config key | `plugins.entries["memorylake-openclaw"].config` |
+| Config script | `{path-to-this-skill}/../common/get-config.mjs --agent {agent}` |
 | Session index | `~/.openclaw/agents/{agent}/sessions/sessions.json` |
 | Session files | `~/.openclaw/agents/{agent}/sessions/{id}.jsonl` |
-| Workspace path | `agents.defaults.workspace` in config |
+| Workspace path | from config script output (`workspace` field) |
 | API endpoint | `{host}/openapi/memorylake/api/v2/projects/{projectId}/memories` |
 | Auth header | `Authorization: Bearer {apiKey}` |
 | Default host | `https://app.memorylake.ai` |