@kalera/munin-openclaw 0.1.0

package/.turbo/turbo-build.log

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

package/README.md

@@ -0,0 +1,21 @@
+# Munin Adapter for OpenClaw
+
+## Install
+
+```bash
+pnpm --filter munin/openclaw build
+```
+
+## Run
+
+```bash
+MUNIN_BASE_URL=http://localhost:4000 \
+MUNIN_PROJECT=default \
+munin-openclaw capabilities
+```
+
+```bash
+MUNIN_BASE_URL=http://localhost:4000 \
+MUNIN_PROJECT=default \
+munin-openclaw search '{"query":"munin"}'
+```

package/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: "@kalera/munin-openclaw"
+description: "Munin - The $1.6/mo Persistent Memory for OpenClaw. Stop your agent from having Alzheimer's."
+version: "0.1.0"
+metadata:
+  clawdbot:
+    type: "plugin"
+    permissions:
+      env: ["MUNIN_BASE_URL", "MUNIN_PROJECT", "MUNIN_API_KEY"]
+---
+
+# 🐦 Munin: Reliable Memory for Your OpenClaw Agent
+
+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. 
+
+**Munin (ContextKeep)** is the pragmatic alternative. It’s the "Reliable Friend" that sits on your agent’s shoulder and whispers: *"Hey, remember when pa Kal said he preferred Python over Node last week?"*
+
+### 💰 Why Munin? (The "No-Brainer" Math)
+
+| Feature | Mem0 / Zep | **Munin** |
+| :--- | :--- | :--- |
+| **Monthly Cost** | $19.00 - $249.00 | **$1.60** |
+| **MCP Support** | Mixed | **Native / First-class** |
+| **Self-Hostable** | OSS (Complex) | **Yes (Simple)** |
+| **Bullshit Factor** | High (Enterprise-synergy) | **Zero (Developer-first)** |
+
+**That’s a 10x - 150x price gap.** We aren't building "Enterprise Synergy Platforms". We're building a notebook for your AI.
+
+---
+
+## 🔒 Security & Privacy
+
+**Trust Statement:**
+Data stays where you tell it to stay. If you self-host, it never leaves your server. If you use our cloud, it's encrypted and isolated by project.
+
+**External Endpoints:**
+Data is sent ONLY to your `MUNIN_BASE_URL`. We don't phone home. We don't sell your "memories" to train models.
+
+---
+
+## 🚀 Setup (Fast & Honest)
+
+1. **Get your Munin instance:** Self-host it or grab a cloud key at [munin.ai](https://munin.ai).
+2. **Configure OpenClaw:** Add these to your `.env` or agent config:
+   - `MUNIN_BASE_URL`: Where your Munin lives (e.g., `https://api.munin.ai`).
+   - `MUNIN_PROJECT`: Your project name (e.g., `research-agent`).
+   - `MUNIN_API_KEY`: Your key to the kingdom.
+
+3. **Profit:** Your agent now has long-term memory. No more repeating yourself.
+
+---
+*Built with ❤️ by Kalera for the OpenClaw Ecosystem.*

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,32 @@
+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,
+            project: env.project,
+            timeoutMs: env.timeoutMs,
+        });
+        const result = await executeWithRetry(async () => {
+            if (action === "capabilities") {
+                return { ok: true, data: await adapter.capabilities() };
+            }
+            return adapter.execute(action, payload);
+        }, 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/dist/index.d.ts

@@ -0,0 +1,9 @@
+export declare function createOpenClawMuninAdapter(config: {
+    baseUrl: string;
+    apiKey?: string;
+    project: string;
+    timeoutMs?: number;
+}): {
+    execute: (action: string, payload: Record<string, unknown>) => Promise<import("@kalera/munin-sdk").MuninResponse<unknown>>;
+    capabilities: () => Promise<import("@kalera/munin-sdk").MuninCapabilities>;
+};

package/dist/index.js

@@ -0,0 +1,8 @@
+import { MuninClient } from "@kalera/munin-sdk";
+export function createOpenClawMuninAdapter(config) {
+    const client = new MuninClient(config);
+    return {
+        execute: (action, payload) => client.invoke(action, payload, { ensureCapability: true }),
+        capabilities: () => client.capabilities(),
+    };
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@kalera/munin-openclaw",
+  "version": "0.1.0",
+  "type": "module",
+  "openclaw": {
+    "extensions": [
+      "./dist/cli.js"
+    ],
+    "requires": {
+      "env": [
+        "MUNIN_BASE_URL",
+        "MUNIN_PROJECT"
+      ]
+    }
+  },
+  "bin": {
+    "munin-openclaw": "dist/cli.js"
+  },
+  "dependencies": {
+    "@kalera/munin-sdk": "0.1.0",
+    "@kalera/munin-runtime": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "echo 'adapter-openclaw tests: pending'"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,47 @@
+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,
+      project: env.project,
+      timeoutMs: env.timeoutMs,
+    });
+
+    const result = await executeWithRetry(async () => {
+      if (action === "capabilities") {
+        return { ok: true, data: await adapter.capabilities() };
+      }
+      return adapter.execute(action, payload);
+    }, 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/index.ts

@@ -0,0 +1,16 @@
+import { MuninClient } from "@kalera/munin-sdk";
+
+export function createOpenClawMuninAdapter(config: {
+  baseUrl: string;
+  apiKey?: string;
+  project: string;
+  timeoutMs?: number;
+}) {
+  const client = new MuninClient(config);
+
+  return {
+    execute: (action: string, payload: Record<string, unknown>) =>
+      client.invoke(action as any, payload, { ensureCapability: true }),
+    capabilities: () => client.capabilities(),
+  };
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}