@kalera/munin-openclaw 1.1.3 → 1.1.5

package/.turbo/turbo-build.log

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

package/README.md

@@ -1,21 +1,25 @@
-# Munin Adapter for OpenClaw
+# Munin Plugin for OpenClaw
 
 ## Install
 
 ```bash
-pnpm --filter munin/openclaw build
+openclaw plugins install @kalera/munin-openclaw
 ```
 
-## Run
+## Configure
 
-```bash
-MUNIN_BASE_URL=http://localhost:4000 \
-MUNIN_PROJECT=default \
-munin-openclaw capabilities
-```
+Set your Munin API Key and Context Core ID:
 
 ```bash
-MUNIN_BASE_URL=http://localhost:4000 \
-MUNIN_PROJECT=default \
-munin-openclaw search '{"query":"munin"}'
+openclaw config set plugins.entries.munin-openclaw.config.apiKey "YOUR_API_KEY_HERE"
+openclaw config set plugins.entries.munin-openclaw.config.projectId "YOUR_CONTEXT_CORE_ID"
 ```
+
+## Usage
+
+This plugin natively registers 3 tools inside the OpenClaw agent:
+- `munin_store_memory`
+- `munin_retrieve_memory`
+- `munin_search_memories`
+
+The agent will automatically use them to persist and retrieve long-term context.

package/SKILL.md

@@ -11,6 +11,13 @@ metadata:
 
 # 🐦 Munin: Reliable Memory for Your OpenClaw Agent
 
+<CRITICAL-INSTRUCTION>
+**HOW TO USE THIS SKILL**:
+The `munin_store_memory`, `munin_retrieve_memory`, and `munin_search_memories` actions are registered as native tools (MCP). 
+You MUST call them using your standard tool-calling interface (e.g. `callTool("munin_search_memories", {...})`). 
+**DO NOT under any circumstances try to run them as shell commands or bash scripts.**
+</CRITICAL-INSTRUCTION>
+
 Your agent forgets everything the moment you close the tab. You've seen the "pro" solutions—Mem0, Zep, LangMem—and you've seen their **$20/month** price tags. 
 
 We think that's insane. 
@@ -50,14 +57,13 @@ 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:** 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:
+2. **Configure OpenClaw:** Once installed via `openclaw plugins install @kalera/munin-openclaw`, you can set your API key and Context Core ID directly via the OpenClaw CLI without manually editing any config files:
 
    ```bash
    openclaw config set plugins.entries.munin-openclaw.config.apiKey "your-api-key-here"
+   openclaw config set plugins.entries.munin-openclaw.config.projectId "your-context-core-id"
    ```
-   *(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).*
+   *(Alternatively, you can just set `MUNIN_BASE_URL`, `MUNIN_API_KEY`, and `MUNIN_PROJECT` environment variables).*
 
 3. **Profit:** Your agent now has long-term memory. No more repeating yourself.
 

package/dist/index.js

@@ -3,41 +3,39 @@ import { Type } from "@sinclair/typebox";
 import { z } from "zod";
 export default {
     id: "munin-openclaw",
-    name: "Munin ContextKeep",
+    name: "Munin",
     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."),
+            .describe("The base URL for your Munin server."),
         apiKey: z.string().optional().describe("Your API key for Munin."),
+        projectId: z.string().optional().describe("Your Context Core ID (e.g. proj_xxx)."),
     }),
     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.");
