@basicmemory/openclaw-basic-memory 0.1.0-alpha.2 → 0.1.0-alpha.8

package/README.md

@@ -55,6 +55,17 @@ If `uv` is not installed, the `bm` CLI setup is skipped gracefully during instal
 bash ~/.openclaw/extensions/openclaw-basic-memory/scripts/setup-bm.sh
 ```
 
+### Basic Memory Cloud
+
+Everything works locally — cloud adds cross-device, team, and production capabilities:
+
+- **Your agent's memory travels with you** — same knowledge graph on laptop, desktop, and hosted environments
+- **Team knowledge sharing** — org workspaces let multiple agents and team members build on a shared knowledge base
+- **Durable memory for production agents** — persistent memory that survives CI teardowns and container restarts
+- **Multi-agent coordination** — multiple agents can read and write to the same graph
+
+Cloud extends local-first — still plain markdown, still yours. Start with a [7-day free trial](https://basicmemory.com) and use code `BMCLAW` for 20% off for 3 months. See [BASIC_MEMORY.md](./BASIC_MEMORY.md) for cloud setup.
+
 ### Development (local directory)
 
 For plugin development, clone and link locally:
@@ -287,17 +298,6 @@ After each agent turn (when `autoCapture: true`), the plugin:
 2. Appends them as timestamped entries to a daily conversation note (`conversations-YYYY-MM-DD`)
 3. Skips very short exchanges (< `captureMinChars` chars each, default 10)
 
-### Basic Memory Cloud
-
-Everything works locally — cloud adds cross-device, team, and production capabilities:
-
-- **Your agent's memory travels with you** — same knowledge graph on laptop, desktop, and hosted environments
-- **Team knowledge sharing** — org workspaces let multiple agents and team members build on a shared knowledge base
-- **Durable memory for production agents** — persistent memory that survives CI teardowns and container restarts
-- **Multi-agent coordination** — multiple agents can read and write to the same graph
-
-Cloud extends local-first — still plain markdown, still yours. Start with a [7-day free trial](https://basicmemory.com) and use code `BMCLAW` for 20% off for 3 months. See [BASIC_MEMORY.md](./BASIC_MEMORY.md) for setup, or visit [basicmemory.com](https://basicmemory.com) for more info.
-
 ## Agent Tools
 
 All content tools accept an optional `project` parameter to operate on a different project than the default (cross-project operations).

package/config.ts

@@ -6,6 +6,11 @@ export type CloudConfig = {
   api_key: string
 }
 
+export type DashboardConfig = {
+  enabled: boolean
+  port: number
+}
+
 export type BasicMemoryConfig = {
   project: string
   bmPath: string
@@ -18,6 +23,7 @@ export type BasicMemoryConfig = {
   recallPrompt: string
   debug: boolean
   cloud?: CloudConfig
+  dashboard: DashboardConfig
 }
 
 const ALLOWED_KEYS = [
@@ -37,6 +43,7 @@ const ALLOWED_KEYS = [
   "recall_prompt",
   "debug",
   "cloud",
+  "dashboard",
 ]
 
 function assertAllowedKeys(
@@ -106,6 +113,22 @@ export function parseConfig(raw: unknown): BasicMemoryConfig {
     }
   }
 
+  let dashboard: DashboardConfig = { enabled: false, port: 3838 }
+  if (
+    cfg.dashboard &&
+    typeof cfg.dashboard === "object" &&
+    !Array.isArray(cfg.dashboard)
+  ) {
+    const d = cfg.dashboard as Record<string, unknown>
+    dashboard = {
+      enabled: typeof d.enabled === "boolean" ? d.enabled : false,
+      port:
+        typeof d.port === "number" && d.port > 0 && d.port < 65536
+          ? d.port
+          : 3838,
+    }
+  }
+
   return {
     project:
       typeof cfg.project === "string" && cfg.project.length > 0
@@ -144,6 +167,7 @@ export function parseConfig(raw: unknown): BasicMemoryConfig {
           : "Check for active tasks and recent activity. Summarize anything relevant to the current session.",
     debug: typeof cfg.debug === "boolean" ? cfg.debug : false,
     cloud,
+    dashboard,
   }
 }
 

package/index.ts

@@ -1,3 +1,4 @@
+import type { Server } from "node:http"
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk"
 import { BmClient } from "./bm-client.ts"
 import { registerCli } from "./commands/cli.ts"
@@ -8,6 +9,7 @@ import {
   parseConfig,
   resolveProjectPath,
 } from "./config.ts"
+import { createDashboardServer } from "./dashboard/server.ts"
 import { buildCaptureHandler } from "./hooks/capture.ts"
 import { buildRecallHandler } from "./hooks/recall.ts"
 import { initLogger, log } from "./logger.ts"
@@ -80,6 +82,8 @@ export default {
     registerCli(api, client, cfg)
 
     // --- Service lifecycle ---
+    let dashboardServer: Server | undefined
+
     api.registerService({
       id: "openclaw-basic-memory",
       start: async (ctx: { config?: unknown; workspaceDir?: string }) => {
@@ -108,10 +112,30 @@ export default {
 
         setWorkspaceDir(workspace)
 
+        // Start dashboard if enabled
+        if (cfg.dashboard.enabled) {
+          dashboardServer = createDashboardServer({
+            port: cfg.dashboard.port,
+            client,
+          })
+          dashboardServer.listen(cfg.dashboard.port, () => {
+            log.info(
+              `dashboard running at http://localhost:${cfg.dashboard.port}`,
+            )
+          })
+        }
+
         log.info("connected — BM MCP stdio session running")
       },
       stop: async () => {
         log.info("stopping BM MCP session...")
+        if (dashboardServer) {
+          await new Promise<void>((resolve) =>
+            dashboardServer?.close(() => resolve()),
+          )
+          dashboardServer = undefined
+          log.info("dashboard stopped")
+        }
         await client.stop()
         log.info("stopped")
       },

package/openclaw.plugin.json

@@ -56,6 +56,11 @@
       "label": "Cloud Backend",
       "help": "Optional cloud backend config (url + api_key). If present, uses cloud instead of local BM.",
       "advanced": true
+    },
+    "dashboard": {
+      "label": "Dashboard",
+      "help": "Web dashboard for visualizing the knowledge graph (enabled, port)",
+      "advanced": true
     }
   },
   "configSchema": {
@@ -76,6 +81,13 @@
           "url": { "type": "string" },
           "api_key": { "type": "string" }
         }
+      },
+      "dashboard": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean" },
+          "port": { "type": "number", "minimum": 1, "maximum": 65535 }
+        }
       }
     },
     "required": []

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@basicmemory/openclaw-basic-memory",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.8",
   "type": "module",
   "description": "Basic Memory plugin for OpenClaw — local-first knowledge graph for agent memory",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/basicmachines-co/openclaw-basic-memory"
+  },
   "files": [
     "index.ts",
     "bm-client.ts",