OpenClaw کو کیسے ترتیب دیں اور A2A پلگ ان برج کو ڈیزائن کریں۔

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

یہ اہم ہے کیونکہ OpenClaw خود میزبان، ملٹی چینل، اوپن سورس، اور ایجنٹ کے ورک فلو کے ارد گرد بنایا گیا ہے: سیشنز، ٹولز، پلگ انز، اور ملٹی ایجنٹ روٹنگ۔ کھلونا چیٹ بوٹ کے بجائے، یہ آپریٹر کے زیر کنٹرول ایجنٹ رن ٹائم کی طرح ہے۔

اس گائیڈ میں آپ تین چیزیں کریں گے: پہلے، آئیے یہ معلوم کریں کہ OpenClaw کیا ہے اور ڈویلپرز اس میں کیوں دلچسپی رکھتے ہیں۔ دوسرا، آپ اسے ڈیش بورڈ کے ذریعے ایک ابتدائی دوستانہ طریقے سے چلا سکتے ہیں۔ تیسرا، ہم مجوزہ OpenClaw-to-A2A پلگ ان فن تعمیر اور اس کی اصل ڈیزائن شراکت کو دیکھتے ہیں۔ proof-of-concept ایک ریلے جو دکھا رہا ہے کہ اوپن کلاؤ کے سیشن ماڈل کو A2A پروٹوکول میں کیسے میپ کیا جا سکتا ہے۔

وہ آخری حصہ اہم ہے، لہذا آپ اسے احتیاط سے تیار کرنا چاہتے ہیں۔ اس مضمون کے لیے A2A انضمام یہ ہے: ~ نہیں بلٹ میں OpenClaw فعالیت کے ساتھ آتا ہے۔ یہ ایک دستاویزی آرکیٹیکچرل پروپوزل ہے جو اوپن کلاؤ کے ذریعہ پہلے ہی شائع شدہ ایکسٹینشن پوائنٹس کے سب سے اوپر بناتی ہے۔

شرطیں

یہ ہدایت نامہ OpenClaw کے بارے میں ہی ابتدائی طور پر دوستانہ ہے، لیکن کچھ بنیادی باتوں کو فرض کرتا ہے تاکہ آپ آرام سے فن تعمیر اور تصور کے ثبوت کے حصوں کی پیروی کر سکیں۔

جاری رکھنے سے پہلے، آپ کو درج ذیل جاننا چاہیے:

مقامی JavaScript یا Node.js (اسکرپٹس پڑھیں اور چلائیں)
HTTP APIs کیسے کام کرتے ہیں (درخواست، جواب، JSON پے لوڈ)
ٹرمینل کا استعمال کرتے ہوئے کمانڈز چلائیں۔
اعلی سطحی تصورات جیسے خدمات، APIs، یا مائیکرو سروسز

OpenClaw یا A2A کے ساتھ کسی پیشگی تجربے کی ضرورت نہیں ہے۔ سیٹ اپ کے مراحل آپ کو شروع کرنے کے لیے درکار ہر چیز کے بارے میں بتاتے ہیں۔

انڈیکس

OpenClaw کیا ہے؟
اوپن کلاؤ کو اتنی توجہ کیوں مل رہی ہے۔
A2A پروٹوکول کیا ہے؟
OpenClaw اور A2A کے درمیان تعلق
شروع کرنے سے پہلے آپ کو کیا ضرورت ہے۔
OpenClaw انسٹال کریں۔
آن بورڈنگ وزرڈ چلائیں۔
اپنا گیٹ وے چیک کریں اور ڈیش بورڈ کھولیں۔
OpenClaw کو اپنے ذاتی کوڈنگ اسسٹنٹ کے طور پر استعمال کریں۔
ملٹی ایجنٹ روٹنگ کو سمجھنا
جہاں A2A مستقبل میں فٹ ہو سکتا ہے۔
اوپن کلاؤ نے A2A پلگ ان فن تعمیر کے لیے تجویز کیا ہے۔
ایک پروف آف تصور ریلے کی تعمیر
تصور کا ثبوت ایک حقیقی OpenClaw پلگ ان پر کیسے نقش ہوتا ہے۔
اس سے پہلے کہ ہم آگے بڑھیں سیکیورٹی نوٹ
حتمی خیالات

OpenClaw کیا ہے؟

سرکاری دستاویزات کے مطابق، OpenClaw ایک خود میزبان گیٹ وے ہے جو براؤزر کے ڈیش بورڈز اور چیٹ ایپس جیسے WhatsApp، Telegram، Discord، اور iMessage کو AI ایجنٹس سے جوڑتا ہے۔

یہ جملہ مفید ہے کیونکہ یہ OpenClaw کو بتاتا ہے کہ یہ اسٹیک میں کہاں ہے۔ نہ صرف ایک ماڈل ریپر۔ یہ ایک گیٹ وے ہے جو سیشنز، روٹنگ، اور ایپ کنیکٹیویٹی کو ہینڈل کرتا ہے جبکہ ایجنٹس، ٹولز، پلگ انز اور فراہم کنندگان اصل کام کرتے ہیں۔

