الانتقال إلى المحتوى الرئيسي
NanoClaw هو مساعد ذكاء اصطناعي خفيف الوزن ومستضاف ذاتيًا يعمل على WhatsApp وTelegram. يضيف هذا التفرّع دعم Venice AI ليعمل كل شيء بخصوصية تامة دون الحاجة إلى اشتراك Anthropic.

ادفع لكل توكن

لا اشتراك. ادفع فقط مقابل ما تستخدمه

استدلال خاص

عدم الاحتفاظ بأي بيانات على خوادم Venice

عزل Docker

كل محادثة تعمل في حاوية آمنة خاصة بها

​
لماذا Venice AI؟

Venice منصة ذكاء اصطناعي تضع الخصوصية أولًا. وهم لا يخزّنون أو يسجّلون أي طلبات أو ردود على خوادمهم — محادثاتك موجودة فقط على جهازك. تُشفَّر الطلبات من طرف إلى طرف عبر وكيلهم إلى مزوّدي GPU اللامركزيين، مع عدم الاحتفاظ بأي بيانات. هذا يعني أن محادثات مساعد الذكاء الاصطناعي الخاص بك تبقى خاصة، حتى من Venice أنفسهم. تتيح Venice وصولًا مجهول الهوية إلى النماذج المتطورة (Claude Opus، Claude Sonnet) ووصولًا خاصًا بالكامل إلى النماذج مفتوحة المصدر (GLM، Qwen) عبر واجهة API واحدة — بدّل بينها متى شئت.
Venice AIمزوّدو الذكاء الاصطناعي التقليديون
الاحتفاظ بالبياناتلا شيء — صفر سجلاتنعم
خصوصية الطلباتمشفّرة، ولا تُخزَّن أبدًاتُخزَّن على خوادم المزوّد
النماذج مفتوحة المصدرنعم (GLM وQwen وغيرها)لا
النماذج المتطورةClaude وGPT وغيرها — بشكل مجهول الهويةفقط عبر الاشتراكات المباشرة
التسعيرالدفع لكل توكن، بدون اشتراك. أو ضع DIEM للحصول على رصيد يتجدد يوميًااشتراكات بقيمة 20-200 دولار/شهر أو API بالدفع لكل توكن
الاستدلال غير الخاضع للرقابةنعم (النماذج مفتوحة المصدر)لا

​
لماذا NanoClaw؟

NanoClaw بديل نظيف وبسيط للمنصات الأكبر مثل OpenClaw. مصمّم لشخص واحد يدير بوتًا واحدًا.
NanoClaw (Venice)OpenClaw
الشيفرة~2000 سطر، عدد قليل من الملفات~500,000 سطر، 53 ملف إعداد
التبعيات~15 حزمةأكثر من 70 حزمة
نموذج الأمانعزل حاوية Docker على مستوى نظام التشغيلقوائم سماح وأكواد إقران على مستوى التطبيق
العزل لكل مجموعةكل مجموعة تحصل على حاوية ونظام ملفات وذاكرة خاصة بهاعملية مشتركة وذاكرة مشتركة
الإعدادمعالج واحد (/setup)، نحو 10 دقائقإعداد يدوي متعدد الخطوات
مزوّد الذكاء الاصطناعيVenice AI (خاص، بدون اشتراك)Anthropic (يتطلب مفتاح API أو اشتراكًا)
التخصيصعدّل الشيفرة مباشرة — صغيرة بما يكفي لقراءتهاملفات إعداد وملحقات
المستخدم المستهدفشخص واحد، بوت واحدمنصة متعددة المستخدمين