+        const projectId = api.pluginConfig?.projectId || process.env.MUNIN_PROJECT;
+        if (!apiKey || !projectId) {
+            api.logger.warn("Munin apiKey or projectId is missing. Munin 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.",
+            description: "Store a new memory or update an existing one in Munin.",
             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;
+            async execute(_toolCallId, payload) {
                 const res = await client.invoke(projectId, "store", payload);
                 return {
                     content: [
@@ -53,15 +51,14 @@ export default {
         api.registerTool({
             name: "munin_retrieve_memory",
             label: "Retrieve Munin Memory",
-            description: "Retrieve a memory by its key from ContextKeep.",
+            description: "Retrieve a memory by its key from Munin.",
             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 { key } = params;
                 const res = await client.invoke(projectId, "retrieve", { key });
                 return {
                     content: [
@@ -77,13 +74,12 @@ export default {
         api.registerTool({
             name: "munin_search_memories",
             label: "Search Munin Memories",
-            description: "Search for memories by key, title, or content in ContextKeep.",
+            description: "Search for memories by key, title, or content in Munin.",
             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 { query } = params;
                 const res = await client.invoke(projectId, "search", { query });
                 return {
                     content: [

package/openclaw.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "munin-openclaw",
-  "name": "Munin ContextKeep",
+  "name": "Munin",
   "description": "Persistent memory and Context Core for OpenClaw agents.",
   "kind": "memory",
   "configSchema": {
@@ -10,11 +10,15 @@
       "baseUrl": {
         "type": "string",
         "default": "https://munin.kalera.dev",
-        "description": "The base URL for your Munin ContextKeep server."
+        "description": "The base URL for your Munin server."
       },
       "apiKey": {
         "type": "string",
         "description": "Your API key for Munin."
+      },
+      "projectId": {
+        "type": "string",
+        "description": "Your Context Core ID (e.g. proj_xxx)."
       }
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kalera/munin-openclaw",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "type": "module",
   "openclaw": {
     "extensions": [
@@ -16,8 +16,8 @@
   "dependencies": {
     "@sinclair/typebox": "^0.34.49",
     "zod": "^4.3.6",
-    "@kalera/munin-sdk": "1.0.0",
-    "@kalera/munin-runtime": "1.0.0"
+    "@kalera/munin-sdk": "1.0.1",
+    "@kalera/munin-runtime": "1.0.1"
   },
   "devDependencies": {
     "openclaw": "^2026.3.28",

package/postinstall.js

@@ -1,6 +1,7 @@
 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[1m🐦 Munin 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-openclaw.config.apiKey "YOUR_API_KEY_HERE"\x1b[0m\n');
+console.log('\x1b[33m  openclaw config set plugins.entries.munin-openclaw.config.apiKey "YOUR_API_KEY_HERE"\x1b[0m');
+console.log('\x1b[33m  openclaw config set plugins.entries.munin-openclaw.config.projectId "YOUR_CONTEXT_CORE_ID"\x1b[0m\n');
 console.log('Get your free API key at: \x1b[32mhttps://munin.kalera.dev\x1b[0m\n');

package/src/index.ts

@@ -4,15 +4,16 @@ import { z } from "zod";
 
 export default {
   id: "munin-openclaw",
-  name: "Munin ContextKeep",
+  name: "Munin",
   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."),
+      .describe("The base URL for your Munin server."),
     apiKey: z.string().optional().describe("Your API key for Munin."),
+    projectId: z.string().optional().describe("Your Context Core ID (e.g. proj_xxx)."),
   }) as any,
   register(api: any) {
     const baseUrl =
@@ -21,10 +22,12 @@ export default {
       "https://munin.kalera.dev";
     const apiKey =
       (api.pluginConfig?.apiKey as string) || process.env.MUNIN_API_KEY;
+    const projectId =
+      (api.pluginConfig?.projectId as string) || process.env.MUNIN_PROJECT;
 
-    if (!apiKey) {
+    if (!apiKey || !projectId) {
       api.logger.warn(
-        "Munin API key is missing. ContextKeep tools will not be registered.",
+        "Munin apiKey or projectId is missing. Munin tools will not be registered.",
       );
       return;
     }
@@ -34,11 +37,8 @@ export default {
     api.registerTool({
       name: "munin_store_memory",
       label: "Store Munin Memory",
-      description: "Store a new memory or update an existing one in ContextKeep.",
+      description: "Store a new memory or update an existing one in Munin.",
       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(
@@ -48,8 +48,7 @@ export default {
           Type.String({ description: "Human-readable title." }),
         ),
       }),
-      async execute(_toolCallId: string, params: any) {
-        const { projectId, ...payload } = params;
+      async execute(_toolCallId: string, payload: any) {
         const res = await client.invoke(projectId, "store", payload);
         return {
           content: [
@@ -66,15 +65,14 @@ export default {
     api.registerTool({
       name: "munin_retrieve_memory",
       label: "Retrieve Munin Memory",
-      description: "Retrieve a memory by its key from ContextKeep.",
+      description: "Retrieve a memory by its key from Munin.",
       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 { key } = params;
         const res = await client.invoke(projectId, "retrieve", { key });
         return {
           content: [
@@ -91,13 +89,12 @@ export default {
     api.registerTool({
       name: "munin_search_memories",
       label: "Search Munin Memories",
-      description: "Search for memories by key, title, or content in ContextKeep.",
+      description: "Search for memories by key, title, or content in Munin.",
       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 { query } = params;
         const res = await client.invoke(projectId, "search", { query });
         return {
           content: [