## میموری کی چھت

اگر آپ آج OpenClaw چلاتے ہیں، تو آپ کا ایجنٹ میموری کو `MEMORY.md` میں اور تاریخ کی فائلوں کو `memory/` ڈائریکٹری میں محفوظ کرتا ہے۔ That works for single-agent, single-session use. جس لمحے آپ کسی بھی چیز کے لیے اس یادداشت پر بھروسہ کرتے ہیں، آپ ایک چھت سے ٹکراتے ہیں۔ The failure modes are specific and predictable.

**میموری کمپیکشن ڈراپ حقائق۔** اوپن کلاؤ ایک خاموش ایجنٹ موڑ کو متحرک کرتا ہے جو سیاق و سباق کو تراشنے سے پہلے "پائیدار یادیں" لکھتا ہے۔ کمپیکشن سے پہلے فائل میں کیا تھا معلوم نہیں ہے۔ اگر کمپیکٹ شدہ ورژن نے کسی حقیقت کو چھوڑ دیا ہے، تو وہ ختم ہو گیا ہے۔ There is no observation log. کوئی رول بیک نہیں۔

**سیشنز میں ہستی کی کوئی شناخت نہیں ہے۔** ایک سیشن میں "Acme Corp" اور اگلے سیشن میں "ACME CORP" ایک ہی ہستی کو حل کر سکتا ہے یا نہیں کر سکتا۔ ایجنٹ ہر بار سیاق و سباق کی کھڑکی سے دوبارہ اندازہ لگاتا ہے۔ کوئی مستحکم IDs نہیں ہیں۔ انضمام کے کوئی اصول نہیں۔

**کنکرنٹ کرپٹ اسٹیٹ لکھتا ہے۔** اگر آپ ایک سے زیادہ ایجنٹس یا پلگ ان چلاتے ہیں جو ایک ہی میموری فائلوں کو ٹچ کرتے ہیں تو آپ کو ڈیٹا کرپٹ ہوجاتا ہے۔ OpenClaw's own documentation acknowledges this. سنگل ایجنٹ کی حد حقیقی ہے، اور زیادہ تر ایجنٹ ورک فلو ہمیشہ کے لیے سنگل ایجنٹ نہیں رہیں گے۔

**کوئی آڈٹ ٹریل نہیں۔** جب ایجنٹ غلط جواب دیتا ہے، تو آپ اسے کسی خاص مشاہدے میں واپس نہیں لے سکتے۔ آپ نہیں دیکھ سکتے کہ منگل اور جمعرات کے درمیان کیا بدلا ہے۔ آپ جواب نہیں دے سکتے کہ "میرے ایجنٹ کو کیا معلوم تھا جب اس نے یہ فیصلہ کیا؟"

These are not edge cases. وہ جیسے ہی ایجنٹ کے رابطوں، کاموں، لین دین، یا کسی بھی ریاست کو سنبھالتا ہے جو سیشنوں میں اہمیت رکھتا ہے ظاہر ہوتا ہے۔

## پلگ ان کیا جوڑتا ہے۔