​
ما الذي ستحصل عليه

  • مساعد ذكاء اصطناعي شخصي على Telegram و/أو WhatsApp
  • مدعوم بـ Venice AI — لا حاجة لحساب Anthropic
  • البوت يعمل في حاوية Docker معزولة (سندبوكس، لا يستطيع الوصول إلى نظامك)
  • تبديل النماذج — أخبر البوت “switch to zai-org-glm-5” أو “use opus” في أي وقت
  • مهام مجدولة — ضع تذكيرات ومهام متكررة
  • بحث وتصفّح ويب مدمج
  • تنسيق Markdown في رسائل Telegram

​
المتطلبات المسبقة

Node.js 20+

تحقّق باستخدام node --version

Docker

قم بتثبيته وفتحه مرة واحدة ليعمل

Claude Code CLI

تحقّق باستخدام claude --version

مفتاح Venice API

أنشئه من حسابك في Venice
لـ Telegram (موصى به للمستخدمين الجدد):
  1. افتح Telegram وابحث عن @BotFather
  2. أرسل /newbot واتبع التعليمات
  3. احفظ التوكن الذي يعطيه لك BotFather (يبدو مثل 123456789:ABCdef...)
لـ WhatsApp — استخدم رقمًا افتراضيًا، وليس رقمك الشخصي:يتصل NanoClaw كجهاز مرتبط بحساب WhatsApp الخاص بك. هذا يعني أن الوكيل يمكنه رؤية كل رسالة واردة وصادرة — جميع محادثاتك الشخصية، والمحادثات الجماعية، والصور، وكل شيء. هاتفك سيستمر بالعمل بشكل طبيعي، لكن البوت سيكون لديه رؤية كاملة لكامل حساب WhatsApp الخاص بك.استخدم رقم هاتف افتراضي بدلًا من ذلك. توفّر هذه التطبيقات رقمًا ثانيًا يمكنك تخصيصه بالكامل للبوت:
التطبيقالسعرملاحظات
Hushed~5 دولار/شهرموثوق، يعمل جيدًا للتحقق من WhatsApp
Burner~5 دولار/شهرمشابه لـ Hushed، أرقام للاستخدام المؤقت
Google Voiceمجانيالولايات المتحدة فقط، قد لا يعمل للتحقق من WhatsApp في جميع الحالات
كيفية إعداده:
  1. احصل على رقم افتراضي من أحد التطبيقات أعلاه
  2. ثبّت WhatsApp على جهاز ثانٍ (هاتف قديم، جهاز لوحي، أو محاكي) باستخدام ذلك الرقم الافتراضي
  3. أثناء إعداد NanoClaw، امسح رمز QR بذلك الجهاز الثاني — وليس هاتفك الشخصي

​
الإعداد

يستغرق الإعداد حوالي 10 دقائق. تحتاج فقط إلى نافذة Terminal واحدة.
1

استنسخ وثبّت

افتح Terminal وشغّل:
git clone https://github.com/lorenzovenice/nanoclaw-venice.git
cd nanoclaw-venice
npm install
انتظر حتى ينتهي npm install دون أخطاء.
2

شغّل Claude Code مع Venice

استبدل your-key بمفتاح Venice API الخاص بك وشغّل:
VENICE_API_KEY=your-key npm run venice
يبدأ هذا وكيل Venice ويشغّل Claude Code من خلاله بأمر واحد.
يستخدم Claude Code افتراضيًا GLM 5 (zai-org-glm-5) للحفاظ على انخفاض تكاليف الإعداد. بعد الإعداد، اكتب /model داخل Claude Code للتبديل إلى claude-sonnet-4-6 أو claude-opus-4-6 للحصول على أفضل أداء.
إذا ظهرت رسالة “Do you want to use this API key?” — اختر Yes.
3

شغّل معالج الإعداد