سب سے آسان ذہنی ماڈل یہ ہے:

اگر آپ پروجیکٹس میں نئے ہیں تو اس کے بارے میں سوچنے کا ایک عملی طریقہ یہ ہے:

آپ کی چیٹ ایپ آپ کا سامنے کا دروازہ ہے۔
گیٹ وے ٹریفک اور کنٹرول کی تہہ ہے۔
ایجنٹ انفرنس پرت ہیں۔
ماڈل فراہم کرنے والے اور ٹولز ایجنٹوں کو اصل میں کام انجام دینے کے قابل بناتے ہیں۔

یہ ان وجوہات میں سے ایک ہے جس کی وجہ سے OpenClaw عام براؤزر کے صرف مددگاروں سے مختلف محسوس کرتا ہے۔

کیوں ڈویلپرز OpenClaw پر توجہ دیتے ہیں۔

OpenClaw کئی وجوہات کی بناء پر بہت زیادہ توجہ حاصل کر رہا ہے۔

پہلی وجہ کنٹرول ہے۔ دستاویزات OpenClaw کو خود میزبان اور ملٹی چینل کے طور پر بیان کرتی ہیں۔ اس کا مطلب ہے کہ آپ مکمل طور پر میزبان اسسٹنٹ پر انحصار کرنے کے بجائے اپنے سسٹم یا سرور پر OpenClaw چلا سکتے ہیں۔

دوسری وجہ یہ ہے کہ OpenClaw پہلے سے ہی ایک ایجنٹ پلیٹ فارم کی طرح لگتا ہے۔ دستاویزات میں سیشنز، پلگ انز، ٹولز، ٹیکنالوجیز، ملٹی ایجنٹ روٹنگ، اور ACP سے چلنے والے بیرونی کوڈنگ کے استعمال کی وضاحت کی گئی ہے۔ یہ "ویب پیج پر کسی ماڈل سے پوچھیں” سے کہیں زیادہ امیر کہانی ہے۔

تیسری وجہ ورک فلو فٹ ہے۔ بہت سے لوگ دوسرا ان باکس نہیں چاہتے ہیں۔ وہ ایک اسسٹنٹ چاہتے ہیں جو ان ٹولز کے ساتھ رہ سکے جو وہ پہلے ہی ہر روز چیک کرتے ہیں۔

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

A2A پروٹوکول کیا ہے؟

A2A، Agent2Agent کے لیے مختصر، ایجنٹ کے نظام کے درمیان رابطے کے لیے ایک کھلا پروٹوکول ہے۔ A2A تصریح کا مقصد آزاد ایجنٹ کے نظاموں کو ایک دوسرے کو دریافت کرنے، بات چیت کے طریقوں پر گفت و شنید کرنے، تعاون کا انتظام کرنے، اور اندرونی میموری، ٹولز، یا ملکیتی منطق کو سامنے لائے بغیر معلومات کا تبادلہ کرنے میں مدد کرنا ہے۔

وہ آخری نکتہ اہم ہے۔ A2A ایجنٹ کے نظاموں کے درمیان انٹرآپریبلٹی کے بارے میں ہے، ایک ایجنٹ کے تمام اندرونی حصوں کو دوسرے سے ظاہر نہیں کرتا ہے۔

A2A ابتدائی طور پر سیکھنے کے قابل کئی کلیدی تصورات متعارف کراتا ہے۔

ایجنٹ کارڈ: ریموٹ ایجنٹ کی JSON تفصیل، اس کا URL، ٹیکنالوجی، صلاحیتیں، اور تصدیق کے تقاضے۔
دن: دور دراز کے کام کی مرکزی اکائی
آرٹفیکٹ: کام کا آؤٹ پٹ
سیاق و سباق کی شناخت: متعدد متعلقہ گردشوں میں مستحکم تعامل کی حدود

A2A آپریشنز کافی صاف ستھرا لائف سائیکل پر عمل کرتے ہیں۔

A2A دستاویز یہ بھی بتاتی ہے کہ A2A اور MCP مسابقت کے بجائے تکمیلی ہیں۔ A2A ایجنٹ سے ایجنٹ کے تعاون کے لیے ہے۔ MCP ایجنٹوں اور ٹولز کے درمیان رابطے کے لیے ہے۔

اوپن کلاؤ سے A2A کا موازنہ کرتے وقت یہ فرق مفید ہے، کیونکہ OpenClaw میں پہلے سے ہی طاقتور مقامی ٹولز اور سیشن تصورات موجود ہیں۔

OpenClaw اور A2A کے درمیان تعلق

OpenClaw اور A2A ایک جیسے نہیں ہیں، لیکن وہ ایک دلچسپ انداز میں سیدھ میں ہیں۔

OpenClaw نے پہلے ہی متعدد خصوصیات کو دستاویز کیا ہے جو کثیر ایجنٹ کی سمت کی طرف اشارہ کرتے ہیں۔

تاہم، یہاں درست رہنا اب بھی ضروری ہے۔

