memory-mimir 2.5.8 → 2.5.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.d.ts +2 -3
- package/dist/cli.js +30 -105
- package/dist/cli.js.map +1 -1
- package/openclaw.plugin.json +1 -0
- package/package.json +2 -1
- package/skills/mimir-memory/SKILL.md +233 -0
package/dist/cli.d.ts
CHANGED
|
@@ -3,8 +3,7 @@
|
|
|
3
3
|
* memory-mimir CLI — standalone installer for OpenClaw.
|
|
4
4
|
*
|
|
5
5
|
* Usage:
|
|
6
|
-
* npx memory-mimir
|
|
7
|
-
* npx memory-mimir
|
|
8
|
-
* npx memory-mimir setup --api-key sk-mimir-xxx # use existing API key
|
|
6
|
+
* npx memory-mimir setup --api-key sk-mimir-xxx # install with API key
|
|
7
|
+
* npx memory-mimir install # install plugin files only
|
|
9
8
|
*/
|
|
10
9
|
export {};
|
package/dist/cli.js
CHANGED
|
@@ -3,26 +3,24 @@
|
|
|
3
3
|
* memory-mimir CLI — standalone installer for OpenClaw.
|
|
4
4
|
*
|
|
5
5
|
* Usage:
|
|
6
|
-
* npx memory-mimir
|
|
7
|
-
* npx memory-mimir
|
|
8
|
-
* npx memory-mimir setup --api-key sk-mimir-xxx # use existing API key
|
|
6
|
+
* npx memory-mimir setup --api-key sk-mimir-xxx # install with API key
|
|
7
|
+
* npx memory-mimir install # install plugin files only
|
|
9
8
|
*/
|
|
10
9
|
import * as fs from "node:fs";
|
|
11
10
|
import * as path from "node:path";
|
|
12
11
|
import * as os from "node:os";
|
|
13
|
-
import * as readline from "node:readline";
|
|
14
12
|
import { fileURLToPath } from "node:url";
|
|
15
13
|
import { MimirClient } from "./mimir-client.js";
|
|
16
14
|
const __filename = fileURLToPath(import.meta.url);
|
|
17
15
|
const __dirname = path.dirname(__filename);
|
|
18
16
|
const PACKAGE_ROOT = path.resolve(__dirname, "..");
|
|
19
17
|
const DEFAULT_URL = "https://api.allinmimir.com";
|
|
18
|
+
const SIGNUP_URL = "https://www.allinmimir.com";
|
|
20
19
|
function parseArgs(argv) {
|
|
21
20
|
const args = argv.slice(2); // skip node + script
|
|
22
|
-
const command = args[0] ?? "
|
|
21
|
+
const command = args[0] ?? "";
|
|
23
22
|
let url = DEFAULT_URL;
|
|
24
23
|
let apiKey = "";
|
|
25
|
-
let code = "";
|
|
26
24
|
let skipVerify = false;
|
|
27
25
|
for (let i = 1; i < args.length; i++) {
|
|
28
26
|
if (args[i] === "--url" && args[i + 1]) {
|
|
@@ -32,14 +30,11 @@ function parseArgs(argv) {
|
|
|
32
30
|
args[i + 1]) {
|
|
33
31
|
apiKey = args[++i];
|
|
34
32
|
}
|
|
35
|
-
else if (args[i] === "--code" && args[i + 1]) {
|
|
36
|
-
code = args[++i];
|
|
37
|
-
}
|
|
38
33
|
else if (args[i] === "--skip-verify") {
|
|
39
34
|
skipVerify = true;
|
|
40
35
|
}
|
|
41
36
|
}
|
|
42
|
-
return { command, url, apiKey,
|
|
37
|
+
return { command, url, apiKey, skipVerify };
|
|
43
38
|
}
|
|
44
39
|
function readConfig(configPath) {
|
|
45
40
|
try {
|
|
@@ -258,32 +253,6 @@ Match the user's language. Keep it short. Do NOT repeat onboarding in later conv
|
|
|
258
253
|
| Store every single thing the user says | Let auto-capture handle it |
|
|
259
254
|
| "Do you want me to remember that?" | If it's important, just remember |
|
|
260
255
|
| Show raw memory entries to the user | Paraphrase and integrate naturally |
|
|
261
|
-
|
|
262
|
-
---
|
|
263
|
-
|
|
264
|
-
## 7. Installation
|
|
265
|
-
|
|
266
|
-
When the user asks you to install Mimir (or provides an invite code), run:
|
|
267
|
-
|
|
268
|
-
\\\`\\\`\\\`bash
|
|
269
|
-
npx memory-mimir@latest init --code <INVITE_CODE>
|
|
270
|
-
\\\`\\\`\\\`
|
|
271
|
-
|
|
272
|
-
This single command does everything:
|
|
273
|
-
1. Activates the invite code on the server and creates a device key
|
|
274
|
-
2. Installs the plugin to \\\`~/.openclaw/extensions/memory-mimir/\\\`
|
|
275
|
-
3. Writes the config to \\\`~/.openclaw/openclaw.json\\\`
|
|
276
|
-
4. Installs this SKILL to \\\`~/.openclaw/skills/memory-mimir/\\\`
|
|
277
|
-
|
|
278
|
-
After the command succeeds, tell the user to **restart the AI agent** (restart OpenClaw / restart the chat). Memory will be active on next conversation.
|
|
279
|
-
|
|
280
|
-
If the user already has an API key (from the dashboard), use:
|
|
281
|
-
|
|
282
|
-
\\\`\\\`\\\`bash
|
|
283
|
-
npx memory-mimir@latest setup --api-key <API_KEY>
|
|
284
|
-
\\\`\\\`\\\`
|
|
285
|
-
|
|
286
|
-
**Important**: Always use \\\`@latest\\\` to ensure the newest version is installed.
|
|
287
256
|
`;
|
|
288
257
|
function installSkill() {
|
|
289
258
|
try {
|
|
@@ -309,6 +278,13 @@ function installPlugin() {
|
|
|
309
278
|
// Copy manifest + package.json
|
|
310
279
|
fs.copyFileSync(path.join(PACKAGE_ROOT, "openclaw.plugin.json"), path.join(extensionDir, "openclaw.plugin.json"));
|
|
311
280
|
fs.copyFileSync(path.join(PACKAGE_ROOT, "package.json"), path.join(extensionDir, "package.json"));
|
|
281
|
+
// Copy skills/ (plugin-contributed SKILL.md for persistent discovery)
|
|
282
|
+
const skillsSrc = path.join(PACKAGE_ROOT, "skills");
|
|
283
|
+
if (fs.existsSync(skillsSrc)) {
|
|
284
|
+
fs.cpSync(skillsSrc, path.join(extensionDir, "skills"), {
|
|
285
|
+
recursive: true,
|
|
286
|
+
});
|
|
287
|
+
}
|
|
312
288
|
// Copy node_modules/ (runtime dependencies)
|
|
313
289
|
const nmSrc = path.join(PACKAGE_ROOT, "node_modules");
|
|
314
290
|
if (fs.existsSync(nmSrc)) {
|
|
@@ -324,7 +300,7 @@ function installPlugin() {
|
|
|
324
300
|
}
|
|
325
301
|
function printSuccess() {
|
|
326
302
|
console.log(`
|
|
327
|
-
✅ Memory activated! Restart
|
|
303
|
+
✅ Memory activated! Restart your AI agent to start.
|
|
328
304
|
|
|
329
305
|
After restart, try:
|
|
330
306
|
- Introduce yourself (name, job, interests) — I'll remember
|
|
@@ -334,70 +310,24 @@ function printSuccess() {
|
|
|
334
310
|
Chat normally — important details are captured automatically.
|
|
335
311
|
`);
|
|
336
312
|
}
|
|
337
|
-
function
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
});
|
|
345
|
-
return new Promise((resolve) => {
|
|
346
|
-
rl.question("\x1b[1m Enter invite code (or press Enter to skip): \x1b[0m", (answer) => {
|
|
347
|
-
rl.close();
|
|
348
|
-
resolve(answer.trim());
|
|
349
|
-
});
|
|
350
|
-
});
|
|
351
|
-
}
|
|
352
|
-
async function cmdInit(url, code) {
|
|
353
|
-
// If no code provided, prompt interactively
|
|
354
|
-
if (!code) {
|
|
355
|
-
code = await promptForCode();
|
|
356
|
-
}
|
|
357
|
-
if (!code) {
|
|
358
|
-
console.log(`
|
|
359
|
-
Mimir is in closed beta. You need an invite code to get started.
|
|
360
|
-
Get one at: https://www.allinmimir.com
|
|
313
|
+
function printUsage() {
|
|
314
|
+
console.log(`
|
|
315
|
+
Mimir — Long-term memory for your AI agent.
|
|
316
|
+
|
|
317
|
+
Usage:
|
|
318
|
+
npx memory-mimir setup --api-key <KEY> Install with API key
|
|
319
|
+
npx memory-mimir install Install plugin files only
|
|
361
320
|
|
|
362
|
-
|
|
321
|
+
Get your API key at: ${SIGNUP_URL}
|
|
363
322
|
`);
|
|
364
|
-
process.exit(1);
|
|
365
|
-
}
|
|
366
|
-
code = code.toUpperCase().trim();
|
|
367
|
-
const client = new MimirClient({ url });
|
|
368
|
-
let deviceData;
|
|
369
|
-
try {
|
|
370
|
-
deviceData = await client.deviceInit({ inviteCode: code });
|
|
371
|
-
}
|
|
372
|
-
catch (err) {
|
|
373
|
-
const msg = err instanceof Error ? err.message : String(err);
|
|
374
|
-
if (msg.includes("not found")) {
|
|
375
|
-
console.error("\n ✗ Invalid invite code.\n");
|
|
376
|
-
}
|
|
377
|
-
else if (msg.includes("expired")) {
|
|
378
|
-
console.error("\n ✗ Invite code expired.\n");
|
|
379
|
-
}
|
|
380
|
-
else if (msg.includes("already activated")) {
|
|
381
|
-
console.error("\n ✗ This invite code was already used. Add new devices via Dashboard → API key.\n");
|
|
382
|
-
}
|
|
383
|
-
else if (msg.includes("maximum devices")) {
|
|
384
|
-
console.error("\n ✗ Maximum devices reached. Add new devices via Dashboard → API key.\n");
|
|
385
|
-
}
|
|
386
|
-
else {
|
|
387
|
-
console.error(`\n ✗ ${msg}\n`);
|
|
388
|
-
}
|
|
389
|
-
process.exit(1);
|
|
390
|
-
}
|
|
391
|
-
installPlugin();
|
|
392
|
-
installSkill();
|
|
393
|
-
const configPath = path.join(os.homedir(), ".openclaw", "openclaw.json");
|
|
394
|
-
writeConfig(configPath, deviceData.device_key, url);
|
|
395
|
-
printSuccess();
|
|
396
323
|
}
|
|
397
324
|
async function cmdSetup(url, apiKey, skipVerify) {
|
|
398
325
|
if (!apiKey) {
|
|
399
326
|
console.log(`
|
|
400
|
-
|
|
327
|
+
✗ API key required.
|
|
328
|
+
|
|
329
|
+
Get your API key at: ${SIGNUP_URL}
|
|
330
|
+
Then run: npx memory-mimir setup --api-key <YOUR_KEY>
|
|
401
331
|
`);
|
|
402
332
|
process.exit(1);
|
|
403
333
|
}
|
|
@@ -408,7 +338,8 @@ async function cmdSetup(url, apiKey, skipVerify) {
|
|
|
408
338
|
}
|
|
409
339
|
catch (err) {
|
|
410
340
|
const msg = err instanceof Error ? err.message : String(err);
|
|
411
|
-
console.error(`\n ✗ Invalid API key: ${msg}
|
|
341
|
+
console.error(`\n ✗ Invalid API key: ${msg}`);
|
|
342
|
+
console.error(` Get a valid key at: ${SIGNUP_URL}\n`);
|
|
412
343
|
process.exit(1);
|
|
413
344
|
}
|
|
414
345
|
}
|
|
@@ -419,24 +350,18 @@ async function cmdSetup(url, apiKey, skipVerify) {
|
|
|
419
350
|
printSuccess();
|
|
420
351
|
}
|
|
421
352
|
async function main() {
|
|
422
|
-
const { command, url, apiKey,
|
|
353
|
+
const { command, url, apiKey, skipVerify } = parseArgs(process.argv);
|
|
423
354
|
switch (command) {
|
|
424
|
-
case "init":
|
|
425
|
-
await cmdInit(url, code);
|
|
426
|
-
break;
|
|
427
355
|
case "setup":
|
|
428
356
|
await cmdSetup(url, apiKey, skipVerify);
|
|
429
357
|
break;
|
|
430
358
|
case "install":
|
|
431
359
|
installPlugin();
|
|
432
360
|
installSkill();
|
|
361
|
+
console.log("\n ✅ Plugin files installed.\n");
|
|
433
362
|
break;
|
|
434
363
|
default:
|
|
435
|
-
|
|
436
|
-
console.log(" npx memory-mimir init --code CODE # activate with invite code");
|
|
437
|
-
console.log(" npx memory-mimir init # interactive setup");
|
|
438
|
-
console.log(" npx memory-mimir setup --api-key X # use existing API key");
|
|
439
|
-
console.log(" npx memory-mimir install # install plugin + skill only");
|
|
364
|
+
printUsage();
|
|
440
365
|
process.exit(0);
|
|
441
366
|
}
|
|
442
367
|
}
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAEnD,MAAM,WAAW,GAAG,4BAA4B,CAAC;AACjD,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAEhD,SAAS,SAAS,CAAC,IAAc;IAM/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,GAAG,GAAG,WAAW,CAAC;IACtB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,IACL,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC;YACnD,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EACX,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,eAAe,EAAE,CAAC;YACvC,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,UAAU,CAAC,UAAkB;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAClB,UAAkB,EAClB,MAAc,EACd,QAAgB;IAEhB,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAExC,MAAM,OAAO,GAAI,QAAQ,CAAC,OAAmC,IAAI,EAAE,CAAC;IACpE,MAAM,OAAO,GAAI,OAAO,CAAC,OAAmC,IAAI,EAAE,CAAC;IACnE,MAAM,QAAQ,GAAI,OAAO,CAAC,cAAc,CAA6B,IAAI,EAAE,CAAC;IAC5E,MAAM,SAAS,GAAI,QAAQ,CAAC,MAAkC,IAAI,EAAE,CAAC;IACrE,MAAM,KAAK,GAAI,OAAO,CAAC,KAAiC,IAAI,EAAE,CAAC;IAE/D,qFAAqF;IACrF,MAAM,aAAa,GAAG,OAAO,CAAC,KAA6B,CAAC;IAC5D,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC;QAC3E,UAAU,CAAC,KAAK,GAAG,CAAC,GAAG,QAAQ,EAAE,cAAc,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,aAAa,GAAG;QACpB,GAAG,QAAQ;QACX,OAAO,EAAE;YACP,GAAG,OAAO;YACV,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE;YAC3C,OAAO,EAAE;gBACP,GAAG,OAAO;gBACV,cAAc,EAAE;oBACd,GAAG,QAAQ;oBACX,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE;wBACN,GAAG,SAAS;wBACZ,MAAM;wBACN,QAAQ;wBACR,UAAU,EAAE,IAAI;wBAChB,WAAW,EAAE,IAAI;qBAClB;iBACF;aACF;YACD,GAAG,UAAU;SACd;KACF,CAAC;IAEF,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwKhB,CAAC;AAEF,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,EAAE,CAAC,OAAO,EAAE,EACZ,WAAW,EACX,QAAQ,EACR,cAAc,CACf,CAAC;QACF,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,EAAE,CAAC,OAAO,EAAE,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,CACf,CAAC;QAEF,yBAAyB;QACzB,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,aAAa;QACb,EAAE,CAAC,MAAM,CACP,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAC/B,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;QAEF,+BAA+B;QAC/B,EAAE,CAAC,YAAY,CACb,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,sBAAsB,CAAC,EAC/C,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAChD,CAAC;QACF,EAAE,CAAC,YAAY,CACb,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,EACvC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CACxC,CAAC;QAEF,sEAAsE;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACpD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE;gBACtD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;QAED,4CAA4C;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QACtD,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE;gBACxD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;CASb,CAAC,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CAAC;;;;;;;yBAOW,UAAU;CAClC,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,GAAW,EACX,MAAc,EACd,UAAmB;IAEnB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC;;;yBAGS,UAAU;;CAElC,CAAC,CAAC;QACC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,yBAAyB,UAAU,IAAI,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IACf,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IACzE,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAErC,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YACxC,MAAM;QACR,KAAK,SAAS;YACZ,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;YAC/C,MAAM;QACR;YACE,UAAU,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
package/openclaw.plugin.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "memory-mimir",
|
|
3
|
-
"version": "2.5.
|
|
3
|
+
"version": "2.5.10",
|
|
4
4
|
"description": "Long-term memory for OpenClaw powered by Mimir (graph + vector + BM25)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
},
|
|
13
13
|
"files": [
|
|
14
14
|
"dist",
|
|
15
|
+
"skills",
|
|
15
16
|
"openclaw.plugin.json",
|
|
16
17
|
"README.md"
|
|
17
18
|
],
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mimir-memory
|
|
3
|
+
description: >
|
|
4
|
+
Long-term memory powered by Mimir. You can remember across conversations.
|
|
5
|
+
A <memories> block is automatically injected before each conversation with relevant context.
|
|
6
|
+
You have tools to search deeper and store important facts — use them proactively and silently.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Mimir Memory — Behavioral Guide
|
|
10
|
+
|
|
11
|
+
## Core Principle
|
|
12
|
+
|
|
13
|
+
You have long-term memory. Use it naturally. From the user's perspective, you simply **remember** — never mention tool names, never say "let me search my memory", never expose the mechanics.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. Reading Your Memories
|
|
18
|
+
|
|
19
|
+
Before each conversation, a `<memories>` block may appear with auto-recalled context. Understand its scope:
|
|
20
|
+
|
|
21
|
+
**What auto-recall covers:**
|
|
22
|
+
- Factual records (event_log): things the user did, said, decided
|
|
23
|
+
- Known entities: people, places, projects the user mentioned
|
|
24
|
+
- Relationships: how entities connect to each other
|
|
25
|
+
|
|
26
|
+
**What auto-recall does NOT cover:**
|
|
27
|
+
- Full conversation summaries (episodes) — it never searches these
|
|
28
|
+
- Raw documents — it never searches these
|
|
29
|
+
- Predictions/plans (foresights) — it never searches these
|
|
30
|
+
|
|
31
|
+
**How auto-recall constructs its query:**
|
|
32
|
+
- Short messages (≤100 chars): uses the user's exact words
|
|
33
|
+
- Long messages (>100 chars): extracts up to 8 English keywords, or first 200 chars for Chinese/Japanese/Korean
|
|
34
|
+
- Basic time keywords (昨天, last week, 上个月, etc.) are auto-detected and used as filters
|
|
35
|
+
|
|
36
|
+
**What this means for you:**
|
|
37
|
+
- If the user asks a simple factual question and `<memories>` has the answer → just answer
|
|
38
|
+
- If the user references a past conversation or wants a summary → `<memories>` won't have it, you need to search
|
|
39
|
+
- If the user's message is long/complex → keyword extraction may have missed key terms, consider searching with a focused query
|
|
40
|
+
- If `<memories>` is empty or doesn't match the question → search proactively
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## 2. When to Proactively Search
|
|
45
|
+
|
|
46
|
+
Don't wait for the user to ask you to search. Detect these cues and act silently:
|
|
47
|
+
|
|
48
|
+
### Must search (auto-recall can't help)
|
|
49
|
+
|
|
50
|
+
| Pattern | Why | How to search |
|
|
51
|
+
|---------|-----|---------------|
|
|
52
|
+
| "总结一下我们上次讨论的..." / "summarize what we talked about..." | Needs conversation summaries | `memory_types: ["episode"]` |
|
|
53
|
+
| "我之前发给你的那个文档..." / "that document I shared..." | Needs raw documents | `memory_types: ["raw_doc"]` |
|
|
54
|
+
| References a complex relationship chain | Auto-recall uses fast search without graph traversal | Search without type filter for broadest coverage |
|
|
55
|
+
|
|
56
|
+
### Should search (auto-recall likely insufficient)
|
|
57
|
+
|
|
58
|
+
| Pattern | Why | How to search |
|
|
59
|
+
|---------|-----|---------------|
|
|
60
|
+
| `<memories>` present but doesn't answer the question | Query keywords didn't match | Rephrase with more specific terms |
|
|
61
|
+
| "跟我说说关于 X 的所有事" / "tell me everything about X" | Needs multiple types | Omit memory_types for broadest results |
|
|
62
|
+
| "具体是哪天..." / "exactly when did..." | Needs precise time filtering | Use explicit `start_time`/`end_time` in ISO 8601 |
|
|
63
|
+
| User mentions a person + context auto-recall missed | Auto-recall limited to 12 items | Search with `memory_types: ["entity", "relation"]` and the person's name |
|
|
64
|
+
|
|
65
|
+
### Don't search (auto-recall is enough)
|
|
66
|
+
|
|
67
|
+
- `<memories>` already contains the answer
|
|
68
|
+
- User is asking about something new (not past conversations)
|
|
69
|
+
- User is giving you new information, not asking about old
|
|
70
|
+
|
|
71
|
+
### Query construction tips
|
|
72
|
+
|
|
73
|
+
Extract the core topic from the user's message — don't pass their full sentence:
|
|
74
|
+
|
|
75
|
+
```
|
|
76
|
+
User: "还记得上次我跟你说我想换工作的事吗"
|
|
77
|
+
→ query: "换工作 职业规划"
|
|
78
|
+
|
|
79
|
+
User: "我跟 Caroline 上周讨论的那个设计方案怎么样了"
|
|
80
|
+
→ query: "Caroline 设计方案"
|
|
81
|
+
|
|
82
|
+
User: "what did we decide about the API rate limiting?"
|
|
83
|
+
→ query: "API rate limiting decision"
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
Include: names, dates, topic keywords.
|
|
87
|
+
Avoid: filler words, full sentences, vague references like "that thing".
|
|
88
|
+
|
|
89
|
+
### Time filtering
|
|
90
|
+
|
|
91
|
+
Auto-recall already detects basic patterns (yesterday, 上周, last month). But for precise control:
|
|
92
|
+
|
|
93
|
+
| User says | start_time | end_time |
|
|
94
|
+
|-----------|-----------|---------|
|
|
95
|
+
| "三月份的" | 2026-03-01T00:00:00Z | 2026-03-31T23:59:59Z |
|
|
96
|
+
| "去年夏天" | 2025-06-01T00:00:00Z | 2025-09-01T00:00:00Z |
|
|
97
|
+
| "最近三天" | (3 days ago) | (now) |
|
|
98
|
+
|
|
99
|
+
### memory_types reference
|
|
100
|
+
|
|
101
|
+
| Type | Contains | When to use |
|
|
102
|
+
|------|----------|-------------|
|
|
103
|
+
| `event_log` | Atomic facts, decisions, events with timestamps | "What did I eat Tuesday?" |
|
|
104
|
+
| `entity` | People, places, projects, concepts | "Who is Caroline?" |
|
|
105
|
+
| `relation` | How entities connect | "How do Arthur and Caroline know each other?" |
|
|
106
|
+
| `episode` | Full conversation summaries | "Summarize our Chrome extension discussion" |
|
|
107
|
+
| `raw_doc` | Documents the user shared | "That PDF I sent you" |
|
|
108
|
+
| `foresight` | Plans, predictions, future intentions | "What did I plan for next quarter?" |
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## 3. When to Store
|
|
113
|
+
|
|
114
|
+
**After each conversation, the full dialogue is automatically saved.** You don't need to store what was already said.
|
|
115
|
+
|
|
116
|
+
Use explicit storage ONLY for:
|
|
117
|
+
|
|
118
|
+
- **User explicitly asks**: "记住我不喝咖啡" / "remember I'm allergic to shellfish"
|
|
119
|
+
- **Critical atomic facts** that might get buried in a long conversation: a decision, a deadline, a preference
|
|
120
|
+
|
|
121
|
+
Rules:
|
|
122
|
+
- One fact per store call
|
|
123
|
+
- Include the person's name: "Arthur prefers dark roast coffee" not "prefers dark roast coffee"
|
|
124
|
+
- Don't store things the user just said (auto-capture will save the full conversation)
|
|
125
|
+
- Don't store facts already present in `<memories>`
|
|
126
|
+
- Don't ask "should I remember this?" — if it's clearly important, just store it
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## 4. First Conversation (Onboarding)
|
|
131
|
+
|
|
132
|
+
If no `<memories>` block is present, the user just installed Mimir. Welcome them:
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
记忆已就绪！我现在可以跨对话记住你告诉我的事情了。
|
|
136
|
+
|
|
137
|
+
试试看：
|
|
138
|
+
- **介绍自己** — 告诉我你的名字、职业、兴趣，我会记住
|
|
139
|
+
- **让我记住什么** — 比如"记住我喜欢深色模式"
|
|
140
|
+
- **下次对话验证** — 重启后问"你还记得我吗？"
|
|
141
|
+
|
|
142
|
+
你聊天的重要内容我也会自动捕捉，不用每次都说"记住"。
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
Match the user's language. Keep it short. Do NOT repeat onboarding in later conversations where `<memories>` is present.
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## 5. Using `<memories>` Naturally
|
|
150
|
+
|
|
151
|
+
- Weave memories into your response — don't list them like a database query result
|
|
152
|
+
- If the answer is in `<memories>`, just answer directly — never say "based on my memory records" or "I found in my memory"
|
|
153
|
+
- If `<memories>` conflicts with what the user just said, **trust the user** — they may have changed their mind
|
|
154
|
+
- If `<memories>` is insufficient, search deeper **silently**, then answer
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## 6. Anti-patterns
|
|
159
|
+
|
|
160
|
+
| Never do this | Do this instead |
|
|
161
|
+
|---------------|-----------------|
|
|
162
|
+
| "让我搜索一下记忆..." | Silently search, then answer |
|
|
163
|
+
| "根据我的记忆数据库..." | "你之前提过..." or just answer directly |
|
|
164
|
+
| "I'll use mimir_search to find that" | Just find it and answer |
|
|
165
|
+
| "I found 5 results matching your query" | Synthesize the results into a natural answer |
|
|
166
|
+
| Store every single thing the user says | Let auto-capture handle it |
|
|
167
|
+
| "Do you want me to remember that?" | If it's important, just remember |
|
|
168
|
+
| Show raw memory entries to the user | Paraphrase and integrate naturally |
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## 7. Installation
|
|
173
|
+
|
|
174
|
+
When the user asks you to install Mimir or provides an API key, follow these steps:
|
|
175
|
+
|
|
176
|
+
### Step 1: Check for API key
|
|
177
|
+
|
|
178
|
+
The user must provide a Mimir API key (`sk-mimir-...`). If they don't have one:
|
|
179
|
+
|
|
180
|
+
> 你需要一个 Mimir API key。请访问 https://www.allinmimir.com 注册账号并获取 API key，然后把 key 发给我，我来帮你完成安装。
|
|
181
|
+
|
|
182
|
+
Match the user's language. Wait for them to provide the key before proceeding.
|
|
183
|
+
|
|
184
|
+
### Step 2: Run the installer
|
|
185
|
+
|
|
186
|
+
```bash
|
|
187
|
+
npx memory-mimir@latest setup --api-key <API_KEY>
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
This command:
|
|
191
|
+
1. Verifies the API key against the server
|
|
192
|
+
2. Installs plugin files to `~/.openclaw/extensions/memory-mimir/`
|
|
193
|
+
3. Writes plugin config to `~/.openclaw/openclaw.json`
|
|
194
|
+
|
|
195
|
+
**Note:** If the config write fails (e.g. config-protector is active), proceed to Step 3.
|
|
196
|
+
|
|
197
|
+
### Step 3: Ensure config is written
|
|
198
|
+
|
|
199
|
+
Read `~/.openclaw/openclaw.json` and verify the `memory-mimir` plugin entry exists. If missing, merge the following into it (preserving all existing settings):
|
|
200
|
+
|
|
201
|
+
```json
|
|
202
|
+
{
|
|
203
|
+
"plugins": {
|
|
204
|
+
"enabled": true,
|
|
205
|
+
"slots": {
|
|
206
|
+
"memory": "memory-mimir"
|
|
207
|
+
},
|
|
208
|
+
"entries": {
|
|
209
|
+
"memory-mimir": {
|
|
210
|
+
"enabled": true,
|
|
211
|
+
"config": {
|
|
212
|
+
"apiKey": "<API_KEY>",
|
|
213
|
+
"mimirUrl": "https://api.allinmimir.com",
|
|
214
|
+
"autoRecall": true,
|
|
215
|
+
"autoCapture": true
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
If `openclaw.json` already has a `plugins.allow` array, add `"memory-mimir"` to it.
|
|
224
|
+
|
|
225
|
+
### Step 4: Verify and restart
|
|
226
|
+
|
|
227
|
+
Verify:
|
|
228
|
+
- `~/.openclaw/extensions/memory-mimir/dist/index.js` exists
|
|
229
|
+
- `~/.openclaw/openclaw.json` has the `memory-mimir` entry with a valid apiKey
|
|
230
|
+
|
|
231
|
+
Tell the user to **restart the AI agent**. Memory will be active on next conversation.
|
|
232
|
+
|
|
233
|
+
**Important**: Always use `@latest` to ensure the newest version is installed.
|