{"_id":"@aionis/openclaw","_rev":"4-33c0eb2368b461d56410054c9dbf0106","name":"@aionis/openclaw","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.1":{"name":"@aionis/openclaw","version":"0.1.1","keywords":["openclaw","aionis","memory","agent","plugin"],"license":"Apache-2.0","_id":"@aionis/openclaw@0.1.1","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":"bbffa8c8802de28c8bf8fd1b4e0bc2dd4776dcb0","tarball":"https://registry.npmjs.org/@aionis/openclaw/-/openclaw-0.1.1.tgz","fileCount":7,"integrity":"sha512-/7PTyzE2L27YiGZ5nuVKVZbq3o771HxSYI+sHuXiDgOJ/vD7t62IDhYzAEuEYxhGkSuT5RWP+21wQNe8OdVkxQ==","signatures":[{"sig":"MEUCIAQm7Er6v6KLXe1PvGGo5NvbFhR3RnHfHUVGUslhwR9NAiEAtkVDcpv4SCg6TE4vxdBSDtP4ioNDo0HQAC7KY3JEbKs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63467},"main":"dist/index.js","type":"module","gitHead":"779a7441880f99b45c35d14b8cb695d06860cade","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_0.1.1_1772636130089_0.09024717830728779","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Deprecated: use @aionis/openclaw-aionis-memory instead. Install with: openclaw plugins install @aionis/openclaw-aionis-memory@0.1.3"},"0.1.2":{"name":"@aionis/openclaw","version":"0.1.2","keywords":["openclaw","aionis","memory","agent","plugin"],"license":"Apache-2.0","_id":"@aionis/openclaw@0.1.2","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":"92c792a58c939856ca7fbe3f073a47e6ed2c9594","tarball":"https://registry.npmjs.org/@aionis/openclaw/-/openclaw-0.1.2.tgz","fileCount":7,"integrity":"sha512-mprUC3+Af1vbvBMRj84rIQzfbGiwLe0M5tooEFmBYHj2OwRf+VBpuv2LlPpsFpUAzOd8o4V08UPt2mOPoZgDeA==","signatures":[{"sig":"MEYCIQDpgw1MovgxA3+ZfteNIOc0aReVC4vdMZElosQ0SxwFaQIhAO97KEqhdS5xtGHOG//ULYP7QDw3ghOx4abM6104ti33","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":118234},"main":"dist/index.js","type":"module","gitHead":"1d64b06234cf28087a96368c5aa36203e7fa73b7","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_0.1.2_1772688847725_0.4274205299923859","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Deprecated: use @aionis/openclaw-aionis-memory instead. Install with: openclaw plugins install @aionis/openclaw-aionis-memory@0.1.3"},"0.1.3":{"name":"@aionis/openclaw","version":"0.1.3","keywords":["openclaw","aionis","memory","agent","plugin"],"license":"Apache-2.0","_id":"@aionis/openclaw@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":"6f1e1a3be37bea53d681add2b8d768cbda01e3fb","tarball":"https://registry.npmjs.org/@aionis/openclaw/-/openclaw-0.1.3.tgz","fileCount":7,"integrity":"sha512-t566FdFBa7cmuQoW4Sx3zq1pbbNhtWaug0C3GlFzsgayABG07T3tPH+ubLOaGO0UYhMyr+tmVbXS1Vlq4Ir7cg==","signatures":[{"sig":"MEUCIDGng44yYWO3k1fV7FHJ18oKuAXboyBlp3Hmf9Y19yLMAiEA5KdR4BAHIbbX6ifA3nLlu6faoIdTfNLVkAF4ou0/+Q4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":128083},"main":"dist/index.js","type":"module","gitHead":"46e2031b28ec5346850c6c39abcb03c5ae313140","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_0.1.3_1772717833200_0.942734639221537","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Deprecated: use @aionis/openclaw-aionis-memory instead. Install with: openclaw plugins install @aionis/openclaw-aionis-memory@0.1.3"}},"time":{"created":"2026-03-04T14:55:29.977Z","modified":"2026-03-06T12:35:14.511Z","0.1.1":"2026-03-04T14:55:30.224Z","0.1.2":"2026-03-05T05:34:07.891Z","0.1.3":"2026-03-05T13:37:13.350Z"},"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":{"url":"git+https://github.com/Cognary/aionis-openclaw-plugin.git","type":"git"},"description":"OpenClaw memory plugin powered by Aionis standalone or hosted API","maintainers":[{"name":"fielddd","email":"heyopscc@gmail.com"}],"readme":"# OpenClaw Aionis Memory Plugin\n\n[![npm version](https://img.shields.io/npm/v/%40aionis%2Fopenclaw.svg)](https://www.npmjs.com/package/@aionis/openclaw)\n[![npm downloads](https://img.shields.io/npm/dm/%40aionis%2Fopenclaw.svg)](https://www.npmjs.com/package/@aionis/openclaw)\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  \nReleases: https://github.com/Cognary/aionis-openclaw-plugin/releases\n\nMost agent memory plugins only store chat history.\n\nAionis goes further.\n\nIt turns memory into an execution loop:\n\n`Memory -> Policy -> Action -> Replay`\n\nYour agent does not just remember.\nIt learns how to act better over time.\n\nAionis is production memory infrastructure for agents.\n\nThis plugin brings Aionis into OpenClaw (including Clawbot) and turns memory into an executable loop:\n\n`Memory -> Policy -> Action -> Replay`\n\n## What's new in v0.1.2\n\n- Replay execution integration expanded for Clawbot workflows and repair-review controls.\n- Replay selfcheck improved with strict/guided mode checks and stronger status gating.\n- Local standalone bootstrap defaults aligned to Aionis `standalone-v0.2.16`.\n- Public landing page added and deployed on GitHub Pages.\n\n## Why Aionis\n\nMost memory stacks stop at retrieval. Production teams still need:\n\n- auditable and replayable writes\n- reliable write paths decoupled from embedding availability\n- policy loops that can influence runtime behavior\n- operational guardrails for long-running systems\n\nAionis is designed as a long-running memory kernel to address those requirements.\n\n## Core strengths\n\n1. Verifiable write chain\n- Every write can be traced with `commit_id` and `commit_uri`.\n\n2. URI-first object model\n- Nodes, edges, commits, and decisions are referenceable via stable URIs across API/SDK/Ops.\n\n3. Layered context orchestration\n- Context is assembled in explicit layers: `facts / episodes / rules / decisions / tools / citations`, with budget controls.\n\n4. Memory to policy loop\n- Memory can affect routing and execution using `tools/select` and `tools/feedback`.\n\n5. Production evidence and gates\n- Readiness is validated through reproducible checks, runbooks, and benchmark artifacts.\n\n6. Sandbox interfaces (experimental in Aionis core)\n- Controlled sandbox APIs can be linked to policy/replay lineage.\n\n## What this plugin does\n\n- Auto recall on `before_agent_start` with `POST /v1/memory/context/assemble`\n- Auto capture on `agent_end` with `POST /v1/memory/write`\n- Auto policy feedback on successful turns with `POST /v1/memory/tools/feedback`\n- Exposes policy actions: `POST /v1/memory/tools/select`, `POST /v1/memory/tools/decision`, `POST /v1/memory/tools/run`, `POST /v1/memory/tools/feedback`\n- Exposes replay actions:\n  - record: `POST /v1/memory/replay/run/start`, `step/before`, `step/after`, `run/end`\n  - query/compile: `POST /v1/memory/replay/runs/get`, `playbooks/compile_from_run`, `playbooks/get`\n  - lifecycle/run: `POST /v1/memory/replay/playbooks/promote`, `playbooks/repair`, `playbooks/repair/review`, `playbooks/run`\n- Manual tools:\n  - memory/policy: `aionis_memory_search`, `aionis_memory_store`, `aionis_memory_context`, `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## 30-second setup\n\n```bash\nopenclaw plugins install @aionis/openclaw && \\\nopenclaw aionis-memory bootstrap && \\\nopenclaw aionis-memory selfcheck --scope clawbot:selfcheck\n```\n\nReplay path selfcheck (all modes):\n\n```bash\nopenclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode simulate\nopenclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode strict --backend local_process\nopenclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode guided --backend sandbox_sync --project-id clawbot-demo\n```\n\nToken usage telemetry (v0.2.16+):\n\n- `replay-selfcheck` output now includes compile/replay usage fields when available.\n- `playbooks/compile_from_run` usage currently comes from `estimated_char_based_v1` (estimated tokens, not provider billing tokens).\n\n## Clawbot user flow (recommended)\n\n1. Install and bootstrap:\n\n```bash\nopenclaw plugins install @aionis/openclaw\nopenclaw aionis-memory bootstrap\n```\n\n2. Enable plugin slot and defaults:\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.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 + replay path:\n\n```bash\nopenclaw aionis-memory selfcheck --scope clawbot:selfcheck\nopenclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode strict --backend local_process\n```\n\n4. Use in Clawbot chat:\n\n- Normal chat auto-runs `recall -> capture -> policy feedback`.\n- Replay lifecycle can be called with `aionis_replay_*` tools when your agent workflow records/compiles/runs playbooks.\n\nDetailed guide: [USAGE_FULL.md](./USAGE_FULL.md)\n\n## Project isolation in Clawbot\n\nThis plugin isolates memory by `tenant_id + scope`.\n\nDefault mode is `scopeMode=project`:\n\n- It derives workspace path from OpenClaw context (`workspace/cwd`).\n- It generates project scope as: `scopePrefix + \":\" + basename(workspacePath) + \"-\" + sha1(workspacePath)[0:8]`.\n- All write/recall/policy calls use that scope, so different projects 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/repo (recommended)\n\n## Security and contract\n\n- Tenant isolation: `tenant_id + scope`\n- Memory auth: API key and bearer-token modes in Aionis core\n- Admin interface: separate token channel in Aionis core\n- Public API contracts: stable `/v1/memory/*` shapes documented in Aionis docs\n\n## Quick start (local standalone)\n\n1. Start local Aionis standalone:\n\n```bash\n./bootstrap-local-standalone.sh\n```\n\nDefault image: `ghcr.io/cognary/aionis:standalone-v0.2.16`.\n\nIf `3001` is occupied, the script auto-falls back to `3002-3010`.\nYou can also force a port:\n\n```bash\nAIONIS_PORT=3002 ./bootstrap-local-standalone.sh\n```\n\nThis script writes:\n\n- `~/.openclaw/plugins/aionis/aionis.env`\n- `~/.openclaw/plugins/aionis/clawbot.env`\n\n2. Install plugin (from npm):\n\n```bash\nopenclaw plugins install @aionis/openclaw\n```\n\n3. Bootstrap plugin config automatically:\n\n```bash\nopenclaw aionis-memory bootstrap\n```\n\n4. Verify end-to-end path (recommended sequence):\n\n```bash\nopenclaw aionis-memory selfcheck --scope clawbot:selfcheck\nopenclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode simulate\nopenclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode strict --backend local_process\nopenclaw aionis-memory replay-selfcheck --scope clawbot:selfcheck --mode guided --backend sandbox_sync --project-id clawbot-demo\n```\n\n## Configuration\n\n- `baseUrl`: Aionis API base URL\n- `apiKey`: API key (`x-api-key`)\n- `tenantId`: tenant id\n- `scope`: default fallback scope\n- `scopeMode`: `fixed`, `session`, `project`\n- `scopePrefix`: prefix for derived scopes\n- `preset`: `compact` (default), `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/context limit\n- `captureMessageLimit`: max recent messages captured\n- `contextCharBudget`: max injected context size\n- `debug`: verbose logs\n\n## Presets\n\n- `compact` (default): lower token budget and lower recall fan-out\n- `policy-first`: larger context and stricter routing defaults\n- `custom`: disable preset defaults and use explicit values\n\n## Troubleshooting\n\n- `404 Route ... not found`: verify Aionis version and `baseUrl`\n- `400 invalid_request`: verify payload and required fields\n- `strict/guided replay run failed`: check sandbox settings (`SANDBOX_ENABLED=true`, local executor policy, command allowlist), and verify `allow_local_exec` (plugin selfcheck auto-enables for strict/guided)\n- Policy feedback logs include: `policy switch reduced` or `policy switch detected`, and `rule confidence updated (updated_rules=...)`\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","readmeFilename":"README.md"}