OpenClaw فی الحال ACP، پلگ انز، اور مقامی ملٹی ایجنٹ کوآرڈینیشن کو دستاویز کرتا ہے۔ میں نے جو دستاویز چیک کی ہے۔ ~ نہیں ہم مقامی A2A سپورٹ کو ایک اعلی درجے کی بلٹ ان خصوصیت کے طور پر بیان کرتے ہیں۔

اس نے کہا، دیانت دار دلیل یہ ہے:

OpenClaw نظریاتی طور پر A2A کے ساتھ بامعنی طور پر جڑ سکتا ہے کیونکہ آرکیٹیکچرل ٹکڑوں کی سیدھ میں ہے، لیکن A2A پل کو ابھی بھی تعمیر کرنے کی ضرورت ہے۔

ACP بمقابلہ A2A

ACP اور A2A مختلف مسائل حل کرتے ہیں۔

OpenClaw کا موجودہ ACP آپ کے IDE یا کوڈنگ کلائنٹ کو گیٹ وے سے چلنے والے سیشن سے جوڑنا ہے۔

A2A ایک ایجنٹ کا نظام ہے جو پروٹوکول کی حدود میں دوسرے ایجنٹ سسٹم کے ساتھ بات چیت کرتا ہے۔

یہ فرق ان وجوہات میں سے ایک ہے جس کی وجہ سے میں اس اظہار کو ترجیح دیتا ہوں۔ پلگ ان پل اس کے بجائے یہاں مقامی A2A سپورٹ.

شروع کرنے سے پہلے آپ کو کیا ضرورت ہے۔

سب سے آسان پہلا رن ہے۔ ~ نہیں آپ کو واٹس ایپ، ٹیلیگرام یا ڈسکارڈ کی ضرورت ہوگی۔

OpenClaw آن بورڈنگ دستاویزات کے مطابق، سب سے تیز پہلی چیٹ ڈیش بورڈ ہے۔ یہ سیٹ اپ کو ابتدائی افراد کے لیے بہت زیادہ قابل رسائی بناتا ہے۔

شروع کرنے سے پہلے، آپ کو ضرورت ہو گی:

نوڈ 24 اگر دستیاب ہو یا نوڈ 22.16+ مطابقت کے لیے
ماڈل فراہم کنندہ کی API کلید جسے آپ استعمال کرنا چاہتے ہیں۔
اگر آپ ونڈوز استعمال کر رہے ہیں تو مکمل تجربے کے لیے WSL2 تجویز کردہ راستہ ہے۔ مقامی ونڈوز بنیادی CLI اور گیٹ وے فلو کے لیے کام کرے گی، لیکن دستاویزات میں انتباہات کا خاکہ پیش کیا گیا ہے اور WSL2 کو زیادہ قابل اعتماد سیٹ اپ کے طور پر بیان کیا گیا ہے۔
پہلے ڈیش بورڈ پر مبنی رن کے لیے تقریباً 5 منٹ

مرحلہ 1: OpenClaw انسٹال کریں۔

آفیشل گیٹنگ اسٹارٹ پیج انسٹالر اسکرپٹ کی تجویز کرتا ہے۔

macOS، Linux، یا WSL2 پر، چلائیں:

curl -fsSL https://openclaw.ai/install.sh | bash

ونڈوز پاور شیل میں، دستاویزات دکھاتی ہیں:

iwr -useb https://openclaw.ai/install.ps1 | iex

اگر آپ ونڈوز استعمال کر رہے ہیں تو، پلیٹ فارم کی دستاویزات پہلے WSL2 کو انسٹال کرنے کی تجویز کرتی ہیں۔

wsl --install

پھر اوبنٹو کھولیں اور وہاں سے لینکس کمانڈز کو انجام دینا جاری رکھیں۔

مرحلہ 2: آن بورڈنگ وزرڈ کو چلائیں۔

CLI انسٹال ہونے کے بعد، آن بورڈنگ وزرڈ کو چلائیں۔

openclaw onboard --install-daemon

آن بورڈنگ وزرڈ دستاویزات میں تجویز کردہ راستہ ہے۔ توثیق، گیٹ وے کی ترتیبات، اختیاری چینلز، مہارتیں، اور ورک اسپیس ڈیفالٹس کو ایک ہدایت شدہ بہاؤ میں ترتیب دیں۔

سب سے ابتدائی دوستانہ انتخاب یہ ہے کہ آپ اپنی پہلی رن کو سادہ رکھیں۔ ابھی تک چیٹ ایپس کی فکر نہ کریں۔ سب سے پہلے، مقامی گیٹ وے کو چالو کریں۔

مرحلہ 3: اپنا گیٹ وے چیک کریں اور ڈیش بورڈ کھولیں۔

آن بورڈنگ کے بعد، یقینی بنائیں کہ آپ کا گیٹ وے چل رہا ہے۔

openclaw gateway status

پھر ڈیش بورڈ کھولیں۔

openclaw dashboard

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

ابتدائی سیٹ اپ کا بہاؤ مندرجہ ذیل ہے:

اگر آپ ڈیش بورڈ سے چیٹ کر سکتے ہیں، تو آپ کی Day-0 کی ترتیب کام کر رہی ہے۔

