ایجنٹ رن ٹائم 🤖¶

OpenClaw ایک واحد ایمبیڈڈ ایجنٹ رن ٹائم چلاتا ہے جو pi-mono سے ماخوذ ہے۔

ورک اسپیس (لازمی)¶

OpenClaw ایک واحد ایجنٹ ورک اسپیس ڈائریکٹری (agents.defaults.workspace) استعمال کرتا ہے جو ٹولز اور سیاق کے لیے ایجنٹ کی واحد ورکنگ ڈائریکٹری (cwd) ہوتی ہے۔

سفارش کردہ: openclaw setup استعمال کریں تاکہ اگر موجود نہ ہو تو ~/.openclaw/openclaw.json بنایا جائے اور ورک اسپیس فائلیں ابتدائی حالت میں سیٹ کی جائیں۔

مکمل ورک اسپیس لے آؤٹ + بیک اپ گائیڈ: Agent workspace

اگر agents.defaults.sandbox فعال ہو، تو غیر-مرکزی سیشن اس کو اووررائیڈ کر سکتے ہیں اور agents.defaults.sandbox.workspaceRoot کے تحت فی-سیشن ورک اسپیسز استعمال کی جا سکتی ہیں (دیکھیں Gateway configuration)۔

بوٹسٹریپ فائلیں (انجیکٹ کی گئی)¶

agents.defaults.workspace کے اندر، OpenClaw ان صارف-قابلِ ترمیم فائلوں کی توقع کرتا ہے:

• AGENTS.md — عملی ہدایات + “میموری”
• SOUL.md — شخصیت، حدود، لہجہ
• TOOLS.md — صارف کی جانب سے برقرار رکھی گئی ٹول نوٹس (مثلاً imsg, sag, روایات)
• BOOTSTRAP.md — پہلی بار چلانے کا یک وقتی رسم (مکمل ہونے کے بعد حذف)
• IDENTITY.md — ایجنٹ کا نام/وائب/ایموجی
• USER.md — صارف پروفائل + ترجیحی مخاطبہ

نئے سیشن کے پہلے ٹرن پر، OpenClaw ان فائلوں کے مندرجات کو براہِ راست ایجنٹ سیاق میں داخل کرتا ہے۔

Blank files are skipped. بڑی فائلوں کو کاٹ کر مختصر کیا جاتا ہے اور ایک نشان کے ساتھ ختم کیا جاتا ہے تاکہ پرامپٹس مختصر رہیں (مکمل مواد کے لیے فائل پڑھیں)۔

اگر کوئی فائل موجود نہ ہو، تو OpenClaw ایک واحد “missing file” مارکر لائن داخل کرتا ہے (اور openclaw setup ایک محفوظ ڈیفالٹ ٹیمپلیٹ بنائے گا)۔

BOOTSTRAP.md صرف بالکل نئے ورک اسپیس کے لیے بنایا جاتا ہے (کوئی اور bootstrap فائل موجود نہ ہو)۔ اگر آپ رسم مکمل کرنے کے بعد اسے حذف کر دیں، تو بعد کی ری اسٹارٹس پر اسے دوبارہ نہیں بنایا جانا چاہیے۔

بوٹسٹریپ فائل کی تخلیق کو مکمل طور پر غیر فعال کرنے کے لیے (پہلے سے سیڈ کی گئی ورک اسپیسز کے لیے)، یہ سیٹ کریں:

{ agent: { skipBootstrap: true } }

بلٹ اِن ٹولز¶

بنیادی ٹولز (read/exec/edit/write اور متعلقہ سسٹم ٹولز) ہمیشہ دستیاب ہوتے ہیں، ٹول پالیسی کے تابع۔ apply_patch اختیاری ہے اور tools.exec.applyPatch کے ذریعے محدود ہے۔ TOOLS.md یہ کنٹرول نہیں کرتا کہ کون سے ٹولز موجود ہیں؛ یہ اس بات کی رہنمائی ہے کہ آپ انہیں کیسے استعمال کرنا چاہتے ہیں۔

اسکلز¶

OpenClaw تین مقامات سے Skills لوڈ کرتا ہے (نام کے تصادم میں ورک اسپیس کو فوقیت حاصل ہے):

• بنڈلڈ (انسٹال کے ساتھ فراہم کردہ)
• منظم/لوکل: ~/.openclaw/skills
• ورک اسپیس: <workspace>/skills

Skills کو کنفیگ/ماحول کے ذریعے محدود کیا جا سکتا ہے (دیکھیں skills در Gateway configuration)۔

