@kalera/munin-openclaw 1.0.1 → 1.1.2

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @kalera/munin-openclaw@1.0.1 build /home/runner/work/munin-for-agents/munin-for-agents/adapters/openclaw
+> @kalera/munin-openclaw@1.1.2 build /home/runner/work/munin-for-agents/munin-for-agents/adapters/openclaw
 > tsc -p tsconfig.json
 

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "@kalera/munin-openclaw"
 description: "Munin - The Free (or $1.6/mo) Persistent Memory for OpenClaw. Stop your agent from having Alzheimer's."
-version: "1.0.0"
+version: "1.0.1"
 metadata:
   clawdbot:
     type: "plugin"
@@ -50,9 +50,12 @@ If your Munin project has **E2EE with GraphRAG** enabled, standard E2EE rules ap
 ## 🚀 Setup (Fast & Honest)
 
 1. **Get your Munin key:** Grab a **free** cloud key at [munin.kalera.dev](https://munin.kalera.dev).
-2. **Configure OpenClaw:** Add these to your `.env` or agent config:
-   - `MUNIN_BASE_URL`: Where your Munin lives (e.g., `https://munin.kalera.dev`).
-   - `MUNIN_API_KEY`: Your key to the kingdom.
+2. **Configure OpenClaw:** Once installed via `openclaw plugins install @kalera/munin-openclaw`, you can set your API key directly via the OpenClaw CLI without manually editing any config files:
+
+   ```bash
+   openclaw config set plugins.entries.munin-memory.config.apiKey "your-api-key-here"
+   ```
+   *(Alternatively, you can just set `MUNIN_BASE_URL` and `MUNIN_API_KEY` environment variables).*
 
 *(Note: Provide your agent with the `Context Core ID` in its system prompt so it knows which project to use when making tool calls).*
 

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-export declare function createOpenClawMuninAdapter(config: {
-    baseUrl: string;
-    apiKey?: string;
-    timeoutMs?: number;
-}): {
-    execute: (projectId: string, action: string, payload: Record<string, unknown>) => Promise<import("@kalera/munin-sdk").MuninResponse<unknown>>;
-    capabilities: () => Promise<import("@kalera/munin-sdk").MuninCapabilities>;
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    kind: string;
+    configSchema: any;
+    register(api: any): void;
 };
+export default _default;

package/dist/index.js

@@ -1,8 +1,100 @@
 import { MuninClient } from "@kalera/munin-sdk";
-export function createOpenClawMuninAdapter(config) {
-    const client = new MuninClient(config);
-    return {
-        execute: (projectId, action, payload) => client.invoke(projectId, action, payload, { ensureCapability: true }),
-        capabilities: () => client.capabilities(),
-    };
-}
+import { Type } from "@sinclair/typebox";
+import { z } from "zod";
+export default {
+    id: "munin-memory",
+    name: "Munin ContextKeep",
+    description: "Persistent memory tools for OpenClaw agents.",
+    kind: "memory",
+    configSchema: z.object({
+        baseUrl: z
+            .string()
+            .default("https://munin.kalera.dev")
+            .describe("The base URL for your Munin ContextKeep server."),
+        apiKey: z.string().optional().describe("Your API key for Munin."),
+    }),
+    register(api) {
+        const baseUrl = api.pluginConfig?.baseUrl ||
+            process.env.MUNIN_BASE_URL ||
+            "https://munin.kalera.dev";
+        const apiKey = api.pluginConfig?.apiKey || process.env.MUNIN_API_KEY;
+        if (!apiKey) {
+            api.logger.warn("Munin API key is missing. ContextKeep tools will not be registered.");
+            return;
+        }
+        const client = new MuninClient({ baseUrl, apiKey });
+        api.registerTool({
+            name: "munin_store_memory",
+            label: "Store Munin Memory",
+            description: "Store a new memory or update an existing one in ContextKeep.",
+            parameters: Type.Object({
+                projectId: Type.String({
+                    description: "The Context Core ID for isolation.",
+                }),
+                key: Type.String({ description: "Unique identifier for the memory." }),
+                content: Type.String({ description: "The content of the memory." }),
+                tags: Type.Optional(Type.String({ description: "Comma-separated list of tags." })),
+                title: Type.Optional(Type.String({ description: "Human-readable title." })),
+            }),
+            async execute(_toolCallId, params) {
+                const { projectId, ...payload } = params;
+                const res = await client.invoke(projectId, "store", payload);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(res.data, null, 2),
+                        },
+                    ],
+                    details: res.data,
+                };
+            },
+        });
+        api.registerTool({
+            name: "munin_retrieve_memory",
+            label: "Retrieve Munin Memory",
+            description: "Retrieve a memory by its key from ContextKeep.",
+            parameters: Type.Object({
+                projectId: Type.String({ description: "The Context Core ID." }),
+                key: Type.String({
+                    description: "The unique identifier of the memory.",
+                }),
+            }),
+            async execute(_toolCallId, params) {
+                const { projectId, key } = params;
+                const res = await client.invoke(projectId, "retrieve", { key });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(res.data, null, 2),
+                        },
+                    ],
+                    details: res.data,
+                };
+            },
+        });
+        api.registerTool({
+            name: "munin_search_memories",
+            label: "Search Munin Memories",
+            description: "Search for memories by key, title, or content in ContextKeep.",
+            parameters: Type.Object({
+                projectId: Type.String({ description: "The Context Core ID." }),
+                query: Type.String({ description: "The search term." }),
+            }),
+            async execute(_toolCallId, params) {
+                const { projectId, query } = params;
+                const res = await client.invoke(projectId, "search", { query });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(res.data, null, 2),
+                        },
+                    ],
+                    details: res.data,
+                };
+            },
+        });
+    },
+};