في طرفية Claude Code، اكتب:
/setup
يرشدك المعالج عبر:
  1. التهيئة — يتحقق من Node.js والتبعيات
  2. مفتاح Venice API — يتحقق ويحفظ مفتاحك
  3. اختيار القناة — اختر WhatsApp أو Telegram أو كليهما
  4. بناء الحاوية — يبني حاوية Docker (يستغرق بضع دقائق في المرة الأولى)
  5. مصادقة WhatsApp — امسح رمز QR بهاتفك (إن وُجد)
  6. إعداد Telegram — أرسل رسالة إلى البوت ليكتشف محادثتك
  7. كلمة التشغيل — البادئة التي تنشّط البوت (الافتراضية: @Andy)
  8. مجلدات الربط — اختر “No” الآن (يمكنك إضافة وصول إلى الملفات لاحقًا)
  9. بدء الخدمات — يبدأ كل من NanoClaw ووكيل Venice كخدمات في الخلفية
يثبّت معالج الإعداد خدمتين في الخلفية:
  • NanoClaw — البوت نفسه
  • وكيل Venice — خادم محلي صغير (localhost:4001) يترجم بين Claude Code وVenice AI
تبدأ كلتاهما تلقائيًا عند الإقلاع وتعيد تشغيل نفسها في حال تعطّلها.
إذا توقف المعالج بين الخطوات، اكتب “continue” أو “next step” لدفعه للأمام.
4

ابدأ المحادثة

بمجرد اكتمال الإعداد، افتح محادثتك (Telegram أو WhatsApp) وأرسل:
@Andy hello, are you there?
يجب أن يردّ البوت خلال ثوانٍ. في قناتك الرئيسية، يمكنك الكتابة عاديًا دون البادئة @Andy.يمكنك الآن إغلاق نافذة Terminal. كل شيء يعمل كخدمات في الخلفية ويبدأ تلقائيًا عند تشغيل جهازك.

​
كيف يعمل

هناك طبقتان في NanoClaw:
الطبقةما الذي تقوم به
Claude Code CLIأداة إدارة للإعداد والتنقيح والتخصيص
البوتالذكاء الاصطناعي في محادثتك، يعمل داخل حاوية Docker معزولة
لفتح Claude Code في أي وقت: 
cd nanoclaw-venice
ANTHROPIC_BASE_URL=http://localhost:4001 ANTHROPIC_API_KEY=venice-proxy claude
استخدمه لتشغيل /setup أو /debug أو /customize، أو لإجراء تغييرات على سلوك البوت.

​
النماذج

السياقالنموذج الافتراضيكيفية التبديل
البوت (في المحادثة)claude-sonnet-4-6أخبر البوت: “switch to opus” أو “use zai-org-glm-5”
Claude Code CLIzai-org-glm-5 (GLM 5)استخدم /model في Claude Code أو claude --model <name>
يستخدم CLI افتراضيًا GLM 5 لإبقاء تكاليف الإعداد منخفضة. بعد الإعداد، بدّل إلى claude-sonnet-4-6 أو claude-opus-4-6 للحصول على أفضل أداء.
راجع كتالوج النماذج لجميع نماذج Venice المتاحة.

​
استكشاف الأخطاء وإصلاحها

يعمل وكيل Venice كخدمة في الخلفية ويعيد تشغيل نفسه تلقائيًا. إذا لم يكن يعمل:macOS:
# تحقّق إن كان يعمل
launchctl list | grep venice-proxy

# أعد تشغيله
launchctl kickstart -k gui/$(id -u)/com.nanoclaw.venice-proxy

# تحقّق من السجلات
tail -f ~/nanoclaw-venice/logs/venice-proxy.log
Linux:
# تحقّق إن كان يعمل
systemctl --user status nanoclaw-venice-proxy

# أعد تشغيله
systemctl --user restart nanoclaw-venice-proxy

# تحقّق من السجلات
tail -f ~/nanoclaw-venice/logs/venice-proxy.log
يعني هذا أن Claude Code لا يستطيع الاتصال بوكيل Venice.
  1. تحقّق من أن الوكيل يعمل. راجع خطوة استكشاف الأخطاء أعلاه.
  2. تأكّد من أنك في المجلد الصحيح. نفّذ دائمًا cd nanoclaw-venice أولًا.
  3. ابدأ من جديد: أغلق جميع الطرفيات وشغّل: 
    cd nanoclaw-venice
