@keyoku/openclaw 1.0.0 → 1.1.1

package/dist/migrate-vector-store.js

@@ -0,0 +1,158 @@
+/**
+ * Vector store migration — imports OpenClaw's SQLite-based vector store into Keyoku.
+ *
+ * OpenClaw stores memory chunks in SQLite at ~/.openclaw/memory/<agentId>.sqlite
+ * with a `chunks` table (id, path, source, text, embedding, start_line, end_line).
+ *
+ * This migrator reads the text from each chunk, deduplicates against existing
+ * Keyoku memories, and stores each unique chunk. Embeddings are NOT migrated —
+ * Keyoku re-embeds with its own model.
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+// node:sqlite (DatabaseSync) requires Node >= 22.5.0
+// We use dynamic import so the rest of the plugin works on Node 20+
+async function openSqlite(path) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { DatabaseSync } = await import('node:sqlite');
+        const db = new DatabaseSync(path, { open: true });
+        return {
+            all(sql) {
+                return db.prepare(sql).all();
+            },
+            close() {
+                db.close();
+            },
+        };
+    }
+    catch {
+        throw new Error('Vector store migration requires Node.js >= 22.5.0 (for node:sqlite). ' +
+            'Please upgrade Node.js or export your OpenClaw SQLite data manually.');
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Discover OpenClaw SQLite memory databases.
+ */
+export function discoverVectorDbs(memoryDir) {
+    if (!existsSync(memoryDir))
+        return [];
+    return readdirSync(memoryDir)
+        .filter((f) => f.endsWith('.sqlite'))
+        .map((f) => join(memoryDir, f));
+}
+/**
+ * Migrate a single OpenClaw SQLite vector store into Keyoku.
+ */
+export async function migrateVectorStore(params) {
+    const { client, entityId, sqlitePath, agentId, dryRun = false, batchSize = 20, delayMs = 100, logger = console, } = params;
+    const result = { totalChunks: 0, imported: 0, skipped: 0, errors: 0 };
+    if (!existsSync(sqlitePath)) {
+        logger.warn(`SQLite file not found: ${sqlitePath}`);
+        return result;
+    }
+    const dbName = basename(sqlitePath, '.sqlite');
+    logger.info(`Migrating vector store: ${dbName} (${sqlitePath})`);
+    const db = await openSqlite(sqlitePath);
+    try {
+        // Check if chunks table exists
+        const tables = db.all("SELECT name FROM sqlite_master WHERE type='table' AND name='chunks'");
+        if (tables.length === 0) {
+            logger.warn(`No 'chunks' table found in ${dbName} — skipping`);
+            return result;
+        }
+        // Read all chunks
+        const rows = db.all('SELECT id, path, source, text, start_line, end_line FROM chunks ORDER BY rowid DESC');
+        result.totalChunks = rows.length;
+        logger.info(`Found ${rows.length} chunks in ${dbName}`);
+        let batchCount = 0;
+        for (const row of rows) {
+            // Skip very short chunks
+            if (!row.text || row.text.trim().length < 10) {
+                result.skipped++;
+                continue;
+            }
+            // Build tagged content with source context
+            const locationInfo = row.start_line != null
+                ? ` (lines ${row.start_line}-${row.end_line})`
+                : '';
+            const sourceInfo = row.path || row.source || dbName;
+            const taggedText = `[Migrated from OpenClaw vector store — ${sourceInfo}${locationInfo}]\n${row.text}`;
+            if (dryRun) {
+                logger.info(`[dry-run] Would import: ${row.text.slice(0, 80)}...`);
+                result.imported++;
+                continue;
+            }
+            // Dedup check — search for similar content
+            try {
+                const queryText = row.text.slice(0, 100);
+                const existing = await client.search(entityId, queryText, {
+                    limit: 1,
+                    min_score: 0.95,
+                });
+                if (existing.length > 0) {
+                    result.skipped++;
+                    continue;
+                }
+            }
+            catch {
+                // Search failed — proceed with import anyway
+            }
+            // Store the memory
+            try {
+                await client.remember(entityId, taggedText, {
+                    agent_id: agentId,
+                    source: 'migration:openclaw-vector',
+                });
+                result.imported++;
+                logger.info(`Imported: ${row.text.slice(0, 60)}...`);
+            }
+            catch (err) {
+                logger.warn(`Failed to store chunk ${row.id}: ${String(err)}`);
+                result.errors++;
+            }
+            // Rate limit per batch
+            batchCount++;
+            if (batchCount >= batchSize) {
+                await delay(delayMs);
+                batchCount = 0;
+            }
+        }
+    }
+    finally {
+        db.close();
+    }
+    return result;
+}
+/**
+ * Migrate all OpenClaw vector stores found in a directory.
+ */
+export async function migrateAllVectorStores(params) {
+    const { client, entityId, memoryDir, agentId, dryRun, logger = console } = params;
+    const totals = { totalChunks: 0, imported: 0, skipped: 0, errors: 0 };
+    const dbFiles = discoverVectorDbs(memoryDir);
+    if (dbFiles.length === 0) {
+        logger.info('No OpenClaw SQLite vector stores found.');
+        return totals;
+    }
+    logger.info(`Found ${dbFiles.length} vector store(s) to migrate.`);
+    for (const dbPath of dbFiles) {
+        const result = await migrateVectorStore({
+            client,
+            entityId,
+            sqlitePath: dbPath,
+            agentId,
+            dryRun,
+            logger,
+        });
+        totals.totalChunks += result.totalChunks;
+        totals.imported += result.imported;
+        totals.skipped += result.skipped;
+        totals.errors += result.errors;
+    }
+    return totals;
+}
+//# sourceMappingURL=migrate-vector-store.js.map