package/openclaw.plugin.json

@@ -0,0 +1,22 @@
+{
+  "id": "munin-memory",
+  "name": "Munin ContextKeep",
+  "description": "Persistent memory and Context Core for OpenClaw agents.",
+  "kind": "memory",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "baseUrl": {
+        "type": "string",
+        "default": "https://munin.kalera.dev",
+        "description": "The base URL for your Munin ContextKeep server."
+      },
+      "apiKey": {
+        "type": "string",
+        "description": "Your API key for Munin."
+      }
+    }
+  },
+  "skills": ["."]
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@kalera/munin-openclaw",
-  "version": "1.0.1",
+  "version": "1.1.2",
   "type": "module",
   "openclaw": {
     "extensions": [
-      "./dist/cli.js"
+      "./dist/index.js"
     ],
     "requires": {
       "env": [
@@ -13,17 +13,21 @@
       ]
     }
   },
-  "bin": {
-    "munin-openclaw": "dist/cli.js"
-  },
   "dependencies": {
+    "@sinclair/typebox": "^0.34.49",
+    "zod": "^4.3.6",
     "@kalera/munin-sdk": "1.0.0",
     "@kalera/munin-runtime": "1.0.0"
   },
   "devDependencies": {
+    "openclaw": "^2026.3.28",
     "typescript": "^5.9.2"
   },
+  "peerDependencies": {
+    "openclaw": "^2026.3.0"
+  },
   "scripts": {
+    "postinstall": "node ./postinstall.js",
     "build": "tsc -p tsconfig.json",
     "lint": "tsc -p tsconfig.json --noEmit",
     "test": "echo 'adapter-openclaw tests: pending'"

package/postinstall.js

@@ -0,0 +1,6 @@
+console.log('\n\x1b[36m=================================================================\x1b[0m');
+console.log('\x1b[36m\x1b[1m🐦 Munin ContextKeep successfully installed for OpenClaw!\x1b[0m');
+console.log('\x1b[36m=================================================================\x1b[0m\n');
+console.log('To activate your Munin Memory plugin, set your API key by running:\n');
+console.log('\x1b[33m  openclaw config set plugins.entries.munin-memory.config.apiKey "YOUR_API_KEY_HERE"\x1b[0m\n');
+console.log('Get your free API key at: \x1b[32mhttps://munin.kalera.dev\x1b[0m\n');

package/src/index.ts

@@ -1,16 +1,114 @@
 import { MuninClient } from "@kalera/munin-sdk";
+import { Type } from "@sinclair/typebox";
+import { z } from "zod";
 
-export function createOpenClawMuninAdapter(config: {
-  baseUrl: string;
-  apiKey?: string;
-  
-  timeoutMs?: number;
-}) {
-  const client = new MuninClient(config);
+export default {
+  id: "munin-memory",
+  name: "Munin ContextKeep",
+  description: "Persistent memory tools for OpenClaw agents.",
+  kind: "memory",
+  configSchema: z.object({
+    baseUrl: z
+      .string()
+      .default("https://munin.kalera.dev")
+      .describe("The base URL for your Munin ContextKeep server."),
+    apiKey: z.string().optional().describe("Your API key for Munin."),
+  }) as any,
+  register(api: any) {
+    const baseUrl =
+      (api.pluginConfig?.baseUrl as string) ||
+      process.env.MUNIN_BASE_URL ||
+      "https://munin.kalera.dev";
+    const apiKey =
+      (api.pluginConfig?.apiKey as string) || process.env.MUNIN_API_KEY;
 
-  return {
-    execute: (projectId: string, action: string, payload: Record<string, unknown>) =>
-      client.invoke(projectId, action as any, payload, { ensureCapability: true }),
-    capabilities: () => client.capabilities(),
-  };
-}
+    if (!apiKey) {
+      api.logger.warn(
+        "Munin API key is missing. ContextKeep tools will not be registered.",
+      );
+      return;
+    }
+
+    const client = new MuninClient({ baseUrl, apiKey });
+
+    api.registerTool({
+      name: "munin_store_memory",
+      label: "Store Munin Memory",
+      description: "Store a new memory or update an existing one in ContextKeep.",
+      parameters: Type.Object({
+        projectId: Type.String({
+          description: "The Context Core ID for isolation.",
+        }),
+        key: Type.String({ description: "Unique identifier for the memory." }),
+        content: Type.String({ description: "The content of the memory." }),
+        tags: Type.Optional(
+          Type.String({ description: "Comma-separated list of tags." }),
+        ),
+        title: Type.Optional(
+          Type.String({ description: "Human-readable title." }),
+        ),
+      }),
+      async execute(_toolCallId: string, params: any) {
+        const { projectId, ...payload } = params;
+        const res = await client.invoke(projectId, "store", payload);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(res.data, null, 2),
+            },
+          ],
+          details: res.data,
+        };
+      },
+    });
+
+    api.registerTool({
+      name: "munin_retrieve_memory",
+      label: "Retrieve Munin Memory",
+      description: "Retrieve a memory by its key from ContextKeep.",
+      parameters: Type.Object({
+        projectId: Type.String({ description: "The Context Core ID." }),
+        key: Type.String({
+          description: "The unique identifier of the memory.",
+        }),
+      }),
+      async execute(_toolCallId: string, params: any) {
+        const { projectId, key } = params;
+        const res = await client.invoke(projectId, "retrieve", { key });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(res.data, null, 2),
+            },
+          ],
+          details: res.data,
+        };
+      },
+    });
+
+    api.registerTool({
+      name: "munin_search_memories",
+      label: "Search Munin Memories",
+      description: "Search for memories by key, title, or content in ContextKeep.",
+      parameters: Type.Object({
+        projectId: Type.String({ description: "The Context Core ID." }),
+        query: Type.String({ description: "The search term." }),
+      }),
+      async execute(_toolCallId: string, params: any) {
+        const { projectId, query } = params;
+        const res = await client.invoke(projectId, "search", { query });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(res.data, null, 2),
+            },
+          ],
+          details: res.data,
+        };
+      },
+    });
+  },
+};

