## The memory ceiling

If you run OpenClaw today, your agent stores memory in `MEMORY.md` and dated files in a `memory/` directory. That works for single-agent, single-session use. The moment you rely on that memory for anything ongoing, you hit a ceiling. The failure modes are specific and predictable.

**Memory compaction drops facts.** OpenClaw triggers a silent agent turn that writes "durable memories" before truncating context. What was in the file before compaction is unknown. If the compacted version dropped a fact, it is gone. There is no observation log. No rollback.

**No entity identity across sessions.** "Acme Corp" in one session and "ACME CORP" in the next may or may not resolve to the same entity. The agent re-infers each time from the context window. There are no stable IDs. No merge rules.

**Concurrent writes corrupt state.** If you run multiple agents or plugins that touch the same memory files, you get data corruption. OpenClaw's own documentation acknowledges this. The single-agent ceiling is real, and most agentic workflows will not stay single-agent forever.

**No audit trail.** When the agent gives a wrong answer, you cannot trace it back to a specific observation. You cannot see what changed between Tuesday and Thursday. You cannot answer "what did my agent know when it made that decision?"

These are not edge cases. They show up as soon as the agent handles contacts, tasks, transactions, or any state that matters across sessions.

## What the plugin adds

[Neotoma v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3) adds an `openclaw.plugin.json` manifest, an entry point, and tool definitions that register into OpenClaw's four-layer plugin system. The Gateway discovers the plugin, validates the manifest, loads the runtime, and exposes Neotoma's tools to the agent.

Each failure mode above gets a structural fix.

**Compaction no longer loses state.** Observations are append-only. The compacted summary can still serve the context window, but the source observations persist in Neotoma with full history. Nothing gets silently dropped.

**Entity identity is deterministic.** Hash-based canonical IDs resolve "Acme Corp" and "ACME CORP" to one entity by rule, not by per-session inference. Same contact, same ID, every time.

**Concurrent writes are safe.** Two agents writing about the same entity produce two observations in an append-only store, not a file conflict. Schema constraints validate every write before it enters the store.

**The audit trail is built in.** Every observation traces to its source. Corrections create new observations, not overwrites. You can reconstruct state at any point in time.

Beyond fixing the ceiling, the plugin exposes capabilities that `MEMORY.md` cannot support at all:

- **Structured retrieval.** "All tasks linked to this contact" or "every transaction with vendor X" is a query, not a file grep.
- **Timeline queries.** Date fields across entities produce timelines. "What happened last week" hits a temporal index, not a context-window search.
- **Schema validation.** Entity types are checked on write. Bad data gets rejected before it enters the store.

The agent loop does not change. OpenClaw still manages intent interpretation, browsing, form-filling, and skill execution. Neotoma handles state. The plugin sits between the agent's writes and persistent storage.

## The overhead question

Markdown files are free. They cost nothing to set up, nothing to maintain, and the KV-cache economics actively reward them.

Neotoma adds overhead. Schema validation on writes. Observation storage. Entity resolution. A local server process. এগুলো বিনামূল্যে নয়। But the overhead is designed to stay invisible: the agent installs Neotoma, configures it, and writes to it without requiring you to learn a new tool or change how you work.

The question is whether the overhead is worth paying. If your agent never needs to answer "what did I know last Tuesday" or "which write corrupted this contact record," then no. `MEMORY.md` is the correct architecture.

If your agent manages ongoing state, contacts, tasks, transactions, and vendor relationships, and you need consistency across sessions, the write-path overhead is the cheapest part of the problem. ব্যয়বহুল অংশটি রাষ্ট্রীয় দুর্নীতিকে ডিবাগ করা হচ্ছে বাস্তবতার পরে, যখন অডিট ট্রেইল নেই।

## What this does not do

প্লাগইন OpenClaw এর এজেন্ট লুপ প্রতিস্থাপন করে না। দক্ষতা কীভাবে কাজ করে তা পরিবর্তন করে না। এটি বিদ্যমান `MEMORY.md` সামগ্রী স্থানান্তর করার প্রয়োজন নেই (যদিও আমদানি সমর্থিত)।

এটি প্রতিটি এজেন্ট মেমরি সমস্যার সমাধান করে না। পুনরুদ্ধারের গুণমান, প্রম্পট ইঞ্জিনিয়ারিং, দক্ষতা ডিজাইন এবং মডেল নির্বাচন এখনও গুরুত্বপূর্ণ। নিওটোমা রাষ্ট্রীয় স্তর পরিচালনা করে: কোন সত্তা বিদ্যমান, তারা কীভাবে সংযুক্ত, তারা কোথা থেকে এসেছে এবং কীভাবে তারা পরিবর্তিত হয়েছে। এই স্তরের উপরে সবকিছু একই থাকে।

এটি উত্পাদন স্থিতিশীলতা দাবি করে না। নিওটোমা [ডেভেলপার রিলিজ](/posts/neotoma-developer-release) এ রয়েছে। ব্রেকিং পরিবর্তন আশা করা উচিত. বাস্তব এজেন্ট প্ল্যাটফর্মের অধীনে কাঠামোগত অবস্থা বাস্তবে কাজ করে কিনা চাপ-পরীক্ষা করার জন্য প্লাগইন বিদ্যমান, আজ নির্ভরযোগ্যতার প্রতিশ্রুতি নয়।

## Try it, break it