[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. گیٹ وے پلگ ان کو دریافت کرتا ہے، مینی فیسٹ کی توثیق کرتا ہے، رن ٹائم لوڈ کرتا ہے، اور Neotoma کے ٹولز کو ایجنٹ کے سامنے ظاہر کرتا ہے۔

Each failure mode above gets a structural fix.

**کمپیکشن اب حالت نہیں کھوتا۔** مشاہدات صرف منسلک ہیں۔ کمپیکٹ شدہ خلاصہ اب بھی سیاق و سباق کی کھڑکی کو پیش کر سکتا ہے، لیکن ماخذ کے مشاہدات پوری تاریخ کے ساتھ نیوٹوما میں برقرار ہیں۔ 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.

**مشترکہ تحریریں محفوظ ہیں۔** ایک ہی ہستی کے بارے میں لکھنے والے دو ایجنٹ صرف ضمیمہ والے اسٹور میں دو مشاہدات پیش کرتے ہیں، فائل کا تنازعہ نہیں۔ اسکیما کی رکاوٹیں اسٹور میں داخل ہونے سے پہلے ہر تحریر کی توثیق کرتی ہیں۔

**آڈٹ ٹریل اس میں بنایا گیا ہے۔** ہر مشاہدہ اپنے ماخذ تک پہنچتا ہے۔ تصحیحیں نئے مشاہدات تخلیق کرتی ہیں، اوور رائٹ نہیں۔ You can reconstruct state at any point in time.

چھت کو ٹھیک کرنے کے علاوہ، پلگ ان ان صلاحیتوں کو ظاہر کرتا ہے جن کو `MEMORY.md` بالکل بھی سپورٹ نہیں کر سکتا:

- **سٹرکچرڈ بازیافت۔** "اس رابطے سے منسلک تمام کام" یا "وینڈر X کے ساتھ ہر لین دین" ایک سوال ہے، فائل گریپ نہیں۔
- **ٹائم لائن کے سوالات۔** تمام اداروں میں تاریخ کے فیلڈز ٹائم لائنز تیار کرتے ہیں۔ "پچھلے ہفتے کیا ہوا" ایک وقتی انڈیکس سے ٹکراتا ہے، سیاق و سباق کی کھڑکی کی تلاش سے نہیں۔
- **اسکیما کی توثیق۔** ہستی کی قسمیں لکھنے پر چیک کی جاتی ہیں۔ برا ڈیٹا اسٹور میں داخل ہونے سے پہلے ہی مسترد ہو جاتا ہے۔

The agent loop does not change. OpenClaw اب بھی ارادے کی تشریح، براؤزنگ، فارم بھرنے، اور مہارت پر عمل درآمد کا انتظام کرتا ہے۔ نیوٹوما ریاست کو سنبھالتا ہے۔ پلگ ان ایجنٹ کی تحریروں اور مستقل اسٹوریج کے درمیان بیٹھتا ہے۔

## اوور ہیڈ سوال

مارک ڈاؤن فائلیں مفت ہیں۔ ان کے سیٹ اپ کرنے کے لیے کچھ بھی خرچ نہیں ہوتا، برقرار رکھنے کے لیے کچھ نہیں ہوتا، اور KV-کیش اکنامکس انہیں فعال طور پر انعام دیتا ہے۔

Neotoma اوپر کا اضافہ کرتا ہے۔ Schema validation on writes. Observation storage. ہستی کی قرارداد۔ مقامی سرور کا عمل۔ یہ مفت نہیں ہیں۔ 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.

سوال یہ ہے کہ کیا اوور ہیڈ ادائیگی کے قابل ہے؟ اگر آپ کے ایجنٹ کو کبھی بھی یہ جواب دینے کی ضرورت نہیں ہے کہ "مجھے گزشتہ منگل کو کیا معلوم تھا" یا "کس تحریر نے اس رابطہ ریکارڈ کو خراب کیا،" تو نہیں۔ `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. مہنگا حصہ حقیقت کے بعد ریاستی کرپشن کو ڈیبگ کرنا ہے، جب آڈٹ ٹریل موجود نہیں ہے۔

## یہ کیا نہیں کرتا

پلگ ان OpenClaw کے ایجنٹ لوپ کو تبدیل نہیں کرتا ہے۔ یہ تبدیل نہیں ہوتا کہ مہارت کیسے کام کرتی ہے۔ اسے موجودہ `MEMORY.md` مواد کو منتقل کرنے کی ضرورت نہیں ہے (حالانکہ درآمد کی حمایت کی جاتی ہے)۔

یہ ہر ایجنٹ کی میموری کا مسئلہ حل نہیں کرتا ہے۔ بازیافت کا معیار، فوری انجینئرنگ، مہارت کا ڈیزائن، اور ماڈل کا انتخاب اب بھی اہم ہے۔ Neotoma ریاستی پرت کو سنبھالتا ہے: کون سی ہستی موجود ہے، وہ کیسے منسلک ہیں، وہ کہاں سے آئے ہیں، اور وہ کیسے بدلے ہیں۔ اس پرت کے اوپر ہر چیز ایک جیسی رہتی ہے۔

یہ پیداواری استحکام کا دعویٰ بھی نہیں کرتا ہے۔ نیوٹوما [ڈیولپر ریلیز](/posts/neotoma-developer-release) میں ہے۔ بریکنگ تبدیلیوں کی توقع کی جانی چاہئے۔ The plugin exists to pressure-test whether structured state underneath a real agent platform works in practice, not to promise reliability today.

## اسے آزمائیں، اسے توڑ دیں۔

میں نیوٹوما کو میموری لیئر کے طور پر [میرے اپنے ایجنٹ اسٹیک](/posts/what-my-agentic-stack-actually-does) میں چلا رہا ہوں۔ ایک ہی اسٹور پر متعدد ایجنٹ لکھ رہے ہیں: ای میل ٹرائیج، ٹاسک مینجمنٹ، فنانس، اور مواد۔ اوپر بیان کردہ ملٹی ایجنٹ ریاستی مسائل میرے لیے فرضی نہیں ہیں۔ وہ وہی ہیں جو میں ہر ہفتے مارتا ہوں۔

پلگ ان اسے OpenClaw صارفین کے لیے دستیاب کرتا ہے۔ اسے انسٹال کریں۔ اسے فعال کریں۔ اپنے ایجنٹ کو نیچے کی تشکیل شدہ حالت کے ساتھ چلائیں۔ دیکھیں کہ یہ کہاں مدد کرتا ہے۔ دیکھو جہاں اوور ہیڈ اس کے قابل نہیں ہے۔ دیکھیں کہ ڈیزائن کہاں ٹوٹتا ہے۔

فیڈ بیک لوپ فن تعمیر سے زیادہ اہمیت رکھتا ہے۔ اصلی ایجنٹ ایک ساختی پرت کے ذریعے حقیقی مشاہدات لکھتے ہیں جہاں دعوے ہوتے ہیں یا ناکام رہتے ہیں۔

## تشخیص کریں اور انسٹال کریں۔

یہ معلوم کرنے کا تیز ترین طریقہ کہ کیا Neotoma آپ کے OpenClaw ورک فلو پر فٹ بیٹھتا ہے یہ ہے کہ آپ اپنے ایجنٹ کو آپ کے لیے اس کا جائزہ لیں۔ اسے اپنے OpenClaw سیشن میں چسپاں کریں:

``کاپی
https://neotoma.io/evaluate پڑھیں۔ Before you answer, inspect any broader tool, workspace, and configuration context you can access so you assess my real workflow rather than just this chat. پھر مجھے بتائیں کہ کیا Neotoma میرے ورک فلو کے لیے ایک حقیقی فٹ ہے، پہلے کون سا ڈیٹا برقرار رکھنے کے لیے سب سے زیادہ قیمت ہوگی، اور مجھے آگے کیا کرنا چاہیے۔
``

Your agent reads the page, checks your local context (tools, configs, memory files, and workspace), and tells you whether the problems described in this post apply to your setup. اگر وہ کرتے ہیں، تو یہ آپ کو انسٹالیشن، آپ کے اپنے ڈیٹا کے ساتھ ایکٹیویشن، اور پلگ ان کنفیگریشن کے ذریعے لے جاتا ہے۔ اگر وہ نہیں کرتے تو یہ آپ کو بھی بتاتا ہے۔

If you already want Neotoma and prefer to skip [the evaluation step](https://neotoma.io/evaluate), use the agent-assisted install from [neotoma.io/install](https://neotoma.io/install). اسے OpenClaw میں چسپاں کریں۔ Your agent reads the full install-first sequence on that page, installs only if needed, runs activation with your data, then configures your current tool for ongoing use, including the OpenClaw integration steps on that same page:

``کاپی
https://neotoma.io/install پڑھیں اور مجھے انسٹال کے پہلے نیوٹوما فلو کے ذریعے لے جائیں۔ انسٹال کریں، اسے میرے ڈیٹا کے ساتھ چالو کریں، اور مضبوط جاری استعمال کے لیے میرے موجودہ ٹول کو ترتیب دیں۔
``

اگر آپ دستی کمانڈز کو ترجیح دیتے ہیں: `اوپنکلو پلگ ان انسٹال کریں کلاہب:نیوٹوما` پلگ ان کو براہ راست ClawHub سے جوڑتا ہے۔ Or install the npm package globally with `npm install -g neotoma` then `neotoma init`, with optional pin to this release (`npm install -g neotoma@0.4.3`). مکمل اختیارات، MCP کنفیگریشن، Docker، اور ری سیٹ رویے [neotoma.io/install](https://neotoma.io/install) پر رہتے ہیں۔

Repo: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma)۔ ریلیز نوٹس: [v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3)۔

For the deeper architectural reasoning behind structured agent memory, see [OpenClaw and the truth layer](/posts/openclaw-and-the-truth-layer) and [The markdown memory ceiling](/posts/the-markdown-memory-ceiling).