مرحلہ 4: OpenClaw کو اپنے ذاتی کوڈنگ اسسٹنٹ کے طور پر استعمال کریں۔

اوپن کلاؤ کو عوامی گروپ چیٹس سے دور رکھنا سب سے پہلے استعمال کا معاملہ ہے۔

اپنے ڈیش بورڈ کو اپنے ذاتی کوڈنگ اسسٹنٹ کے طور پر استعمال کریں۔

مثال کے طور پر، درج ذیل پرامپٹ کو آزمائیں:

میں ایک چھوٹی Node.js یوٹیلیٹی بنا رہا ہوں جو ایک Markdown فائل کو پڑھتا ہے اور مندرجات کا ایک جدول تیار کرتا ہے۔ ان خیالات کو ایک پروجیکٹ پلان، README خاکہ، اور نفاذ کے پہلے پانچ کاموں میں تبدیل کریں۔

اس قسم کے اشارے پہلے رنز کے لیے مثالی ہیں کیونکہ وہ فوراً ٹھوس مواد فراہم کرتے ہیں۔

آپ اسے اس کے لیے بھی استعمال کر سکتے ہیں:

کچے نوٹوں کو منصوبوں میں تبدیل کریں،
ایکشن آئٹمز میں بگ رپورٹس کا خلاصہ کریں،
README کا مسودہ تیار کریں،
فولڈر کا ڈھانچہ تجویز کریں۔
ایک محفوظ پہلی نفاذ چیک لسٹ بنائیں۔

جدید پروٹوکول کے ساتھ کام شروع کرنے سے پہلے ہی OpenClaw کو کارآمد بنانے کے لیے یہ کافی ہے۔

مرحلہ 5: ملٹی ایجنٹ روٹنگ کو سمجھیں۔

ایک بار جب آپ پہلے سے طے شدہ سیٹ اپ کام کر لیتے ہیں، تو یہ آپ کو OpenClaw کے مقامی ملٹی ایجنٹ ماڈل کو سمجھنے میں مدد کرے گا۔

مضمون میں ملٹی ایجنٹ روٹنگ کو ایک گیٹ وے پر الگ الگ ورک اسپیس، اسٹیٹ ڈائریکٹریز، اور سیشنز کا استعمال کرتے ہوئے متعدد الگ تھلگ ایجنٹوں کو چلانے کے طور پر بیان کیا گیا ہے۔

اس نے کہا، آپ اس طرح کے سیٹ اپ کا تصور کر سکتے ہیں:

ذاتی معاون
کوڈنگ مددگار
ریسرچ اسسٹنٹ
الارم اسسٹنٹ

OpenClaw کے پاس اس کے لیے پہلے سے ہی ایک ماڈل موجود ہے۔

آپ کو پہلے دن اسے ترتیب دینے کی ضرورت نہیں ہے۔

تاہم، یہ A2A مباحثوں میں اہم ہے۔ کیونکہ مقامی ایجنٹوں کے درمیان OpenClaw روٹس کے کام کرنے کے طریقہ کو سمجھنا روٹنگ کے کاموں کے بارے میں سوچنا بہت آسان بنا دیتا ہے۔ دور دراز A2A جیسے پروٹوکول کے ذریعے ایجنٹ۔

جہاں A2A مستقبل میں فٹ ہو سکتا ہے۔

A2A OpenClaw میں دو اہم طریقوں سے فٹ ہو سکتا ہے:

آپشن 1: OpenClaw بطور A2A کلائنٹ

اس ماڈل میں، OpenClaw ایک پرسنل ایج اسسٹنٹ کے طور پر کام کرتا ہے۔

اسے ڈیش بورڈ یا چیٹ ایپ سے ایک درخواست موصول ہوتی ہے، یہ فیصلہ کرتا ہے کہ ٹاسک کے لیے ایک ماہر کی ضرورت ہے، ایجنٹ کارڈ کے ذریعے ریموٹ A2A ایجنٹ کو تلاش کرتا ہے، ٹاسک بھیجتا ہے، اپ ڈیٹ یا آرٹفیکٹ کا انتظار کرتا ہے، اور پھر نتیجہ کو ایک باقاعدہ OpenClaw جواب میں تبدیل کرتا ہے۔

یہ ذاتی معاونین کے بارے میں ایک صاف ستھری کہانی ہے۔ OpenClaw سامنے کے دروازے کو برقرار رکھتا ہے اور A2A پردے کے پیچھے وفد کا راستہ بن جاتا ہے۔

آپشن 2: اوپن کلاؤ بطور A2A سرور

اس ماڈل میں، OpenClaw اپنی کچھ فعالیت کو دوسرے ایجنٹوں کے سامنے لاتا ہے۔

ایک پلگ ان نظریاتی طور پر A2A ایجنٹ کارڈ پوسٹ کر سکتا ہے، مہارتوں کے ایک محدود سیٹ کی تشہیر کر سکتا ہے، A2A کے کاموں کو قبول کر سکتا ہے، اور ان کاموں کو OpenClaw سیشنز یا subagent executions میں نقش کر سکتا ہے۔