আমি [আমার নিজের এজেন্টিক স্ট্যাক](/posts/what-my-agentic-stack-actually-does) এ মেমরি লেয়ার হিসেবে নিওটোমা চালাচ্ছি। একই দোকানে একাধিক এজেন্ট লিখছেন: ইমেল ট্রাইজ, টাস্ক ম্যানেজমেন্ট, ফাইন্যান্স এবং কন্টেন্ট। উপরে বর্ণিত মাল্টি-এজেন্ট রাষ্ট্রীয় সমস্যাগুলি আমার জন্য অনুমানমূলক নয়। তারা কি আমি প্রতি সপ্তাহে আঘাত.

প্লাগইনটি OpenClaw ব্যবহারকারীদের জন্য এটি উপলব্ধ করে। এটি ইনস্টল করুন। এটি সক্রিয় করুন। নীচের কাঠামোগত অবস্থা দিয়ে আপনার এজেন্ট চালান. See where it helps. ওভারহেড এটি মূল্য না যেখানে দেখুন. দেখুন কোথায় নকশা ভাঙছে।

ফিডব্যাক লুপ আর্কিটেকচারের চেয়ে বেশি গুরুত্বপূর্ণ। প্রকৃত এজেন্টরা একটি কাঠামোগত স্তরের মাধ্যমে বাস্তব পর্যবেক্ষণ লেখেন যেখানে দাবিগুলি ধারণ করে বা ব্যর্থ হয়।

## Evaluate and install

Neotoma আপনার OpenClaw কর্মপ্রবাহের সাথে মানানসই কিনা তা খুঁজে বের করার দ্রুততম উপায় হল আপনার এজেন্টকে আপনার জন্য এটি মূল্যায়ন করতে দেওয়া। আপনার OpenClaw সেশনে এটি আটকান:

```copy
https://neotoma.io/evaluate পড়ুন। আপনি উত্তর দেওয়ার আগে, যেকোন বৃহত্তর টুল, ওয়ার্কস্পেস, এবং কনফিগারেশন প্রসঙ্গ পরিদর্শন করুন যাতে আপনি অ্যাক্সেস করতে পারেন যাতে আপনি এই চ্যাটের পরিবর্তে আমার আসল কর্মপ্রবাহের মূল্যায়ন করতে পারেন। তারপর আমাকে বলুন যে Neotoma আমার কর্মপ্রবাহের জন্য সত্যিকারের উপযুক্ত কিনা, কোন ডেটা প্রথমে টিকে থাকার জন্য সর্বোচ্চ মান হবে এবং আমার পরবর্তীতে কী করা উচিত।
```

আপনার এজেন্ট পৃষ্ঠাটি পড়ে, আপনার স্থানীয় প্রসঙ্গ (সরঞ্জাম, কনফিগারেশন, মেমরি ফাইল এবং ওয়ার্কস্পেস) পরীক্ষা করে এবং এই পোস্টে বর্ণিত সমস্যাগুলি আপনার সেটআপে প্রযোজ্য কিনা তা আপনাকে বলে৷ যদি তারা তা করে তবে এটি আপনাকে ইনস্টলেশন, আপনার নিজস্ব ডেটা সহ সক্রিয়করণ এবং প্লাগইন কনফিগারেশনের মাধ্যমে নিয়ে যায়। যদি তারা না করে তবে এটি আপনাকেও বলে।

আপনি যদি ইতিমধ্যেই Neotoma চান এবং [মূল্যায়নের ধাপ](https://neotoma.io/evaluate) এড়িয়ে যেতে পছন্দ করেন, তাহলে [neotoma.io/install](https://neotoma.io/install) থেকে এজেন্ট-সহায়ক ইনস্টল ব্যবহার করুন। OpenClaw এ পেস্ট করুন। আপনার এজেন্ট সেই পৃষ্ঠায় সম্পূর্ণ ইনস্টল-প্রথম ক্রমটি পড়ে, শুধুমাত্র প্রয়োজন হলেই ইনস্টল করে, আপনার ডেটা দিয়ে অ্যাক্টিভেশন চালায়, তারপর একই পৃষ্ঠায় OpenClaw ইন্টিগ্রেশন পদক্ষেপগুলি সহ চলমান ব্যবহারের জন্য আপনার বর্তমান টুল কনফিগার করে:

```copy
https://neotoma.io/install পড়ুন এবং আমাকে ইনস্টল-প্রথম নিওটোমা প্রবাহের মাধ্যমে নিয়ে যান। ইনস্টল করুন, আমার ডেটা দিয়ে এটি সক্রিয় করুন এবং শক্তিশালী চলমান ব্যবহারের জন্য আমার বর্তমান টুল কনফিগার করুন।
```

আপনি যদি ম্যানুয়াল কমান্ড পছন্দ করেন: `openclaw plugins install clawhub:neotoma` সরাসরি ClawHub থেকে প্লাগইন যোগ করে। অথবা npm প্যাকেজ বিশ্বব্যাপী ইনস্টল করুন `npm install -g neotoma` তারপর `neotoma init`, এই রিলিজে ঐচ্ছিক পিন সহ (`npm install -g neotoma@0.4.3`)। সম্পূর্ণ বিকল্প, MCP কনফিগারেশন, ডকার এবং রিসেট আচরণ [neotoma.io/install](https://neotoma.io/install) এ থাকে।

রেপো: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma)। রিলিজ নোট: [v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3)।

স্ট্রাকচার্ড এজেন্ট মেমরির পিছনে গভীর স্থাপত্যের যুক্তির জন্য, [ওপেনক্ল এবং ট্রুথ লেয়ার](/পোস্ট/ওপেনক্লা-এন্ড-দ্য-ট্রুথ-লেয়ার) এবং [মার্কডাউন মেমরি সিলিং](/পোস্ট/দ্য-মার্কডাউন-মেমরি-সিলিং) দেখুন।