OpenClaw Aionis Memory Plugin

Website: https://clawbot.aionisos.com/
NPM: https://www.npmjs.com/package/@aionis/openclaw-aionis-memory
Releases: https://github.com/Cognary/aionis-openclaw-plugin/releases

Aionis brings replayable execution memory to OpenClaw and Clawbot.

Most memory plugins stop at chat recall. Aionis adds an execution loop:

Memory -> Policy -> Action -> Replay

This plugin is now Lite-first:

• lite is the default edition for local Clawbot use
• Lite runs locally with SQLite and does not require Docker
• server remains available for standalone/self-hosted deployments

Lite-first refactor status

Current branch direction:

• default bootstrap targets Aionis Lite
• plugin health checks now validate edition shape
• selfcheck and replay-selfcheck report edition-aware health
• standalone/server mode is still supported through explicit --edition server

Benchmark

Real workflow benchmark (100 runs)

• Baseline success rate: 98%
• Replay success rate: 98%
• Replay stability: 98%
• 9.21x faster on replay1
• 19.29x faster on replay2

Core capabilities

• Automatic memory recall before agent turns
• Automatic memory capture after successful turns
• Automatic policy feedback after successful turns
• Policy loop tools: select, decision, run, feedback
• Replay lifecycle tools: run record, compile, promote, repair, replay
• Project-scoped isolation by default (scopeMode=project)

30-second setup

Prerequisites for the default Lite path:

• OpenClaw installed
• Node 22+
• a local Aionis repo checkout with npm run start:lite available

Install and bootstrap:

openclaw plugins install @aionis/openclaw-aionis-memory
openclaw aionis-memory bootstrap --edition lite --aionis-repo ~/Desktop/Aionis
openclaw aionis-memory selfcheck --scope clawbot:selfcheck

If --aionis-repo is omitted, bootstrap will try common local paths such as ../Aionis and ~/Desktop/Aionis.

Replay path validation:

openclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode simulate

For current Lite beta, treat simulate as the default replay validation path. Use strict / guided with server mode or only after verifying your Lite runtime has a working sandbox executor.

Clawbot user flow

1. Install plugin and bootstrap Lite:

openclaw plugins install @aionis/openclaw-aionis-memory
openclaw aionis-memory bootstrap --edition lite --aionis-repo ~/Desktop/Aionis

2. Enable the plugin as the memory slot:

openclaw config set plugins.entries.openclaw-aionis-memory.enabled true
openclaw config set plugins.slots.memory openclaw-aionis-memory
openclaw config set plugins.entries.openclaw-aionis-memory.config.edition lite
openclaw config set plugins.entries.openclaw-aionis-memory.config.scopeMode project
openclaw config set plugins.entries.openclaw-aionis-memory.config.autoRecall true
openclaw config set plugins.entries.openclaw-aionis-memory.config.autoCapture true
openclaw config set plugins.entries.openclaw-aionis-memory.config.autoPolicyFeedback true
openclaw gateway restart

3. Validate memory and replay:

openclaw aionis-memory health
openclaw aionis-memory selfcheck --scope clawbot:selfcheck
openclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode simulate

4. Use it in normal Clawbot chat:

• normal chat automatically runs recall -> capture -> policy feedback
• replay workflows use the aionis_replay_* tool family
• repeated install/configuration tasks are the strongest Replay fit

Detailed usage: USAGE_FULL.md

Editions

Lite (default)

Use Lite when you want:

• single-user local runtime
• SQLite-backed memory and replay
• no Docker or external Postgres
• fast local Clawbot iteration

Default bootstrap:

openclaw aionis-memory bootstrap --edition lite --aionis-repo ~/Desktop/Aionis

Health shape expected by the plugin:

• aionis_edition = lite
• memory_store_backend = lite_sqlite

Server (advanced)

Use server mode when you want:

• standalone/self-hosted runtime
• Docker deployment
• explicit production-style service separation

Server bootstrap:

openclaw aionis-memory bootstrap --edition server

That path uses bootstrap-local-standalone.sh.

What this plugin exposes

Automatic hooks:

• POST /v1/memory/context/assemble
• POST /v1/memory/write
• POST /v1/memory/tools/feedback

Manual tools:

• memory: aionis_memory_search, aionis_memory_store, aionis_memory_context
• policy: aionis_policy_select, aionis_policy_decision, aionis_policy_run, aionis_policy_feedback
• 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

Project isolation in Clawbot

This plugin isolates memory by tenant_id + scope.

Default mode is scopeMode=project:

• workspace path is derived from OpenClaw context
• scope format is scopePrefix + ":" + basename(workspacePath) + "-" + sha1(workspacePath)[0:8]
• different repos do not mix memories

Other modes:

• fixed: one global scope
• session: one scope per session
• project: one scope per workspace or repo

Configuration

• edition: lite or server
• baseUrl: Aionis API base URL
• apiKey: optional in local Lite mode, required in server mode
• tenantId: tenant id
• scope: default fallback scope
• scopeMode: fixed, session, project
• scopePrefix: prefix for derived scopes
• preset: compact, policy-first, custom
• autoRecall: inject memory context before each turn
• autoCapture: persist dialogue summary after successful turn
• autoPolicyFeedback: write tools/feedback after successful turn
• includeShadow: include shadow rules in policy calls
• strictTools: strict mode for tools/select
• recallLimit: recall or context limit
• captureMessageLimit: max recent messages captured
• contextCharBudget: max injected context size
• debug: verbose logs

Troubleshooting

• Could not find a local Aionis repo with start:lite
  • rerun bootstrap with --aionis-repo /absolute/path/to/Aionis
• Lite requires Node.js with node:sqlite support
  • use Node 22+
• 404 Route ... not found
  • check baseUrl, edition, and Aionis version
• health overall_status: fail
  • for Lite, verify aionis_edition=lite and memory_store_backend=lite_sqlite
• replay-selfcheck fails in strict/guided
  • start with --mode simulate
  • current Lite beta may not support a stable strict/guided local executor path
  • use server mode when you need strict/guided replay validation

License

Apache License 2.0. See LICENSE.

Release

npm run -s release:preflight
npm run -s release:tgz

Reference:

• RELEASE_CHECKLIST.md
• USAGE_FULL.md
• AIONIS_LITE_FIRST_REFACTOR.md