pi-mono integration¶

OpenClaw، pi-mono کوڈ بیس کے کچھ حصے (ماڈلز/ٹولز) دوبارہ استعمال کرتا ہے، لیکن سیشن مینجمنٹ، ڈسکوری، اور ٹول وائرنگ OpenClaw کی ملکیت ہیں۔

• کوئی pi-coding ایجنٹ رن ٹائم نہیں۔
• ~/.pi/agent یا <workspace>/.pi کی سیٹنگز استعمال نہیں کی جاتیں۔

سیشنز¶

سیشن ٹرانسکرپٹس JSONL کی صورت میں یہاں محفوظ کیے جاتے ہیں:

• ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl

سیشن ID مستحکم ہوتا ہے اور OpenClaw کے ذریعے منتخب کیا جاتا ہے۔ Legacy Pi/Tau سیشن فولڈرز نہیں پڑھے جاتے۔

اسٹریمنگ کے دوران رہنمائی¶

جب queue موڈ steer ہو، تو آنے والے پیغامات موجودہ رن میں شامل کیے جاتے ہیں۔ ہر ٹول کال کے بعد queue چیک کی جاتی ہے؛ اگر کوئی queued پیغام موجود ہو تو موجودہ اسسٹنٹ میسج کی باقی ٹول کالز چھوڑ دی جاتی ہیں (error ٹول نتائج کے ساتھ "Queued user message کی وجہ سے چھوڑ دیا گیا۔"), پھر اگلے اسسٹنٹ ردعمل سے پہلے queued یوزر پیغام شامل کیا جاتا ہے۔

جب queue موڈ followup یا collect ہو، تو آنے والے پیغامات اس وقت تک روکے جاتے ہیں جب تک موجودہ ٹرن ختم نہ ہو جائے، پھر queued payloads کے ساتھ ایک نیا ایجنٹ ٹرن شروع ہوتا ہے۔ مزید معلومات کے لیے دیکھیں Queue موڈ + debounce/cap رویے کے لیے۔

Block streaming مکمل شدہ اسسٹنٹ بلاکس کو جیسے ہی وہ ختم ہوں بھیج دیتا ہے؛ یہ ڈیفالٹ طور پر بند ہوتا ہے (agents.defaults.blockStreamingDefault: "off")۔ حد کو agents.defaults.blockStreamingBreak کے ذریعے ایڈجسٹ کریں (text_end بمقابلہ message_end; ڈیفالٹس text_end)۔ نرم بلاک chunking کو agents.defaults.blockStreamingChunk کے ذریعے کنٹرول کریں (ڈیفالٹ 800–1200 حروف؛ پہلے پیراگراف بریکس کو ترجیح، پھر نئی لائنز؛ آخر میں جملے)۔ streamed chunks کو agents.defaults.blockStreamingCoalesce کے ذریعے یکجا کریں تاکہ سنگل لائن اسپام کم ہو (بھیجنے سے پہلے idle-based merging)۔ Non-Telegram چینلز کے لیے block replies فعال کرنے کے لیے واضح *.blockStreaming: true درکار ہے۔ تفصیلی ٹول خلاصے ٹول کے آغاز پر جاری کیے جاتے ہیں (کوئی debounce نہیں)؛ کنٹرول UI دستیاب ہونے پر ایجنٹ ایونٹس کے ذریعے ٹول آؤٹ پٹ اسٹریم کرتا ہے۔ مزید تفصیلات: Streaming + chunking۔

ماڈل ریفرنسز¶

کنفیگ میں Model refs (مثال کے طور پر agents.defaults.model اور agents.defaults.models) کو پہلے / پر اسپلٹ کر کے پارس کیا جاتا ہے۔

• ماڈلز کنفیگر کرتے وقت provider/model استعمال کریں۔
• اگر خود ماڈل ID میں / شامل ہو (OpenRouter طرز)، تو فراہم کنندہ کا prefix شامل کریں (مثال: openrouter/moonshotai/kimi-k2)۔
• اگر آپ فراہم کنندہ چھوڑ دیں، تو OpenClaw ان پٹ کو ایک عرف یا ڈیفالٹ فراہم کنندہ کے لیے ماڈل سمجھتا ہے (یہ صرف تب کام کرتا ہے جب ماڈل ID میں / موجود نہ ہو)۔

Configuration (minimal)¶

کم از کم، یہ سیٹ کریں:

• agents.defaults.workspace
• channels.whatsapp.allowFrom (سختی سے سفارش کردہ)

اگلا: Group Chats 🦞