package/dist/cli.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cli.js

@@ -1,34 +0,0 @@
-import { executeWithRetry, loadCliEnv, parseCliArgs, safeError, startMcpServer, } from "@kalera/munin-runtime";
-import { createOpenClawMuninAdapter } from "./index.js";
-async function main() {
-    try {
-        const args = process.argv.slice(2);
-        // If no arguments, or 'mcp' is passed, start as MCP server
-        if (args.length === 0 || args[0] === 'mcp') {
-            await startMcpServer();
-            return;
-        }
-        const { action, payload } = parseCliArgs(args, "Usage: munin-openclaw <action> [payload-json] OR munin-openclaw mcp");
-        const env = loadCliEnv();
-        const adapter = createOpenClawMuninAdapter({
-            baseUrl: env.baseUrl,
-            apiKey: env.apiKey,
-            timeoutMs: env.timeoutMs,
-        });
-        const result = await executeWithRetry(async () => {
-            if (action === "capabilities") {
-                return { ok: true, data: await adapter.capabilities() };
-            }
-            const { projectId, ...p } = payload;
-            if (!projectId)
-                throw new Error("projectId required in payload");
-            return adapter.execute(projectId, action, p);
-        }, env.retries, env.backoffMs);
-        console.log(JSON.stringify(result, null, 2));
-    }
-    catch (error) {
-        console.error(JSON.stringify({ ok: false, error: safeError(error) }));
-        process.exitCode = 1;
-    }
-}
-void main();

package/src/cli.ts

@@ -1,47 +0,0 @@
-import {
-  executeWithRetry,
-  loadCliEnv,
-  parseCliArgs,
-  safeError,
-  startMcpServer,
-} from "@kalera/munin-runtime";
-import { createOpenClawMuninAdapter } from "./index.js";
-
-async function main() {
-  try {
-    const args = process.argv.slice(2);
-    
-    // If no arguments, or 'mcp' is passed, start as MCP server
-    if (args.length === 0 || args[0] === 'mcp') {
-      await startMcpServer();
-      return;
-    }
-
-    const { action, payload } = parseCliArgs(
-      args,
-      "Usage: munin-openclaw <action> [payload-json] OR munin-openclaw mcp",
-    );
-    const env = loadCliEnv();
-
-    const adapter = createOpenClawMuninAdapter({
-      baseUrl: env.baseUrl,
-      apiKey: env.apiKey,
-      
-      timeoutMs: env.timeoutMs,
-    });
-
-    const result = await executeWithRetry(async () => {
-      if (action === "capabilities") {
-        return { ok: true, data: await adapter.capabilities() };
-      }
-      const { projectId, ...p } = payload; if (!projectId) throw new Error("projectId required in payload"); return adapter.execute(projectId as string, action, p);
-    }, env.retries, env.backoffMs);
-
-    console.log(JSON.stringify(result, null, 2));
-  } catch (error) {
-    console.error(JSON.stringify({ ok: false, error: safeError(error) }));
-    process.exitCode = 1;
-  }
-}
-
-void main();