package/dist/migrate-vector-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-vector-store.js","sourceRoot":"","sources":["../src/migrate-vector-store.ts"],"names":[],"mappings":"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"}

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA0D5C,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CA6EvE"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8E5C,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAgFvE"}

package/dist/service.js

@@ -3,7 +3,7 @@
  * Starts/stops the Keyoku Go binary as a child process.
  */
 import { spawn } from 'node:child_process';
-import { existsSync, mkdirSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { randomBytes } from 'node:crypto';
 let keyokuProcess = null;
@@ -58,6 +58,27 @@ function ensureDataDir() {
     mkdirSync(dir, { recursive: true });
     return resolve(dir, 'keyoku.db');
 }
+/**
+ * Load key=value pairs from ~/.keyoku/.env if it exists.
+ * These are written by `npx @keyoku/openclaw init` during setup.
+ */
+function loadKeyokuEnv() {
+    const envPath = resolve(process.env.HOME ?? '', '.keyoku', '.env');
+    if (!existsSync(envPath))
+        return {};
+    const vars = {};
+    const content = readFileSync(envPath, 'utf-8');
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eq = trimmed.indexOf('=');
+        if (eq === -1)
+            continue;
+        vars[trimmed.slice(0, eq)] = trimmed.slice(eq + 1);
+    }
+    return vars;
+}
 export function registerService(api, keyokuUrl) {
     api.registerService({
         id: 'keyoku-engine',
@@ -72,12 +93,15 @@ export function registerService(api, keyokuUrl) {
                 api.logger.warn('keyoku: Keyoku binary not found — memory features require Keyoku to be running');
                 return;
             }
-            // Prepare environment
-            const env = { ...process.env };
+            // Prepare environment — merge ~/.keyoku/.env (init-saved keys) with process.env
+            const keyokuEnv = loadKeyokuEnv();
+            const env = { ...keyokuEnv, ...process.env };
             if (!env.KEYOKU_SESSION_TOKEN) {
                 env.KEYOKU_SESSION_TOKEN = randomBytes(16).toString('hex');
                 api.logger.info('keyoku: Generated session token');
             }
+            // Expose token to the host process so the client (index.ts) can authenticate
+            process.env.KEYOKU_SESSION_TOKEN = env.KEYOKU_SESSION_TOKEN;
             if (!env.KEYOKU_DB_PATH) {
                 env.KEYOKU_DB_PATH = ensureDataDir();
                 api.logger.info(`keyoku: Using database at ${env.KEYOKU_DB_PATH}`);

package/dist/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,16 +1,19 @@
 {
   "name": "@keyoku/openclaw",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Keyoku memory plugin for OpenClaw — persistent memory, heartbeat enhancement, and scheduling",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "keyoku-init": "bin/init.js"
+  },
   "scripts": {
     "build": "tsc"
   },
   "dependencies": {
-    "@keyoku/memory": "1.0.0",
-    "@keyoku/types": "1.0.0",
+    "@keyoku/memory": "1.1.1",
+    "@keyoku/types": "1.1.1",
     "@sinclair/typebox": "^0.34.0"
   },
   "peerDependencies": {
@@ -21,8 +24,14 @@
       "optional": true
     }
   },
+  "files": [
+    "dist",
+    "bin",
+    "skills"
+  ],
   "openclaw": {
-    "extensions": ["dist/index.js"]
+    "extensions": ["dist/index.js"],
+    "skills": ["skills/keyoku-memory"]
   },
   "license": "MIT",
   "engines": {

package/skills/keyoku-memory/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: keyoku-memory
+description: Persistent memory system — you remember things about users across conversations
+user-invocable: false
+disable-model-invocation: true
+metadata: {"openclaw":{"always":true,"requires":{"config":["keyoku-memory"]}}}
+---
+
+# Memory System
+
+You have a persistent memory system. It runs quietly in the background — you don't need to think about it, and you should never mention it by name.
+
+## What You Have
+
+- **Long-term memory** across conversations. You remember facts, preferences, relationships, events, and plans about the people you talk to.
+- **Automatic recall** — relevant memories are injected into your context before each response. They appear in `<your-memories>` blocks. Treat them as your own knowledge. Reference them naturally, the way a person recalls things about someone they know.
+- **Periodic check-ins** — a heartbeat system reviews your memory and surfaces things that need attention: deadlines, scheduled tasks, pending work, or context you should be aware of. These arrive in `<heartbeat-signals>` blocks.
+
+## How to Act on Memories
+
+When you see `<your-memories>`:
+- Use the information naturally. Don't say "I see in my records" or "according to my memory." Just know it.
+- If a memory says the user prefers dark mode, and they ask about editor setup, mention dark mode as if you just know that about them.
+
+## How to Act on Heartbeat Signals
+
+When you see `<heartbeat-signals>`:
+
+1. **Read the urgency and mode** at the bottom of the block (e.g., `Urgency: high | Mode: suggest`).
+
+2. **Follow the mode:**
+   - `observe` — Note the information but don't act unless the user asks. Stay quiet.
+   - `suggest` — If something is genuinely useful or time-sensitive, mention it in ONE short sentence. Don't force it.
+   - `act` — Execute the recommended actions. Follow the "Execute These Actions" section.
+
+3. **If there's a "Tell the User" section** — deliver that message naturally, in your own words. Don't quote it verbatim.
+
+4. **If nothing is urgent or new** — reply with `HEARTBEAT_OK`. Do NOT invent things to say. Silence is fine.
+
+5. **Never repeat yourself.** If you already told the user about a deadline, don't mention it again unless something changed.
+
+6. **Never mention the heartbeat system, signals, memory engine, or any internal infrastructure.** The user should experience you as simply attentive and well-informed.
+
+## Memory Tools
+
+You have tools to manage memory directly:
+
+- `memory_search` — Search for specific memories about a user
+- `memory_store` — Explicitly store something the user wants you to remember
+- `memory_forget` — Delete a specific memory
+- `memory_stats` — Check memory statistics
+- `schedule_create` — Create a scheduled reminder (e.g., "remind me in 2 hours")
+- `schedule_list` — List active scheduled reminders
+- `schedule_cancel` — Cancel a scheduled reminder
+
+Use `memory_store` when the user explicitly says "remember this" or shares something clearly important. Don't over-store — the system automatically captures important information from conversations.
+
+Use `schedule_create` when the user says things like "remind me to..." or "check on this in 2 hours." Use natural cron expressions.
+
+## What NOT to Do
+
+- Never say "I'm checking my memory" or "my memory system tells me"
+- Never mention Keyoku, heartbeat signals, memory engines, or any infrastructure
+- Never fabricate memories — only reference what's actually in your context
+- Never repeat heartbeat information you've already shared
+- Don't store trivial information (greetings, filler, "how are you")
+- Don't announce when you're storing or recalling — just do it naturally

package/src/capture.ts

@@ -1,116 +0,0 @@
-/**
- * Heuristic extraction of memorable facts from conversation messages.
- * Only captures from user messages to avoid self-poisoning from model output.
- */
-
-const MEMORY_TRIGGERS = [
-  /remember|don't forget|keep in mind/i,
-  /i (like|prefer|hate|love|want|need|always|never)/i,
-  /my\s+\w+\s+is|is\s+my/i,
-  /decided|will use|going with|chose|switched to/i,
-  /important|critical|must|required/i,
-  /[\w.-]+@[\w.-]+\.\w+/,  // email
-  /\+\d{10,}/,              // phone number
-];
-
-const PROMPT_INJECTION_PATTERNS = [
-  /ignore (all|any|previous|above|prior) instructions/i,
-  /do not follow (the )?(system|developer)/i,
-  /system prompt/i,
-  /<\s*(system|assistant|developer|tool)\b/i,
-];
-
-/**
- * Check if text looks like a prompt injection attempt.
- */
-export function looksLikePromptInjection(text: string): boolean {
-  const normalized = text.replace(/\s+/g, ' ').trim();
-  if (!normalized) return false;
-  return PROMPT_INJECTION_PATTERNS.some((p) => p.test(normalized));
-}
-
-/**
- * Determine if a message should be captured as a memory.
- */
-export function shouldCapture(text: string, maxChars = 2000): boolean {
-  if (text.length < 10 || text.length > maxChars) return false;
-  if (text.includes('<relevant-memories>')) return false;
-  if (text.includes('<heartbeat-signals>')) return false;
-  if (text.startsWith('<') && text.includes('</')) return false;
-  if (looksLikePromptInjection(text)) return false;
-  return MEMORY_TRIGGERS.some((r) => r.test(text));
-}
-
-const SUBSTANTIAL_PATTERNS = [
-  // Decisions and choices
-  /\b(decided|will use|going with|chose|configured|set up|switched to|picked|selected)\b/i,
-  // Summaries and conclusions
-  /\b(summary|conclusion|result|finding|outcome|in short|to summarize|overall)\b/i,
-  // Actions completed
-  /\b(created|built|implemented|fixed|resolved|deployed|installed|migrated|refactored)\b/i,
-  // Explicit memory cues
-  /\b(note|remember|important|key takeaway|keep in mind|for reference|fyi)\b/i,
-  // Architecture and design
-  /\b(architecture|design|pattern|approach|strategy|tradeoff|trade-off)\b/i,
-  // Project structure
-  /\b(directory|folder|file structure|layout|organized|structured)\b/i,
-  // Tech stack and tools
-  /\b(using|stack|framework|library|database|api|endpoint|schema|model)\b/i,
-  // Contains bullet points or numbered lists (likely a list/summary)
-  /^\s*[-*]\s+/m,
-  /^\s*\d+[.)]\s+/m,
-  // Contains code references
-  /`[^`]+`/,
-  // Contains URLs or paths
-  /https?:\/\/\S+/,
-  /\/[\w-]+\/[\w-]+/,
-];
-
-/**
- * Check if text contains substantial information worth capturing.
- * Used for incremental (per-message) capture of assistant output.
- */
-export function hasSubstantialContent(text: string): boolean {
-  if (text.length < 50) return false;
-  return SUBSTANTIAL_PATTERNS.some((p) => p.test(text));
-}
-
-/**
- * Extract capturable text segments from conversation messages.
- * Only processes user messages to avoid self-poisoning.
- */
-export function extractCapturableTexts(messages: unknown[], maxChars = 2000): string[] {
-  const texts: string[] = [];
-
-  for (const msg of messages) {
-    if (!msg || typeof msg !== 'object') continue;
-    const msgObj = msg as Record<string, unknown>;
-
-    // Only capture from user messages
-    if (msgObj.role !== 'user') continue;
-
-    const content = msgObj.content;
-    if (typeof content === 'string') {
-      if (shouldCapture(content, maxChars)) texts.push(content);
-      continue;
-    }
-
-    if (Array.isArray(content)) {
-      for (const block of content) {
-        if (
-          block &&
-          typeof block === 'object' &&
-          'type' in block &&
-          (block as Record<string, unknown>).type === 'text' &&
-          'text' in block &&
-          typeof (block as Record<string, unknown>).text === 'string'
-        ) {
-          const text = (block as Record<string, unknown>).text as string;
-          if (shouldCapture(text, maxChars)) texts.push(text);
-        }
-      }
-    }
-  }
-
-  return texts;
-}

package/src/cli.ts

@@ -1,95 +0,0 @@
-/**
- * CLI subcommand registration for memory management.
- * Registers `memory` command with search, list, stats, clear subcommands.
- */
-
-import type { KeyokuClient } from '@keyoku/memory';
-import type { PluginApi, PluginLogger } from './types.js';
-import { formatMemoryList } from './context.js';
-import { importMemoryFiles } from './migration.js';
-
-// Minimal Commander-like interface for chaining
-interface CommandChain {
-  description(desc: string): CommandChain;
-  command(name: string): CommandChain;
-  argument(name: string, desc: string): CommandChain;
-  option(flags: string, desc: string, defaultVal?: string): CommandChain;
-  action(fn: (...args: unknown[]) => Promise<void> | void): CommandChain;
-}
-
-export function registerCli(api: PluginApi, client: KeyokuClient, entityId: string): void {
-  api.registerCli(
-    ({ program }: { program: unknown; logger: PluginLogger }) => {
-      const prog = program as CommandChain;
-      const memory = prog.command('memory').description('Keyoku memory commands');
-
-      memory
-        .command('search')
-        .description('Search memories')
-        .argument('<query>', 'Search query')
-        .option('--limit <n>', 'Max results', '5')
-        .action(async (query: unknown, opts: unknown) => {
-          const q = query as string;
-          const limit = parseInt((opts as { limit: string }).limit, 10);
-          const results = await client.search(entityId, q, { limit });
-
-          if (results.length === 0) {
-            console.log('No matching memories found.');
-            return;
-          }
-
-          for (const r of results) {
-            console.log(`[${(r.similarity * 100).toFixed(0)}%] ${r.memory.content}`);
-          }
-        });
-
-      memory
-        .command('list')
-        .description('List recent memories')
-        .option('--limit <n>', 'Max results', '20')
-        .action(async (opts: unknown) => {
-          const limit = parseInt((opts as { limit: string }).limit, 10);
-          const memories = await client.listMemories(entityId, limit);
-          console.log(formatMemoryList(memories));
-        });
-
-      memory
-        .command('stats')
-        .description('Show memory statistics')
-        .action(async () => {
-          const stats = await client.getStats(entityId);
-          console.log(`Total: ${stats.total_memories} | Active: ${stats.active_memories}`);
-          console.log(`By type: ${JSON.stringify(stats.by_type)}`);
-          console.log(`By state: ${JSON.stringify(stats.by_state)}`);
-        });
-
-      memory
-        .command('clear')
-        .description('Delete all memories for this entity')
-        .action(async () => {
-          await client.deleteAllMemories(entityId);
-          console.log('All memories cleared.');
-        });
-
-      memory
-        .command('import')
-        .description('Import OpenClaw memory files (MEMORY.md, memory/*.md) into Keyoku')
-        .option('--dir <path>', 'Workspace directory containing memory files', '.')
-        .option('--dry-run', 'Show what would be imported without storing')
-        .action(async (opts: unknown) => {
-          const options = opts as { dir: string; dryRun?: boolean };
-          const result = await importMemoryFiles({
-            client,
-            entityId,
-            workspaceDir: options.dir,
-            dryRun: options.dryRun,
-            logger: console,
-          });
-          console.log(
-            `\nImport complete: ${result.imported} imported, ${result.skipped} skipped, ${result.errors} errors`,
-          );
-        });
-    },
-    { commands: ['memory'] },
-  );
-}

package/src/config.ts

@@ -1,43 +0,0 @@
-/**
- * Plugin configuration types and defaults
- */
-
-export interface KeyokuConfig {
-  /** Keyoku server URL (default: http://localhost:18900) */
-  keyokuUrl?: string;
-  /** Inject relevant memories into prompts automatically (default: true) */
-  autoRecall?: boolean;
-  /** Capture facts from conversations automatically (default: true) */
-  autoCapture?: boolean;
-  /** Enhance heartbeat runs with Keyoku data (default: true) */
-  heartbeat?: boolean;
-  /** Number of memories to inject per prompt (default: 5) */
-  topK?: number;
-  /** Memory namespace — isolates memories per entity (default: agent name) */
-  entityId?: string;
-  /** Agent identifier for memory attribution */
-  agentId?: string;
-  /** Maximum characters to consider for auto-capture (default: 2000) */
-  captureMaxChars?: number;
-  /** Autonomy level for heartbeat actions (default: 'suggest') */
-  autonomy?: 'observe' | 'suggest' | 'act';
-  /** Capture memories incrementally per message (default: true) */
-  incrementalCapture?: boolean;
-}
-
-export const DEFAULT_CONFIG: Required<KeyokuConfig> = {
-  keyokuUrl: 'http://localhost:18900',
-  autoRecall: true,
-  autoCapture: true,
-  heartbeat: true,
-  topK: 5,
-  entityId: '',
-  agentId: '',
-  captureMaxChars: 2000,
-  autonomy: 'suggest',
-  incrementalCapture: true,
-};
-
-export function resolveConfig(config?: KeyokuConfig): Required<KeyokuConfig> {
-  return { ...DEFAULT_CONFIG, ...config };
-}