یہ تکنیکی طور پر قابل فہم ہے کیونکہ پلگ ان سسٹم HTTP روٹس، ٹولز، گیٹ وے کے طریقے، اور پس منظر کی خدمات کو رجسٹر کر سکتا ہے۔

یہ ذاتی معاونین کے لیے بھی خطرناک سمت ہے۔ تو یہاں ہے کیوں میں سوچتا ہوں: سب سے پہلے کلائنٹ یہ صحیح نقطہ آغاز ہے۔

اوپن کلاؤ نے A2A پلگ ان فن تعمیر کے لیے تجویز کیا ہے۔

یہ حصہ مضمون میں میری اصل شراکت ہے۔

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

ڈیزائن کا مقصد آسان ہے:

اوپن کلاؤ کو صارف کے ساتھ ہونے والی گفتگو اور مقامی ٹول تک رسائی کے لیے دوبارہ استعمال کریں، لیکن A2A کا استعمال صرف اس صورت میں کریں جب یہ کام کرنے کے لیے دور دراز کے ماہر ایجنٹوں کے لیے بہترین جگہ ہو۔

یہاں وہ فن تعمیر ہے جس کے ساتھ میں شروع کروں گا:

یہ ڈیزائن OpenClaw کے لیے موزوں کیوں ہے۔

یہ تجویز ایکسٹینشن پوائنٹس پر بنتی ہے جو OpenClaw کے ذریعہ پہلے سے دستاویزی ہے۔

پلگ ان رجسٹر کر سکتے ہیں:

نہیں ایجنٹ کے اوزار وفد کے لیے،
کوئی راستہ نہیں گیٹ وے کا طریقہ صحت اور تشخیص کے لیے،
نہیں HTTP پاتھ مستقبل کے کال بیکس یا ویب ہکس چیک کرنے کے لیے
کوئی راستہ نہیں پس منظر کی خدمت کیش وارمنگ، جاب سبسکرپشن یا صفائی کے لیے۔

اس کا مطلب یہ ہے کہ پل کے قابل اعتماد ہونے کے لیے OpenClaw کور میں ترمیم کرنے کی ضرورت نہیں ہے۔

نقشہ سازی کی میز

سب سے اہم ڈیزائن کا فیصلہ یہ ہے کہ اوپن کلاؤ کے سیشن ماڈل کو A2A کے ٹاسک ماڈل میں کیسے نقشہ بنایا جائے۔

میری تجویز کردہ نقشہ سازی مندرجہ ذیل ہے:

اوپن کلا تصورات	A2A کا تصور	یہ میپنگ کیوں کام کرتی ہے۔
`sessionKey`	`contextId`	ایک واحد OpenClaw گفتگو کو اپنے متعلقہ وفد کے موڑ کے دوران ایک مستحکم دور دراز سیاق و سباق کو برقرار رکھنا چاہیے۔
1 ڈیلیگیٹڈ ریموٹ کال	ایک `Task`	ہر دور دراز کی مہارت کی درخواست کام کی انفرادی اکائی بن جاتی ہے۔
پلگ ان ٹول کو کال کریں۔	`SendMessage`	ڈیلی گیشن ٹولز ایک قدرتی نقطہ ہے جس پر مقامی ایجنٹ پروٹوکول کی حدود کو عبور کرتے ہیں۔
ریموٹ آؤٹ پٹ	`Artifact`	A2A چاہتا ہے کہ آپریشن کے آؤٹ پٹ کو صرف چیٹ کے جواب کے بجائے ایک نمونے کے طور پر واپس کیا جائے۔
پلگ ان HTTP پاتھ	کال بیک یا مستقبل کا پش ہینڈلر	اگر آپ بعد میں غیر مطابقت پذیر پش کو اپناتے ہیں تو ویب ہکس کو چیک کرنے کے لیے ایک جگہ فراہم کرتا ہے۔
گیٹ وے کا طریقہ	ریاست کا اختتامی نقطہ	آپریٹرز کو کسی ماڈل سے گزرے بغیر ریلے کی حیثیت چیک کرنے کا براہ راست طریقہ فراہم کرتا ہے۔
پس منظر کی خدمت	پولنگ یا کیش آپریشنز	ٹول کال پاتھ میں غیر مطابقت پذیر اور دیکھ بھال کے کاموں کو رکھتا ہے۔

اس مضمون کے اہم تعمیراتی دعوے یہ ہیں:

ہم ایک OpenClaw سیشن کو طویل عرصے تک رہنے والی بات چیت کی باؤنڈری کے طور پر دیکھتے ہیں، اور ہر دور دراز A2A آپریشن کو اس حد کے اندر ایک واحد ڈیلیگیٹڈ ایگزیکیوشن کے طور پر دیکھتے ہیں۔

دونوں اطراف کو صاف رکھتا ہے۔

اپنے ڈیزائن کو ایک جملے میں بیان کریں۔

کہ a2a_delegate ٹول لازمی ہے:

