{"_id":"@aionis/openclaw-aionis-memory","_rev":"2-2db1ad601ad714fd421a1d638b3cf14f","name":"@aionis/openclaw-aionis-memory","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.3":{"name":"@aionis/openclaw-aionis-memory","version":"0.1.3","keywords":["openclaw","aionis","memory","agent","plugin"],"license":"Apache-2.0","_id":"@aionis/openclaw-aionis-memory@0.1.3","maintainers":[{"name":"fielddd","email":"heyopscc@gmail.com"}],"homepage":"https://github.com/Cognary/aionis-openclaw-plugin#readme","bugs":{"url":"https://github.com/Cognary/aionis-openclaw-plugin/issues"},"dist":{"shasum":"6ed70b0b9a1f89ad723e2ffeb3b4dec91b62c1b3","tarball":"https://registry.npmjs.org/@aionis/openclaw-aionis-memory/-/openclaw-aionis-memory-0.1.3.tgz","fileCount":7,"integrity":"sha512-nvyepWe32Ty9CQA1gRWY0jS9vPEgPnYUpFCx5W4YiPsgUIb2mWEovazSt/hgZafj+6lgk1AhLGmgpI1GKmfcZA==","signatures":[{"sig":"MEUCICJsmrYOqcgBL1PrPYJav545r/NM7uGWB0jgy7tn7C8jAiEAui4C8SdhPZ5nxvIdc9kHNzazRVn8KX3JSgQQYNXS+28=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":128577},"main":"dist/index.js","type":"module","gitHead":"da6efb5e915bf911b81466197e8c5c73a57d0525","scripts":{"build":"tsc -p tsconfig.json","clean":"rm -rf dist artifacts/*.tgz","start":"node dist/index.js","prepack":"npm run -s typecheck && npm run -s build","typecheck":"tsc -p tsconfig.json --noEmit","release:tgz":"./scripts/build-tgz.sh","release:preflight":"./scripts/release-preflight.sh"},"_npmUser":{"name":"fielddd","email":"heyopscc@gmail.com"},"openclaw":{"extensions":["./dist/index.js"]},"repository":{"url":"git+https://github.com/Cognary/aionis-openclaw-plugin.git","type":"git"},"_npmVersion":"11.6.2","description":"OpenClaw memory plugin powered by Aionis standalone or hosted API","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.25.76","undici":"^7.16.0","@sinclair/typebox":"^0.34.22"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.2","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/openclaw-aionis-memory_0.1.3_1772800116103_0.9120104574592323","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@aionis/openclaw-aionis-memory","version":"0.2.0","description":"OpenClaw memory plugin powered by Aionis Lite-first replayable execution memory","type":"module","main":"dist/index.js","scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","start":"node dist/index.js","clean":"rm -rf dist artifacts/*.tgz","prepack":"npm run -s typecheck && npm run -s build","release:preflight":"./scripts/release-preflight.sh","release:tgz":"./scripts/build-tgz.sh"},"dependencies":{"@sinclair/typebox":"^0.34.22","undici":"^7.16.0","zod":"^3.25.76"},"devDependencies":{"@types/node":"^24.3.0","typescript":"^5.9.2"},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/Cognary/aionis-openclaw-plugin.git"},"keywords":["openclaw","aionis","memory","agent","plugin"],"openclaw":{"extensions":["./dist/index.js"]},"gitHead":"781caea3232c69a69fff8fd750ad9d6a1f2a95d2","_id":"@aionis/openclaw-aionis-memory@0.2.0","bugs":{"url":"https://github.com/Cognary/aionis-openclaw-plugin/issues"},"homepage":"https://github.com/Cognary/aionis-openclaw-plugin#readme","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-zTbgKnohNVSY4B7fw2BxgLKFH5CGpihDKiCLrnaTZLc0ps7sl3CRD6J3dAS0kPQdEJviUkHPY31inJhKTIa13w==","shasum":"da6567d7407e180dc0cd1359b987a1caaf8172b6","tarball":"https://registry.npmjs.org/@aionis/openclaw-aionis-memory/-/openclaw-aionis-memory-0.2.0.tgz","fileCount":8,"unpackedSize":136299,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQClxL6QPH/as7XH9Gb4nkYb3n+Pvl4ubYtDWcPj+EovSAIhALNimKJvvvtRN3iOPAnW94zAfw1B3ez2/A4JocXppqWs"}]},"_npmUser":{"name":"fielddd","email":"heyopscc@gmail.com"},"directories":{},"maintainers":[{"name":"fielddd","email":"heyopscc@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/openclaw-aionis-memory_0.2.0_1773315698309_0.4906605911313229"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-06T12:28:36.002Z","modified":"2026-03-12T11:41:38.584Z","0.1.3":"2026-03-06T12:28:36.248Z","0.2.0":"2026-03-12T11:41:38.451Z"},"bugs":{"url":"https://github.com/Cognary/aionis-openclaw-plugin/issues"},"license":"Apache-2.0","homepage":"https://github.com/Cognary/aionis-openclaw-plugin#readme","keywords":["openclaw","aionis","memory","agent","plugin"],"repository":{"type":"git","url":"git+https://github.com/Cognary/aionis-openclaw-plugin.git"},"description":"OpenClaw memory plugin powered by Aionis Lite-first replayable execution memory","maintainers":[{"name":"fielddd","email":"heyopscc@gmail.com"}],"readme":"# OpenClaw Aionis Memory Plugin\n\n[![npm version](https://img.shields.io/npm/v/%40aionis%2Fopenclaw-aionis-memory.svg)](https://www.npmjs.com/package/@aionis/openclaw-aionis-memory)\n[![npm downloads](https://img.shields.io/npm/dm/%40aionis%2Fopenclaw-aionis-memory.svg)](https://www.npmjs.com/package/@aionis/openclaw-aionis-memory)\n[![GitHub release](https://img.shields.io/github/v/release/Cognary/aionis-openclaw-plugin)](https://github.com/Cognary/aionis-openclaw-plugin/releases)\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/Cognary/aionis-openclaw-plugin/blob/main/LICENSE)\n\nWebsite: https://clawbot.aionisos.com/  \nNPM: https://www.npmjs.com/package/@aionis/openclaw-aionis-memory  \nReleases: https://github.com/Cognary/aionis-openclaw-plugin/releases\n\nAionis brings replayable execution memory to OpenClaw and Clawbot.\n\nMost memory plugins stop at chat recall.\nAionis adds an execution loop:\n\n`Memory -> Policy -> Action -> Replay`\n\nThis plugin is now **Lite-first**:\n\n- `lite` is the default edition for local Clawbot use\n- Lite runs locally with SQLite and does not require Docker\n- `server` remains available for standalone/self-hosted deployments\n\n## Lite-first refactor status\n\nCurrent branch direction:\n\n- default bootstrap targets `Aionis Lite`\n- plugin health checks now validate edition shape\n- selfcheck and replay-selfcheck report edition-aware health\n- standalone/server mode is still supported through explicit `--edition server`\n\n## Benchmark\n\nReal workflow benchmark (100 runs)\n\n- Baseline success rate: `98%`\n- Replay success rate: `98%`\n- Replay stability: `98%`\n- `9.21x` faster on replay1\n- `19.29x` faster on replay2\n\n## Core capabilities\n\n- Automatic memory recall before agent turns\n- Automatic memory capture after successful turns\n- Automatic policy feedback after successful turns\n- Policy loop tools: `select`, `decision`, `run`, `feedback`\n- Replay lifecycle tools: run record, compile, promote, repair, replay\n- Project-scoped isolation by default (`scopeMode=project`)\n\n## 30-second setup\n\nPrerequisites for the default Lite path:\n\n- OpenClaw installed\n- Node `22+`\n- a local Aionis repo checkout with `npm run start:lite` available\n\nInstall and bootstrap:\n\n```bash\nopenclaw plugins install @aionis/openclaw-aionis-memory\nopenclaw aionis-memory bootstrap --edition lite --aionis-repo ~/Desktop/Aionis\nopenclaw aionis-memory selfcheck --scope clawbot:selfcheck\n```\n\nIf `--aionis-repo` is omitted, bootstrap will try common local paths such as `../Aionis` and `~/Desktop/Aionis`.\n\nReplay path validation:\n\n```bash\nopenclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode simulate\n```\n\nFor current Lite beta, treat `simulate` as the default replay validation path.\nUse `strict` / `guided` with server mode or only after verifying your Lite runtime has a working sandbox executor.\n\n## Clawbot user flow\n\n1. Install plugin and bootstrap Lite:\n\n```bash\nopenclaw plugins install @aionis/openclaw-aionis-memory\nopenclaw aionis-memory bootstrap --edition lite --aionis-repo ~/Desktop/Aionis\n```\n\n2. Enable the plugin as the memory slot:\n\n```bash\nopenclaw config set plugins.entries.openclaw-aionis-memory.enabled true\nopenclaw config set plugins.slots.memory openclaw-aionis-memory\nopenclaw config set plugins.entries.openclaw-aionis-memory.config.edition lite\nopenclaw config set plugins.entries.openclaw-aionis-memory.config.scopeMode project\nopenclaw config set plugins.entries.openclaw-aionis-memory.config.autoRecall true\nopenclaw config set plugins.entries.openclaw-aionis-memory.config.autoCapture true\nopenclaw config set plugins.entries.openclaw-aionis-memory.config.autoPolicyFeedback true\nopenclaw gateway restart\n```\n\n3. Validate memory and replay:\n\n```bash\nopenclaw aionis-memory health\nopenclaw aionis-memory selfcheck --scope clawbot:selfcheck\nopenclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode simulate\n```\n\n4. Use it in normal Clawbot chat:\n\n- normal chat automatically runs `recall -> capture -> policy feedback`\n- replay workflows use the `aionis_replay_*` tool family\n- repeated install/configuration tasks are the strongest Replay fit\n\nDetailed usage: [USAGE_FULL.md](./USAGE_FULL.md)\n\n## Editions\n\n### Lite (default)\n\nUse Lite when you want:\n\n- single-user local runtime\n- SQLite-backed memory and replay\n- no Docker or external Postgres\n- fast local Clawbot iteration\n\nDefault bootstrap:\n\n```bash\nopenclaw aionis-memory bootstrap --edition lite --aionis-repo ~/Desktop/Aionis\n```\n\nHealth shape expected by the plugin:\n\n- `aionis_edition = lite`\n- `memory_store_backend = lite_sqlite`\n\n### Server (advanced)\n\nUse server mode when you want:\n\n- standalone/self-hosted runtime\n- Docker deployment\n- explicit production-style service separation\n\nServer bootstrap:\n\n```bash\nopenclaw aionis-memory bootstrap --edition server\n```\n\nThat path uses [bootstrap-local-standalone.sh](./bootstrap-local-standalone.sh).\n\n## What this plugin exposes\n\nAutomatic hooks:\n\n- `POST /v1/memory/context/assemble`\n- `POST /v1/memory/write`\n- `POST /v1/memory/tools/feedback`\n\nManual tools:\n\n- memory: `aionis_memory_search`, `aionis_memory_store`, `aionis_memory_context`\n- policy: `aionis_policy_select`, `aionis_policy_decision`, `aionis_policy_run`, `aionis_policy_feedback`\n- replay: `aionis_replay_run_start`, `aionis_replay_step_before`, `aionis_replay_step_after`, `aionis_replay_run_end`, `aionis_replay_run_get`, `aionis_replay_playbook_compile`, `aionis_replay_playbook_get`, `aionis_replay_playbook_promote`, `aionis_replay_playbook_repair`, `aionis_replay_playbook_repair_review`, `aionis_replay_playbook_run`\n\n## Project isolation in Clawbot\n\nThis plugin isolates memory by `tenant_id + scope`.\n\nDefault mode is `scopeMode=project`:\n\n- workspace path is derived from OpenClaw context\n- scope format is `scopePrefix + \":\" + basename(workspacePath) + \"-\" + sha1(workspacePath)[0:8]`\n- different repos do not mix memories\n\nOther modes:\n\n- `fixed`: one global scope\n- `session`: one scope per session\n- `project`: one scope per workspace or repo\n\n## Configuration\n\n- `edition`: `lite` or `server`\n- `baseUrl`: Aionis API base URL\n- `apiKey`: optional in local Lite mode, required in server mode\n- `tenantId`: tenant id\n- `scope`: default fallback scope\n- `scopeMode`: `fixed`, `session`, `project`\n- `scopePrefix`: prefix for derived scopes\n- `preset`: `compact`, `policy-first`, `custom`\n- `autoRecall`: inject memory context before each turn\n- `autoCapture`: persist dialogue summary after successful turn\n- `autoPolicyFeedback`: write `tools/feedback` after successful turn\n- `includeShadow`: include shadow rules in policy calls\n- `strictTools`: strict mode for `tools/select`\n- `recallLimit`: recall or context limit\n- `captureMessageLimit`: max recent messages captured\n- `contextCharBudget`: max injected context size\n- `debug`: verbose logs\n\n## Troubleshooting\n\n- `Could not find a local Aionis repo with start:lite`\n  - rerun bootstrap with `--aionis-repo /absolute/path/to/Aionis`\n- `Lite requires Node.js with node:sqlite support`\n  - use Node `22+`\n- `404 Route ... not found`\n  - check `baseUrl`, edition, and Aionis version\n- `health overall_status: fail`\n  - for Lite, verify `aionis_edition=lite` and `memory_store_backend=lite_sqlite`\n- `replay-selfcheck` fails in strict/guided\n  - start with `--mode simulate`\n  - current Lite beta may not support a stable strict/guided local executor path\n  - use server mode when you need strict/guided replay validation\n\n## License\n\nApache License 2.0. See [LICENSE](./LICENSE).\n\n## Release\n\n```bash\nnpm run -s release:preflight\nnpm run -s release:tgz\n```\n\nReference:\n\n- [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md)\n- [USAGE_FULL.md](./USAGE_FULL.md)\n- [AIONIS_LITE_FIRST_REFACTOR.md](./AIONIS_LITE_FIRST_REFACTOR.md)\n","readmeFilename":"README.md"}