ANTHROPIC_BASE_URL=http://localhost:4001 ANTHROPIC_API_KEY=venice-proxy claude
أعد تشغيل الوكيل والبوت:macOS:
# أعد تشغيل الوكيل
launchctl kickstart -k gui/$(id -u)/com.nanoclaw.venice-proxy

# أعد تشغيل البوت
launchctl kickstart -k gui/$(id -u)/com.nanoclaw
Linux:
# أعد تشغيل الوكيل
systemctl --user restart nanoclaw-venice-proxy

# أعد تشغيل البوت
systemctl --user restart nanoclaw
تحقّق من النماذج المتاحة في كتالوج النماذج.
اتبع هذه الخطوات بالترتيب:
  1. تحقّق من كلمة التشغيل. تأكّد من استخدامك للبادئة الصحيحة (مثل @Andy hello).
  2. تحقّق من أن Docker يعمل. نفّذ docker info — إذا حدث خطأ، افتح Docker Desktop.
  3. تحقّق من أن الوكيل يعمل. راجع “الوكيل لا يعمل” أعلاه.
  4. تحقّق من السجلات: tail -f logs/nanoclaw.log في مجلد المشروع.
  5. تحقّق من سجلات الحاوية. افتح مجلد nanoclaw-venice/groups/main/logs/. افتح الملف الأحدث الذي يبدأ بـ container-.
  6. أعد تشغيل كل شيء: أعد تشغيل كل من الوكيل والبوت (راجع أعلاه).
تأكّد من أن Docker Desktop مفتوح ويعمل. انتظر 10 ثوانٍ ليبدأ Docker بالكامل، ثم اكتب continue في المعالج لإعادة المحاولة.
قد تنتهي صلاحية جلسة WhatsApp. لإعادة الاتصال:
cd nanoclaw-venice
npm run auth
امسح رمز QR باستخدام WhatsApp (الإعدادات → الأجهزة المرتبطة → ربط جهاز)، ثم أعد تشغيل البوت:
  • macOS: launchctl kickstart -k gui/$(id -u)/com.nanoclaw
  • Linux: systemctl --user restart nanoclaw

​
متقدّم

افتراضيًا، يكون البوت معزولًا تمامًا عن جهازك — لا يمكنه رؤية سوى ذاكرته الخاصة وسجل المحادثة.
  • أثناء الإعداد: عندما يُسأل عن الوصول إلى المجلدات، اختر “Yes”
  • بعد الإعداد: شغّل /customize في Claude Code