وائٹ لسٹ شدہ ریموٹ ایجنٹ کارڈز کو حل کریں،
موجودہ A2A دوبارہ استعمال کریں۔ contextId موجودہ کے لئے sessionKey اگر ممکن ہو تو،
ایک نیا ریموٹ کنٹرول بنائیں Task وفد کی نئی باری کے لیے،
دور دراز کے نمونے کو معمول کے مطابق ایک سادہ مقامی ردعمل میں واپس کریں۔
پورے OpenClaw گیٹ وے کو براہ راست عوامی انٹرنیٹ پر نہ ظاہر کریں۔

مجھے یہ ڈیزائن پسند ہے کیونکہ یہ ترقی پسند، قابل آزمائش اور OpenClaw کے ذاتی معاون ٹرسٹ ماڈل کے مطابق ہے۔

ایک پروف آف تصور ریلے کی تعمیر

فن تعمیر کو کنکریٹ بنانے کے لیے، ہم نے تصور کا ایک چھوٹا ثبوت ریلے بنایا۔

https://github.com/natarajsundar/openclaw-a2a-secure-agent-runtime

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

ذخیرے کی ترتیب حسب ذیل ہے:

openclaw-a2a-secure-agent-runtime/
├── README.md
├── package.json
├── examples/
│   └── openclaw-plugin-entry.example.ts
├── src/
│   ├── a2a-client.mjs
│   ├── agent-card-cache.mjs
│   ├── demo.mjs
│   ├── mock-remote-agent.mjs
│   ├── openclaw-a2a-relay.mjs
│   ├── session-task-map.mjs
│   └── utils.mjs
└── test/
    └── relay.test.mjs

PoC چھ کام انجام دیتا ہے:

ریموٹ ایجنٹ کارڈ حاصل کریں۔ /.well-known/agent-card.json,
سادہ ذخیرہ۔ ETag دوبارہ توثیق،
مقامی ریکارڈ sessionKey دور سے contextId نقشہ سازی،
A2A بھیج رہا ہے۔ SendMessage درخواست،
انتخابات GetTask جب تک یہ ختم نہ ہو جائے، اور
دور دراز کے نمونے کو مقامی متن کے جوابات میں تبدیل کریں۔

ڈیمو چلائیں۔

ریپوزٹری صرف بلٹ ان Node.js ماڈیولز استعمال کرتی ہے۔

cd openclaw-a2a-secure-agent-runtime
npm run demo

ڈیمو ایک فرضی ریموٹ A2A سرور کو گھماتا ہے، ایک ٹاسک ڈیلیگ کرتا ہے، اور دوسرا ٹاسک ڈیلیٹ کرتا ہے۔ ایک ہی یہ ایک مقامی سیشن ہے اور یہ ظاہر کرتا ہے کہ ایک جیسی ریموٹ سیشن ہے۔ contextId اسے دوبارہ استعمال کیا جاتا ہے۔

کلیدی ریلے آئیڈیاز

یہ سادہ انگریزی میں منطق کا ایک اہم حصہ ہے۔

OpenClaw کے لیے آج ہی تازہ ترین ریموٹ میپنگ تلاش کریں۔ sessionKey
پرانی چیزوں کو دوبارہ استعمال کریں۔ contextId اگر یہ موجود ہے
ایک نیا A2A بنائیں Task نئی درخواستوں کے بارے میں
اس کام کے لیے رائے شماری کریں۔ TASK_STATE_COMPLETED
واپس کیے گئے نمونے کو سادہ متن کے نتائج میں تبدیل کرتا ہے جسے OpenClaw صارف کو واپس بھیج سکتا ہے۔

اس سے پل کا اندازہ لگایا جا سکتا ہے۔

یہاں ریلے منطق کا ایک مختصر ورژن ہے:

const previous = await sessionTaskMap.latestForSession(sessionKey, remoteBaseUrl);
const contextId = previous?.contextId ?? crypto.randomUUID();

const sendResult = await client.sendMessage({
  text,
  contextId,
  metadata: {
    openclawSessionKey: sessionKey,
    requestedSkillId: skillId,
  },
});

let task = sendResult.task;
while (!isTerminalTaskState(task.status?.state)) {
  await sleep(pollIntervalMs);
  task = await client.getTask(task.id);
}

return {
  contextId,
  taskId: task.id,
  answer: taskArtifactsToText(task),
};

یہ ڈیزائن کا جوہر ہے۔

کیوں یہ ذخیرہ تصور کا ایک مفید ثبوت ہے۔

بہت سے "انضمام” مضامین بہت خلاصہ ہیں۔ یہ ذخیرہ تین طریقوں سے اس مسئلے سے بچتا ہے:

سب سے پہلے، ہم سیشن ٹو سیاق و سباق کی نقشہ سازی کو واضح کرتے ہیں۔

دوسرا، اس میں ایک فرضی ریموٹ A2A ایجنٹ شامل ہے، جو آپ کو وسیع بیرونی سیٹ اپ کے بغیر اپنے بہاؤ کو جانچنے کی اجازت دیتا ہے۔

تیسرا، اس میں سب سے اہم تبدیلی کو جانچنے کے لیے ٹیسٹ شامل ہیں۔ ایک مقامی OpenClaw سیشن میں بار بار وفود اسی A2A سیاق و سباق کو دوبارہ استعمال کرتے ہیں۔

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

