{"_id":"@bonztm/amm","_rev":"17-dfaf699a6799458e39b3be28cf4bed06","name":"@bonztm/amm","dist-tags":{"latest":"1.4.1"},"versions":{"1.2.0":{"name":"@bonztm/amm","version":"1.2.0","keywords":["openclaw","plugin","memory","amm","agent-memory"],"license":"MIT","_id":"@bonztm/amm@1.2.0","maintainers":[{"name":"bonztm","email":"joshdwells@gmail.com"}],"homepage":"https://github.com/bonztm/agent-memory-manager#readme","bugs":{"url":"https://github.com/bonztm/agent-memory-manager/issues"},"dist":{"shasum":"27309572df9c070e8f8e48c8901d0f9ba7547833","tarball":"https://registry.npmjs.org/@bonztm/amm/-/amm-1.2.0.tgz","fileCount":9,"integrity":"sha512-sdfkUYqIHkEjP5ZgxTPj8Ou6HG2Z0wPBET2f5lTfZpVPDVKRUmjXvkR8M9XpGlyD+Uoop1UZqlBgOzFN8qJSfQ==","signatures":[{"sig":"MEYCIQCba0ihZd+EbdNWhxBkLX0+0h68fgzeA2O1jd+nk1bhmAIhAPAXanlnvDXzBYyk71SMWvASEc/iA8+ve+CfOCRomGUY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38603},"type":"module","gitHead":"09d32f1ce878bd012644b5be41eb81ade4fc9a48","scripts":{"install-plugin":"./install.sh"},"_npmUser":{"name":"bonztm","email":"joshdwells@gmail.com"},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/bonztm/agent-memory-manager.git","type":"git","directory":"examples/openclaw"},"_npmVersion":"11.11.1","description":"AMM memory plugin for OpenClaw — claims the memory slot with memory_search/memory_get tools, ambient recall injection, and conversation event capture.","directories":{},"_nodeVersion":"25.8.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amm_1.2.0_1775073353625_0.7497506556934666","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@bonztm/amm","version":"1.2.1","keywords":["openclaw","plugin","memory","amm","agent-memory"],"license":"MIT","_id":"@bonztm/amm@1.2.1","maintainers":[{"name":"bonztm","email":"joshdwells@gmail.com"}],"homepage":"https://github.com/bonztm/agent-memory-manager#readme","bugs":{"url":"https://github.com/bonztm/agent-memory-manager/issues"},"dist":{"shasum":"fd8188035c4e7768b4f312ebd50030db30d2b3a1","tarball":"https://registry.npmjs.org/@bonztm/amm/-/amm-1.2.1.tgz","fileCount":9,"integrity":"sha512-rstCx79wEGtH7RMKU5S3OczyVLtOqcvrdCEQkX3IV1bZLHfsMbJIqeXoKe0PSxcYjvGDm93XVI54y8I4YxqTUA==","signatures":[{"sig":"MEQCIAZCmbPmOCog7piyr1plRQL+4AIOdqiSR6zKM9y93MatAiBFC0OxYJycxT8XA6VuJ6kgsr4frKm4YliCy6Mvq80xbw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36077},"type":"module","gitHead":"06a9d7f8073856a4672bda95dcb583f83bef25ab","scripts":{"install-plugin":"./install.sh"},"_npmUser":{"name":"bonztm","email":"joshdwells@gmail.com"},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/bonztm/agent-memory-manager.git","type":"git","directory":"examples/openclaw"},"_npmVersion":"11.11.1","description":"AMM memory plugin for OpenClaw — ambient recall injection and conversation event capture.","directories":{},"_nodeVersion":"25.8.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amm_1.2.1_1775084734915_0.42593071447472974","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@bonztm/amm","version":"1.3.0","keywords":["openclaw","plugin","memory","amm","agent-memory"],"license":"MIT","_id":"@bonztm/amm@1.3.0","maintainers":[{"name":"bonztm","email":"joshdwells@gmail.com"}],"homepage":"https://github.com/BonzTM/agent-memory-manager#readme","bugs":{"url":"https://github.com/BonzTM/agent-memory-manager/issues"},"dist":{"shasum":"ceb5f536445b97de2514d0c1c5a53597131f7598","tarball":"https://registry.npmjs.org/@bonztm/amm/-/amm-1.3.0.tgz","fileCount":9,"integrity":"sha512-erVr4t8Ll17Ak4CzKYy2ozux+30tiZVhpOqHFyRRfiQxt38O7+tKRLg4AuKSfT7BuJ4tE+yAPLycH8hWz/Ihjg==","signatures":[{"sig":"MEQCIByqBB2yf4HaKgoOr/ymb3YX8GlXj8+dZsqztrgOsQosAiAVHPNv/HjoxGXuwh8y9kVuvrmj9z0lvaBVva8Kqsbrbw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bonztm%2famm@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":36077},"type":"module","gitHead":"df94b2e2bec16d87d3b53c4362f305ace49c13a3","scripts":{"install-plugin":"./install.sh"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:793cda3a-f95f-47b6-b121-35398a937d0d"}},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/BonzTM/agent-memory-manager.git","type":"git","directory":"examples/openclaw"},"_npmVersion":"11.12.1","description":"AMM memory plugin for OpenClaw — ambient recall injection and conversation event capture.","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amm_1.3.0_1775147677500_0.06043869051035822","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@bonztm/amm","version":"1.3.1","keywords":["openclaw","plugin","memory","amm","agent-memory"],"license":"MIT","_id":"@bonztm/amm@1.3.1","maintainers":[{"name":"bonztm","email":"joshdwells@gmail.com"}],"homepage":"https://github.com/BonzTM/agent-memory-manager#readme","bugs":{"url":"https://github.com/BonzTM/agent-memory-manager/issues"},"dist":{"shasum":"c63da2261c7d2e484821410b4add352c7683f681","tarball":"https://registry.npmjs.org/@bonztm/amm/-/amm-1.3.1.tgz","fileCount":9,"integrity":"sha512-VVGwWu0sfntQGgvktLbT6om7cLSfueXZgJJ3CWKEoCWWuwIYCCFjDuUhLoD2wBFYZvZfckMpmjxtgyJkX1U0Ng==","signatures":[{"sig":"MEUCIQCZBaGorLgfV2xQqoIVSFZbG6jBjlI8l/91Ss+l0sjVdAIgNqPgvzKtAtuy9JwkhhxGBA42Pj0Yf84tPSiBdYkyOQ8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bonztm%2famm@1.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":36077},"type":"module","gitHead":"20113024e9afd93391cdce05a5735aed32166a37","scripts":{"install-plugin":"./install.sh"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:793cda3a-f95f-47b6-b121-35398a937d0d"}},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/BonzTM/agent-memory-manager.git","type":"git","directory":"examples/openclaw"},"_npmVersion":"11.12.1","description":"AMM memory plugin for OpenClaw — ambient recall injection and conversation event capture.","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amm_1.3.1_1775155860268_0.7345440451499363","host":"s3://npm-registry-packages-npm-production"}},"1.3.2":{"name":"@bonztm/amm","version":"1.3.2","keywords":["openclaw","plugin","memory","amm","agent-memory"],"license":"MIT","_id":"@bonztm/amm@1.3.2","maintainers":[{"name":"bonztm","email":"joshdwells@gmail.com"}],"homepage":"https://github.com/BonzTM/agent-memory-manager#readme","bugs":{"url":"https://github.com/BonzTM/agent-memory-manager/issues"},"dist":{"shasum":"1b2cc7b1a0fd177c4f8208ef641d3ff02cf26299","tarball":"https://registry.npmjs.org/@bonztm/amm/-/amm-1.3.2.tgz","fileCount":9,"integrity":"sha512-Zd8eFkKErQ660p3uxtTuHCsbg2yQiegBwhtHyzygW+z/5RdhXPmCmv4nO5dZPbgw2/NI5SDeBGfN234IFtvwNw==","signatures":[{"sig":"MEUCIHPW49IhVyZvVNQZmQ9edb422Ef7az6l95iDRYpagqFvAiEArvTeqFdQbbhIicbkK3GaLeobd74JkaU7IXK8Dd0XX8c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bonztm%2famm@1.3.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":36077},"type":"module","gitHead":"085d8ef5ff683939263882a3d63460d8296572c9","scripts":{"install-plugin":"./install.sh"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:793cda3a-f95f-47b6-b121-35398a937d0d"}},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/BonzTM/agent-memory-manager.git","type":"git","directory":"examples/openclaw"},"_npmVersion":"11.12.1","description":"AMM memory plugin for OpenClaw — ambient recall injection and conversation event capture.","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amm_1.3.2_1775163659689_0.3260924426149905","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"@bonztm/amm","version":"1.4.0","keywords":["openclaw","plugin","memory","amm","agent-memory"],"license":"MIT","_id":"@bonztm/amm@1.4.0","maintainers":[{"name":"bonztm","email":"joshdwells@gmail.com"}],"homepage":"https://github.com/BonzTM/agent-memory-manager#readme","bugs":{"url":"https://github.com/BonzTM/agent-memory-manager/issues"},"dist":{"shasum":"5e328785e60f268d895dc92f69ca66d69302fe12","tarball":"https://registry.npmjs.org/@bonztm/amm/-/amm-1.4.0.tgz","fileCount":9,"integrity":"sha512-0zxPWkZ44PnoK0JdhZ6VjwF3Wq+/kbGANLEKTGKNLVjLkdT0fMmKEKH47FkQmcoU4fX8km1Z2DuVElgn0On9Dw==","signatures":[{"sig":"MEUCIGoHtpXPJYclh+H11qsCJgpwPcrkroOnnBMh4BR7lwAYAiEA82hQbNQhnq9MD8zYvXihGTvfzF9dUsZQ8/qujZHTqNo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bonztm%2famm@1.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":45770},"type":"module","gitHead":"817c351220012089479bbe2ad06adeb69c9b3fa2","scripts":{"install-plugin":"./install.sh"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:12c4957e-7a77-491a-92c9-f64ac567cab6"}},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/BonzTM/agent-memory-manager.git","type":"git","directory":"examples/openclaw"},"_npmVersion":"11.12.1","description":"AMM memory plugin for OpenClaw — ambient recall injection and conversation event capture.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amm_1.4.0_1775331464262_0.38779753027748143","host":"s3://npm-registry-packages-npm-production"}},"1.4.1":{"name":"@bonztm/amm","version":"1.4.1","description":"AMM memory plugin for OpenClaw — ambient recall injection and conversation event capture.","type":"module","openclaw":{"extensions":["./index.ts"]},"scripts":{"install-plugin":"./install.sh"},"keywords":["openclaw","plugin","memory","amm","agent-memory"],"repository":{"type":"git","url":"git+https://github.com/BonzTM/agent-memory-manager.git","directory":"examples/openclaw"},"license":"MIT","gitHead":"b466a5ce2589cd4644afc341fd65615f5a07052e","_id":"@bonztm/amm@1.4.1","bugs":{"url":"https://github.com/BonzTM/agent-memory-manager/issues"},"homepage":"https://github.com/BonzTM/agent-memory-manager#readme","_nodeVersion":"22.22.2","_npmVersion":"11.12.1","dist":{"integrity":"sha512-GS9GHetwHEUqmZvuDO/t97JtosJeRXY+GFWwtbk6WCFjP2JM43a1zcGml4nUJw3ocdrgiCoP03ugE438TAhPaw==","shasum":"5a7c96cdb0231639eb52882722978f397d8124ad","tarball":"https://registry.npmjs.org/@bonztm/amm/-/amm-1.4.1.tgz","fileCount":10,"unpackedSize":51757,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bonztm%2famm@1.4.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCR895S3MhDWREWJ7MrSnwHyYm9Zc+XVtZQ7kxo/XPuOQIhALo3cyFbkuf4A4E0pf7FN2jC1S2Y9sufTgWYg6RmXSj4"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:dd3f131d-55e3-4bea-a400-33c1203fc8b4"}},"directories":{},"maintainers":[{"name":"bonztm","email":"joshdwells@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/amm_1.4.1_1775335628539_0.1523566875462039"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T19:55:53.520Z","modified":"2026-04-04T20:47:09.335Z","1.2.0":"2026-04-01T19:55:53.784Z","1.2.1-beta.1":"2026-04-01T20:15:42.943Z","1.2.1-beta.2":"2026-04-01T20:20:09.444Z","1.2.1-beta.3":"2026-04-01T20:22:58.649Z","1.2.1-beta.4":"2026-04-01T20:36:03.450Z","1.2.1-beta.5":"2026-04-01T20:58:23.896Z","1.2.1":"2026-04-01T23:05:35.053Z","1.3.0":"2026-04-02T16:34:37.636Z","1.3.1":"2026-04-02T18:51:00.403Z","1.3.2":"2026-04-02T21:00:59.865Z","1.4.0":"2026-04-04T19:37:44.414Z","1.4.1":"2026-04-04T20:47:08.699Z"},"bugs":{"url":"https://github.com/BonzTM/agent-memory-manager/issues"},"license":"MIT","homepage":"https://github.com/BonzTM/agent-memory-manager#readme","keywords":["openclaw","plugin","memory","amm","agent-memory"],"repository":{"type":"git","url":"git+https://github.com/BonzTM/agent-memory-manager.git","directory":"examples/openclaw"},"description":"AMM memory plugin for OpenClaw — ambient recall injection and conversation event capture.","maintainers":[{"name":"bonztm","email":"joshdwells@gmail.com"}],"readme":"# OpenClaw AMM Plugin\n\nNative OpenClaw plugin for [amm](https://github.com/bonztm/agent-memory-manager) (Agent Memory Manager). Targets **OpenClaw 2026.03.31+**.\n\n- **Automatic ambient recall injection** via `before_prompt_build`\n- **Two-tier memory guidance** — system prompt teaches the agent to use built-in memory as a lean scratchpad and AMM as unlimited long-term storage\n- **Event capture** for messages and tool invocations\n- **Optional curated memory mirroring** of MEMORY.md/USER.md to AMM\n- **Dual transport** — local `amm` binary or remote HTTP API via `AMM_API_URL`\n- **MCP sidecar** wiring for explicit agent tool access\n\nThe plugin is **hot-path only**. It does not run maintenance jobs.\n\n## Prerequisites\n\n- `amm` and optionally `amm-mcp` installed in your PATH for local-binary mode, or `amm-http` reachable over the network for API mode\n- An initialized database at `~/.amm/amm.db` or your chosen `AMM_DB_PATH`\n\n## Install\n\n### Option A: npm install (HTTP API mode)\n\n```bash\nopenclaw plugins install @bonztm/amm\n```\n\nRequires `amm-http` running as an HTTP service. After install, configure the plugin and MCP server in `~/.openclaw/openclaw.json`. See the [integration guide](../../docs/openclaw-integration.md#install) for the full config example.\n\n### Option B: Local install (binary + HTTP mode)\n\n```bash\n# Local binary mode (no HTTP server needed)\n./install.sh\n\n# With project scoping\n./install.sh --project-id my-project --recall-limit 10\n\n# HTTP API mode (remote amm-http server)\n./install.sh --api-url http://localhost:8080 --api-key your-key\n```\n\nThe install script automatically configures the plugin, MCP server, and `plugins.allow` list. Run `./install.sh --help` for all options.\n\n### Option C: Manual\n\n```bash\ncp -R examples/openclaw ~/.openclaw/extensions/amm\n```\n\nThen merge the config into your `~/.openclaw/openclaw.json`. See the [integration guide](../../docs/openclaw-integration.md#install) for local and HTTP config examples.\n\n## Files\n\n- `openclaw.plugin.json` — native plugin manifest\n- `package.json` — publishable as `@bonztm/amm`\n- `index.ts` — plugin entry point with tool registration and hooks\n- `install.sh` — one-command local installer\n- `src/config.ts` — configuration resolution (plugin config + env vars)\n- `src/transport.ts` — dual transport layer (binary CLI / HTTP API)\n- `src/transport-http.ts` — HTTP-only transport (used by npm package)\n- `src/recall.ts` — ambient recall query and rendering\n- `src/capture.ts` — event normalization and ingestion\n- `src/curated-sync.ts` — curated memory snapshot and reconciliation\n- `openclaw.json` — example OpenClaw config fragment\n\n## Verify\n\n```bash\n# Verify the plugin is loaded\nopenclaw plugins list\n\n# Verify MCP sidecar\nopenclaw mcp list\n```\n\nThen start a conversation and check that events appear in amm history:\n\n```bash\namm history --limit 5\n```\n\nFor the complete integration guide — configuration reference, transport options, architecture details, curated memory mirroring, maintenance, and operational patterns — see [`../../docs/openclaw-integration.md`](../../docs/openclaw-integration.md).\n","readmeFilename":"README.md"}