منصوبے کے بارے میں

IronClaw ایک اوپن سورس "Agent OS" ہے جو ایک محفوظ ذاتی AI اسسٹنٹ کے طور پر پیش کیا گیا ہے جو ڈیٹا کو صارف کے کنٹرول میں رکھتا ہے۔ یہ OpenClaw سے متاثر ہو کر Rust میں دوبارہ لکھا گیا ہے، اور macOS، Linux اور Windows/WSL کے لیے پہلے سے تیار انسٹالرز کی صورت میں تقسیم کیا جاتا ہے، جبکہ سورس سے بنانے کے لیے Rust 1.96+ اور Node.js 22+ مع pnpm درکار ہیں۔ سیٹ اپ کا مرکز ایک رہنمائی والا `ironclaw onboard` کمانڈ ہے: صارف ایک LLM پرووائیڈر منتخب کرتا ہے، چھپے ہوئے پرامپٹ کے ذریعے API کلید درج کرتا ہے، اور IronClaw لوکل کنفیگریشن، ایک انکرپٹڈ کریڈینشل اسٹور اور ایک WebUI لاگ ان ٹوکن تیار کرتا ہے۔ macOS اور Linux پر یہ ایک بیک گراؤنڈ سروس بھی انسٹال اور شروع کرتا ہے اور ایک WebUI لنک پرنٹ کرتا ہے؛ `ironclaw status` اسے دوبارہ پرنٹ کرتا ہے، اور Windows صارفین `ironclaw serve` کو فارگراؤنڈ میں چلا سکتے ہیں۔ کنفیگریشن CLI کمانڈز جیسے `ironclaw models set-provider`، `ironclaw config set` اور `ironclaw config list` کے ذریعے منظم کی جاتی ہے؛ راز ہمیشہ پرامپٹ کے ذریعے مانگے جاتے ہیں نہ کہ آرگیومنٹس کے طور پر پاس کیے جاتے ہیں، اور کنفیگریشن تبدیلیاں سروس کو خودکار طور پر ری اسٹارٹ نہیں کرتیں۔ بیان کردہ فلسفہ لوکل، انکرپٹڈ، آڈٹ کے قابل آپریشن ہے جس میں کوئی ٹیلی میٹری یا ڈیٹا ہارویسٹنگ نہیں، نیز خود کو بڑھانے والی صلاحیتیں اور کثیر پرتی سلامتی۔ سلامتی کی خصوصیات میں غیر قابل اعتماد ٹولز کے لیے WASM سینڈ باکس مع قابلیت پر مبنی اجازتیں، اینڈ پوائنٹ allowlisting، میزبان کی حد پر کریڈینشل انجیکشن مع لیک کا پتہ لگانا، شرح اور وسائل کی حدود، اور پرامپٹ-انجیکشن دفاع شامل ہیں جو پیٹرن کا پتہ لگانے، صفائی، شدت کی سطحوں والے پالیسی قواعد، اور ٹول آؤٹ پٹ ریپنگ کو یکجا کرتا ہے۔ رازوں کو AES-256-GCM کے ساتھ انکرپٹڈ بتایا گیا ہے، اور ٹول کے نفاذ آڈٹ کے لیے لاگ کیے جاتے ہیں۔ عملی طور پر، IronClaw متعدد چینلز کی حمایت کرتا ہے (REPL، HTTP webhooks، WASM چینلز جیسے Telegram اور Slack، اور SSE/WebSocket اسٹریمنگ والا ایک ویب گیٹ وے)، فی جاب ٹوکنز والا ایک Docker سینڈ باکس اور ایک آرکیسٹریٹر/ورکر پیٹرن، cron- اور ایونٹ سے چلنے والے روٹینز، بیک گراؤنڈ ٹاسکس کے لیے ایک ہارٹ بیٹ سسٹم، متوازی جاب نفاذ، اور پھنسے ہوئے آپریشنز کی خود مرمت۔ ٹولز کو WASM ماڈیولز کے طور پر متحرک طور پر بنایا جا سکتا ہے، اور بیرونی صلاحیتوں کو جوڑنے کے لیے Model Context Protocol کی حمایت ہے؛ پلگ انز کو دوبارہ شروع کیے بغیر شامل کیا جا سکتا ہے۔ میموری مستقل ہے، جو ایک ورک اسپیس فائل سسٹم کے علاوہ ہائبرڈ فل ٹیکسٹ اور ویکٹر سرچ کا استعمال کرتی ہے جو Reciprocal Rank Fusion کے ذریعے یکجا کیے جاتے ہیں، ساتھ ہی مستقل شخصیت اور ترجیحات کے لیے شناختی فائلیں۔ آرکیٹیکچر ڈایاگرام ایک ایجنٹ لوپ، انٹینٹ روٹر، شیڈیولر، ورکرز، آرکیسٹریٹر، ٹول رجسٹری، روٹینز انجن، ویب گیٹ وے اور سیفٹی لیئر کا خاکہ پیش کرتا ہے۔ ڈیولپمنٹ معیاری Rust ٹولنگ استعمال کرتی ہے (cargo fmt، clippy، PostgreSQL ٹیسٹ ڈیٹا بیس کے خلاف ٹیسٹس)، اور پروجیکٹ MIT یا Apache-2.0 کے تحت دوہری لائسنس یافتہ ہے۔