تصور کا ثبوت ایک حقیقی OpenClaw پلگ ان پر کیسے نقش ہوتا ہے۔

تصور کا ثبوت ریلے کور ہے۔

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

1: وفد کا آلہ

یہ مرکزی داخلی نقطہ ہے۔

پلگ ان درج ذیل اختیاری ٹولز کو رجسٹر کرتا ہے: a2a_delegate اس کے بعد مقامی ایجنٹ واضح طور پر کام کو سونپنے کا انتخاب کر سکتے ہیں۔

چونکہ ریموٹ ڈیلیگیشن ایک ضمنی اثر ہے اور اسے آسانی سے غیر فعال ہونا چاہیے، اس لیے ٹول کو ہمیشہ آن کی بجائے اختیاری ہونا چاہیے۔

2: تشخیص کے لیے گیٹ وے کا طریقہ

درج ذیل طریقہ a2a.status آپ چیک کر سکتے ہیں کہ آیا ریلے صحت مند ہے، کون سے ریموٹ کارڈز کیش کیے گئے ہیں، اور کیا کوئی کام ابھی بھی ٹریک کیے جا رہے ہیں۔

یہ ماڈل سے یہ پوچھنے سے کہیں بہتر ہے کہ "مجھے بتائیں کہ کیا آپ کی ٹانگیں صحت مند ہیں۔”

3: پلگ ان HTTP پاتھ

ہو سکتا ہے آپ کو اپنے پہلے دن اس کی ضرورت نہ ہو۔

تاہم، اگر آپ پولنگ سے آگے جانا چاہتے ہیں اور پش اسٹائل کال بیکس یا ویب ہکس کی جانچ کرنا چاہتے ہیں، تو پلگ ان روٹ اس آپریشن کے لیے صحیح حدیں فراہم کرتا ہے۔

4: پس منظر کی خدمت

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

یہ ٹول پاتھ کو دیکھ بھال کے کاموں کے بجائے وفد پر مرکوز رکھتا ہے۔

اسے ایک حقیقی پلگ ان پیکیج میں تبدیل کرنے کے لیے، آپ کاموں کو درج ذیل ترتیب میں ترتیب دیں گے:

ریلے لپیٹ registerTool,
ریموٹ ایجنٹ وائٹ لسٹ کے ساتھ ایک چھوٹا کنفیگریشن اسکیما شامل کریں،
شامل کریں a2a.status,
پہلے غیر مطابقت پذیر ماڈل کے ساتھ پولنگ جاری رکھیں،
کال بیک روٹس صرف اس وقت شامل کریں جب آپ کے اصل استعمال کے معاملے کے لیے ضروری ہو۔

یہ تھیوری سے پریکٹیکل اسکیلنگ کا سب سے زیادہ عملی راستہ ہے۔

ہم نے ایک فرضی ریموٹ ایجنٹ کا استعمال کرتے ہوئے مقامی طور پر ریلے کے بہاؤ کا تجربہ کیا اور اس بات کی تصدیق کی کہ ایک ہی مقامی سیشن سے بار بار آنے والے وفود اسی ریموٹ ایجنٹ کو دوبارہ استعمال کرتے ہیں۔ contextId.

اس سے پہلے کہ ہم آگے بڑھیں سیکیورٹی نوٹ

یہ ایک ایسا حصہ ہے جسے آپ کو نہیں چھوڑنا چاہیے۔

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

اس کا براہ راست اثر A2A پر پڑتا ہے۔

A2A ایجنٹ کے نظاموں اور تنظیمی حدود میں مواصلت کے لیے ڈیزائن کیا گیا ہے۔ یہ ایک طاقتور، لیکن ایک واحد، نجی OpenClaw تعیناتی سے مختلف خطرہ ماڈل ہے۔

تو ایک محفوظ ڈیزائن ہے۔ ~ نہیں یہ:

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

ایک محفوظ ڈیزائن یہ ہوگا:

یہ خاکہ دو الگ الگ اعتماد کی حدود کو ظاہر کرتا ہے۔

بائیں آپ کا ہے پرائیویٹ اوپن کلا ڈسٹری بیوشن. اس میں گیٹ ویز، سیشنز، ورک اسپیس، اور کوئی بھی اسناد یا ٹولز شامل ہیں جن تک ایجنٹ رسائی کر سکتا ہے۔ یہ دائرہ ایک واحد، قابل بھروسہ آپریٹر کے لیے ڈیزائن کیا گیا ہے۔

دائیں طرف بیرونی A2A ماحولیاتی نظامیہ وہ جگہ ہے جہاں دور دراز کے ایجنٹ رہتے ہیں۔ ان ایجنٹوں کا تعلق مختلف ٹیموں یا تنظیموں سے ہو سکتا ہے اور مختلف حفاظتی مفروضوں کے تحت کام کر سکتے ہیں۔

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

یہ علیحدگی آپ کو اپنے ذاتی اسسٹنٹ کے ماحول کو محفوظ رکھتے ہوئے ایجنٹ انٹرآپریبلٹی کے ساتھ تجربہ کرنے کی اجازت دیتی ہے۔

