nanoclaw v2.2.0
بديل خفيف الوزن لـ OpenClaw يعمل في الحاويات للأمان. يتصل بـ WhatsApp، Telegram، Slack، Discord، Gmail وتطبيقات المراسلة الأخرى،، لديه ذاكرة، مهام مجدولة، ويعمل مباشرةً على Anthropic's Agents SDK
مساعد ذكاء اصطناعي يشغّل الوكلاء بأمان داخل حاوياتهم الخاصة. خفيف الوزن، مصمم ليكون سهل الفهم وقابلاً للتخصيص بالكامل وفقاً لاحتياجاتك.
nanoclaw.dev •
docs •
中文 •
日本語 •
한국어 •
وكلاء في Slack: تطبيق واحد لكل وكيل 
يقوم الإعداد بتوفير تطبيق Slack خاص بكل وكيل: manifest، وصورة رمزية، وتثبيت في مساحة العمل، دون الحاجة إلى لصق أي رموز. أنشئ زملاء من المحادثة: كل واحد منهم يحصل على هوية بوت خاصة به، وحاوية، وذاكرة، مع غرف ولوحات مشتركة.
لماذا بنيت NanoClaw
OpenClaw مشروع مثير للإعجاب، لكنني لم أكن لأستطيع النوم لو منحت برنامجاً معقداً لا أفهمه وصولاً كاملاً إلى حياتي. يحتوي OpenClaw على ما يقارب نصف مليون سطر من التعليمات البرمجية، و53 ملف إعدادات، وأكثر من 70 تبعية. أمنه على مستوى التطبيق (قوائم السماح، رموز الاقتران) بدلاً من العزل الحقيقي على مستوى نظام التشغيل. كل شيء يعمل في عملية Node واحدة بذاكرة مشتركة.
يوفر NanoClaw نفس الوظائف الأساسية، لكن بقاعدة تعليمات برمجية صغيرة بما يكفي لفهمها: عملية واحدة ومجموعة قليلة من الملفات. يعمل الوكلاء في حاويات Linux خاصة بهم مع عزل نظام الملفات، وليس فقط خلف فحوصات الأذونات.
البدء السريع
git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash nanoclaw.sh
يأخذك nanoclaw.sh من جهاز جديد إلى وكيل مسمّى يمكنك مراسلته. يثبّت Node وpnpm وDocker إذا كانت مفقودة، ويثبّت بوابة بيانات اعتماد ويسجّل بيانات اعتماد Anthropic الخاصة بك لديها، ويبني حاوية الوكيل، ويقترن بقناتك الأولى (Slack، Telegram، Discord، WhatsApp، iMessage، أو CLI محلي). إذا فشلت خطوة ما، يتم استدعاء Claude Code تلقائياً لتشخيص المشكلة والاستئناف من حيث توقفت.
هل تنتقل من NanoClaw v1؟
شغّل من نسخة v2 جديدة بجانب تثبيت v1 الخاص بك:
git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash migrate-v2.sh
يعثر migrate-v2.sh على تثبيت v1 الخاص بك (دليل شقيق، أو NANOCLAW_V1_PATH=/path/to/nanoclaw)، وينقل الحالة إلى نسخة v2، ثم ينفّذ exec إلى Claude Code لإكمال الأجزاء التي تحتاج إلى تقدير (تهيئة المالك، وترحيل الذاكرة المشتركة، وإعادة تشغيل تخصيصات التفرّع).
شغّل السكربت مباشرة، وليس من داخل جلسة Claude — يحتاج الجانب الحتمي إلى مطالبات تفاعلية وإدخال/إخراج shell حقيقي لتهيئة Node/pnpm، وDocker، وبوابة بيانات الاعتماد، وبناء الحاوية.
ما الذي يفعله: يدمج .env، ويهيّئ قاعدة بيانات v2 من registered_groups، وينسخ مجلدات المجموعات + بيانات الجلسة + المهام المجدولة، ويثبّت محوّلات القنوات التي تختارها، وينسخ حالة مصادقة القنوات (بما في ذلك مخزن مفاتيح Baileys لـ WhatsApp — حيث يتم الآن حل تعيين LID لكل رسالة بواسطة محوّل Baileys v7، وليس ترحيله)، ويبني حاوية الوكيل.
ما الذي لا يفعله: لا يبدّل خدمة النظام. اختر "switch to v2" عند المطالبة، أو افعل ذلك يدوياً بعد الاختبار — يبقى تثبيت v1 الخاص بك دون مساس.
راجع docs/v1-to-v2-changes.md لمعرفة ما تغيّر وdocs/migration-dev.md لملاحظات التطوير.
الفلسفة
صغير بما يكفي لفهمه. عملية واحدة، وبضعة ملفات مصدرية، ولا خدمات مصغّرة. إذا أردت فهم قاعدة تعليمات NanoClaw البرمجية بالكامل، فاطلب من Claude Code أن يشرحها لك.
آمن بالعزل. يعمل الوكلاء في حاويات Linux ولا يمكنهم رؤية سوى ما يتم تركيبه صراحةً. الوصول إلى Bash آمن لأن الأوامر تعمل داخل الحاوية، وليس على مضيفك.
مصمم للمستخدم الفردي. NanoClaw ليس إطاراً ضخماً؛ بل برنامج يلبي الاحتياجات الدقيقة لكل مستخدم. بدلاً من أن يصبح برنامجاً منتفخاً، صُمم NanoClaw ليكون مخصصاً. تنشئ تفرّعك الخاص وتطلب من Claude Code تعديله ليلائم احتياجاتك.
التخصيص = تغييرات في التعليمات البرمجية. لا تشتّت في الإعدادات. تريد سلوكاً مختلفاً؟ عدّل التعليمات البرمجية. قاعدة التعليمات البرمجية صغيرة بما يكفي ليكون إجراء التغييرات آمناً.
أصيل بالذكاء الاصطناعي، هجين بالتصميم. مسار التثبيت والإعداد هو مسار نصي محسّن، سريع وحتمي. عندما تحتاج خطوة إلى تقدير، سواء كان تثبيتاً فاشلاً، أو قراراً موجهاً، أو تخصيصاً، تنتقل السيطرة إلى Claude Code بسلاسة. وبعد الإعداد لا توجد لوحة مراقبة أو واجهة تصحيح أخطاء أيضاً: صف المشكلة في المحادثة ويتولى Claude Code الأمر.
المهارات قبل الميزات. يوفّر الفرع الرئيسي السجل والبنية التحتية، وليس محوّلات قنوات محددة أو مزوّدي وكلاء بديلين. تعيش القنوات (Discord، Slack، Telegram، WhatsApp، …) على فرع channels طويل الأمد؛ ويعيش المزوّدون البديلون (OpenCode، Ollama) على providers. تشغّل /add-telegram، /add-opencode، إلخ، وتنسخ المهارة بالضبط الوحدة (الوحدات) التي تحتاجها إلى تفرّعك. لا ميزة لم تطلبها.
أفضل إطار، أفضل نموذج. يستخدم NanoClaw أصلاً Claude Code عبر Claude Agent SDK الرسمي من Anthropic، فتحصل على أحدث نماذج Claude ومجموعة أدوات Claude Code الكاملة، بما في ذلك القدرة على تعديل وتوسيع تفرّع NanoClaw الخاص بك. المزوّدون الآخرون خيارات جاهزة: /add-codex لـ Codex من OpenAI (اشتراك ChatGPT أو مفتاح API)، و/add-opencode لـ OpenRouter وGoogle وDeepSeek والمزيد عبر OpenCode، و/add-ollama-provider لنماذج الأوزان المفتوحة المحلية. المزوّد قابل للتهيئة لكل مجموعة وكلاء.