يشغّل NanoClaw خدمتين في الخلفية تبدأن تلقائيًا عند الإقلاع.macOS:
الإجراءالأمر
بدء البوتlaunchctl load ~/Library/LaunchAgents/com.nanoclaw.plist
إيقاف البوتlaunchctl unload ~/Library/LaunchAgents/com.nanoclaw.plist
إعادة تشغيل البوتlaunchctl kickstart -k gui/$(id -u)/com.nanoclaw
بدء الوكيلlaunchctl load ~/Library/LaunchAgents/com.nanoclaw.venice-proxy.plist
إيقاف الوكيلlaunchctl unload ~/Library/LaunchAgents/com.nanoclaw.venice-proxy.plist
إعادة تشغيل الوكيلlaunchctl kickstart -k gui/$(id -u)/com.nanoclaw.venice-proxy
Linux:
الإجراءالأمر
بدء البوتsystemctl --user start nanoclaw
إيقاف البوتsystemctl --user stop nanoclaw
إعادة تشغيل البوتsystemctl --user restart nanoclaw
بدء الوكيلsystemctl --user start nanoclaw-venice-proxy
إيقاف الوكيلsystemctl --user stop nanoclaw-venice-proxy
إعادة تشغيل الوكيلsystemctl --user restart nanoclaw-venice-proxy
إذا أردت فقط استخدام Claude Code مع Venice ولا تحتاج إلى WhatsApp/Telegram، يجب أن تكون خدمة الوكيل قيد التشغيل. إذا كنت قد شغّلت /setup، فهي قيد التشغيل أصلًا كخدمة في الخلفية.
cd nanoclaw-venice
ANTHROPIC_BASE_URL=http://localhost:4001 ANTHROPIC_API_KEY=venice-proxy claude
نصيحة: أضف هذا إلى ~/.zshrc (أو ~/.bashrc) لتتمكّن من تبديل أي طرفية بسرعة إلى Venice:
alias venice='export ANTHROPIC_BASE_URL=http://localhost:4001 && export ANTHROPIC_API_KEY=venice-proxy && echo "Using Venice API"'
alias anthropic='unset ANTHROPIC_BASE_URL && unset ANTHROPIC_API_KEY && echo "Using Anthropic API"'
ثم اكتب فقط venice في أي طرفية قبل تشغيل claude لاستخدام Venice، أو anthropic للعودة.
يمكنك تشغيل عدة بوتات NanoClaw على الجهاز نفسه (مثل واحد للاستخدام الشخصي وآخر لفريق). فقط استنسخ المستودع في مجلد مختلف وشغّل الإعداد مجددًا. ملاحظة: تشترك جميعها في صورة Docker نفسها، لذا إعادة بناء واحدة تؤثر على الجميع.
لمن يريد تعديل شيفرة NanoClaw:
npm run dev          # بدء الوكيل + NanoClaw مع إعادة التحميل الحارة
npm run proxy        # بدء وكيل Venice فقط
npm run build        # ترجمة TypeScript
npm test             # تشغيل الاختبارات
./container/build.sh # إعادة بناء حاوية الوكيل

​
البنية المعمارية

أنت (WhatsApp/Telegram)
        ↓
   NanoClaw (Node.js)
        ↓
   حاوية Docker (سندبوكس معزول)
        ↓
   وكيل Venice (localhost:4001)
        ↓
   api.venice.ai (استدلال خاص)
الملفالغرض
proxy/venice-proxy.tsيترجم تنسيق Anthropic إلى تنسيق OpenAI لـ Venice
src/index.tsالمنسّق الرئيسي — حلقة الرسائل واستدعاء الوكيل
src/channels/whatsapp.tsاتصال WhatsApp عبر baileys
src/channels/telegram.tsبوت Telegram عبر grammy
src/container-runner.tsيطلق حاويات وكيل معزولة

​
الأسئلة الشائعة

يتحدّث Claude Agent SDK بتنسيق رسائل Anthropic. وتتحدّث Venice بتنسيق OpenAI. يترجم الوكيل بينهما حتى يعمل كل شيء دون تعديل الـ SDK.
نعم. تستضيف Venice العديد من النماذج. أخبر البوت “switch to zai-org-glm-5” أو أي معرّف نموذج Venice. راجع كتالوج النماذج.
تعمل الوكلاء في حاويات Docker مع عزل حقيقي على مستوى نظام التشغيل. يُمرَّر مفتاح Venice API عبر stdin، ولا يُكتب أبدًا على القرص داخل الحاويات. كل مجموعة تحصل على بيئة معزولة خاصة بها.
لا. كل شيء يعمل عبر Venice AI. تحتاج فقط إلى مفتاح Venice API.
نعم. يعمل على أي جهاز Linux مع Docker. استخدم خدمة systemd للبدء التلقائي عند الإقلاع.

​
المصادر

مستودع NanoClaw Venice

الشيفرة المصدرية وملف README الكامل

NanoClaw الأصلي

المشروع الأصلي من qwibitai

كتالوج نماذج Venice

تصفّح النماذج المتاحة

خصوصية Venice

كيف تحمي Venice بياناتك