اپنے ذاتی معاون کی حدود کو سادہ انگریزی میں نجی رکھیں۔

اگر آپ A2A کے ساتھ تجربہ کر رہے ہیں، تو اسے اس طرح سنبھالیں: نمائش کی حدیں الگ کریں۔ اس کی اپنی وائٹ لسٹ، توثیق اور آپریشنل کنٹرولز ہیں۔

یہی وجہ ہے کہ اس مضمون میں تصور کا ثبوت ریلے ایک واضح ریموٹ وائٹ لسٹ سے شروع ہوتا ہے۔

یہ ڈیزائن کیوں اور دوسرا نہیں؟

ایک فطری سوال یہ ہے کہ یہ مضمون کیوں؟ آؤٹ باؤنڈ صرف A2A پل کی ترجیحباکس سے باہر مکمل دو طرفہ یا سرور طرز کا انضمام بنانے کے بجائے۔

مختصر جواب یہ ہے کہ OpenClaw کا موجودہ ڈیزائن ارد گرد مرکوز ہے: پرسنل اسسٹنٹ ٹرسٹ بارڈرایک آپریٹر گیٹ وے، سیشنز اور ٹولز کو کنٹرول کرتا ہے۔ اپنے ماحول میں بیرونی ایجنٹوں کو متعارف کروانے کے لیے اس پر محتاط کنٹرول کی ضرورت ہوتی ہے جو ظاہر ہو رہی ہے۔

آؤٹ باؤنڈ وفد کے ساتھ شروع کرنا ایک محفوظ، زیادہ بتدریج راستہ فراہم کرتا ہے۔

صرف آؤٹ باؤنڈ ترجیح کا مطلب ہے:

نجی ثانوی اعتماد کی حدود کو محفوظ رکھنے سے، مقامی OpenClaw کی تعیناتیاں نجی رہتی ہیں اور آپریٹرز کے زیر کنٹرول رہتی ہیں۔
اوپن کلاؤ گیٹ وے کو عوامی A2A سرور کے طور پر ظاہر نہ کریں اس سے پہلے کہ مضبوط تصدیق، پالیسیاں اور مانیٹرنگ موجود ہو۔
آپ انٹرآپریبلٹی کو مکمل طور پر پیچیدہ کیے بغیر ریموٹ ڈیلی گیشن پیٹرن (ایجنٹ کارڈز، ٹاسک، نمونے) کی جانچ کر سکتے ہیں۔
ہم OpenClaw کو یوزر سائیڈ کنٹرول جہاز کے طور پر رکھتے ہیں، اور ریموٹ ایجنٹ اختیاری ماہرین کے طور پر کام کرتے ہیں۔

یہ نقطہ نظر عام نظام کے ڈیزائن کے نمونوں کی پیروی کرتا ہے۔ کنٹرول شدہ آؤٹ باؤنڈ انضمامرویے اور رکاوٹوں کی توثیق کرنے کے بعد، ان باؤنڈ یا دو طرفہ مواصلات تک توسیع پر غور کریں۔

عملی طور پر، اس کا مطلب ہے کہ آپ A2A کے ساتھ محفوظ طریقے سے تجربہ کر سکتے ہیں، یہ جان سکتے ہیں کہ ماڈل کس طرح ایک ساتھ فٹ ہوتے ہیں، اور اپنے سسٹم کو ابتدائی طور پر غیر ضروری خطرات اٹھائے بغیر تیار کر سکتے ہیں۔

حتمی خیالات

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

سب سے آسان ابتدائی راستہ اب بھی صحیح ہے۔

اسے انسٹال کریں،
آن بورڈنگ کو انجام دیں،
گیٹ وے چیک کریں،
ڈیش بورڈ کھولیں،
ایک نجی ورک فلو آزمائیں۔

یہ پہلے سے ہی ایک حقیقی اینڈ ٹو اینڈ سیٹ اپ ہے۔

A2A بات چیت میں شامل ہے کیونکہ یہ بعد میں OpenClaw کو دور دراز کے ماہر ایجنٹوں سے مربوط کرنے کا ایک قابل اعتماد طریقہ فراہم کرتا ہے۔

لیکن اس مضمون کے بارے میں سب سے اہم بات یہ نہیں ہے یہ ایک بارڈر ڈیزائن ہے۔

OpenClaw کو ایک پرائیویٹ صارف کا سامنا کرنے والے کنارے کے طور پر رکھ کر اور آؤٹ باؤنڈ ڈیلی گیشن کے لیے ایک تنگ پلگ ان برج کا استعمال کرتے ہوئے، OpenClaw سیشن ماڈل اور A2A ٹاسک ماڈل کو اچھی طرح سے ملایا جا سکتا ہے۔

یہ وہ آرکیٹیکچرل آئیڈیا ہے جسے میں یہاں کنکریٹ میں بنانا چاہتا تھا۔

ڈایاگرام انتساب

اس دستاویز کے تمام خاکے مصنف نے خاص طور پر اس گائیڈ کے لیے بنائے تھے۔