
مساعد شخصي ذكي يركز على الأمان.

Stavrobot هو مساعد ذكاء اصطناعي شخصي مبني على مبدأ "كل الصلاحيات التي يحتاجها مساعد الذكاء الاصطناعي، ولا أكثر من ذلك".
يمتلك جميع الميزات الرائعة لمساعد الذكاء الاصطناعي، لكنه يركّز على العزل والتقييد والحد الأدنى من الصلاحيات. إنه خفيف الوزن ويُنشر بأمر واحد فقط docker compose up.
uv، معزول عن بيئة المضيف.تثبيت بمساعدة الذكاء الاصطناعي: اطلب من ذكاءك الاصطناعي البرمجي (Claude Code، Cursor، Windsurf، إلخ) جلب https://stavrobot.stavros.io/INSTALL.md واتباعه — سيرشدك خلال الإعداد بأكمله تفاعليًا.
التثبيت اليدوي:
راسل @BotFather على Telegram لإنشاء بوت وانسخ الرمز (token). راسل @userinfobot للحصول على معرّف مستخدم Telegram الخاص بك (يُستخدم كمعرّف المحادثة chat ID).
انسخ env.example إلى .env وغيّر POSTGRES_PASSWORD إلى شيء آمن وTZ إلى منطقتك الزمنية.
انسخ config.example.toml إلى data/main/config.toml واملأ الحقول المطلوبة: apiKey، password، publicHostname، [owner].name، [owner].telegram (معرّف المحادثة الخاص بك)، و[telegram].botToken. كل ما عدا ذلك في الملف اختياري.
docker compose up --build
هذا كل شيء. راسل بوتك على Telegram وسيستجيب. راجع أقسام الإعداد التفصيلية أدناه لـ Signal وWhatsApp والبريد الإلكتروني والخيارات الأخرى.
config.example.toml إلى data/main/config.toml.authFile (أو apiKey) وpublicHostname. كل ما عدا ذلك اختياري.env.example إلى .env وعيّن منطقتك الزمنية (TZ). يمكن أيضًا تجاوز بيانات اعتماد Postgres وإعدادات البيئة الأخرى هناك. عيّن دائمًا POSTGRES_PASSWORD إلى شيء آمن — القيمة الافتراضية عنصر نائب ضعيف ولا ينبغي استخدامها في بيئة الإنتاج.بعد بدء التطبيق، افتح /settings/config لتحرير config.toml في المتصفح. الصفحة
محمية بـ HTTP Basic Auth وتعرض الإعدادات الخام، بما في ذلك أي أسرار
تحتويها. يؤدي الحفظ الصالح إلى إنشاء نسخة احتياطية واحدة <CONFIG_PATH>.bak، وحفظ
المحتوى الجديد، وإعادة تشغيل التطبيق؛ وهذا يقطع أي دورة وكيل قيد التنفيذ.
يقرأ plugin-runner وcoder وsignal-bridge وpython-runner ملف config.toml فقط
عند بدء تشغيلها. التغييرات التي تؤثر عليها، مثل كلمة المرور، تتطلب إعادة تشغيل
هذه الحاويات يدويًا.
يمكن توجيه Stavrobot إلى أي نقطة نهاية متوافقة مع OpenAI (Ollama، LiteLLM، vLLM، إلخ) أو إلى وكيل مخصص متوافق مع Anthropic عن طريق تعيين baseUrl في config.toml. راجع config.example.toml للحقول المطلوبة وتكوينات الأمثلة. عيّن reasoning = true فقط للنماذج التي تدعم التفكير، لأنه ما يجعل thinkingLevel ساريًا على نقطة نهاية مخصصة.
يدعم التطبيق وضعي مصادقة: مفتاح API أو OAuth.
apiKey في config.toml. لا حاجة لتسجيل الدخول أو الخروج.authFile في config.toml (مسار تُخزَّن فيه بيانات الاعتماد). تعمل صفحة تسجيل الدخول مع أي مزوّد OAuth يدعمه Pi.
<your-hostname>/login في متصفح. اتبع الإرشادات في الصفحة، وتُحفظ بيانات الاعتماد في ملف المصادقة. يختار Stavrobot طريقة تسجيل الدخول بدون واجهة الخاصة بالمزوّد، لذا لن تُعاد توجيهك أبدًا إلى استدعاء localhost غير قابل للوصول. مع Anthropic، بعد اختيار Authorize، يعرض Anthropic رمزًا تنسخه وتلصقه في صفحة تسجيل الدخول الخاصة بـ Stavrobot. أما المزوّدون الذين يستخدمون تدفق رمز الجهاز فيعرضون الرمز على صفحة Stavrobot بدلًا من ذلك، وتكتبه أنت على موقع المزوّد. إذا انتهت صلاحية المصادقة أثناء تشغيل البوت، فإنه يرسل إليك رسالة تحتوي على رابط تسجيل الدخول عبر منصة المراسلة الخاصة بك.authFile. سيكتشف البوت غياب بيانات الاعتماد عند الرسالة التالية ويطلب منك تسجيل الدخول مرة أخرى.حاوية coder اختيارية (مطلوبة فقط لميزة البرمجة الذاتية). تستخدم افتراضيًا Claude Code مع مصادقة الاشتراك (OAuth)، منفصلة عن مفتاح API الخاص بالتطبيق الرئيسي. لاستخدام نقطة نهاية API متوافقة مع Anthropic بدلًا من ذلك، عيّن كلاً من [coder].apiKey و[coder].baseUrl في config.toml؛ حينها يستخدمهما Claude Code كـ ANTHROPIC_API_KEY وANTHROPIC_BASE_URL. أما apiKey/baseUrl على المستوى الأعلى فتُكوِّن فقط نموذج التطبيق الرئيسي ولا تؤثر أبدًا على coder. تعيين واحد فقط من مفتاحي [coder] يُعد خطأً عند بدء التشغيل.
ملفات تعريف Docker Compose مفصولة بفواصل، لذا يمكنك دمجها (مثل COMPOSE_PROFILES=signal,coder).
COMPOSE_PROFILES في ملف .env لديك ليشمل coder (مثل COMPOSE_PROFILES=coder، أو COMPOSE_PROFILES=signal,coder إذا كنت تستخدم Signal أيضًا).docker compose --profile coder up --build[coder].apiKey/[coder].baseUrl): docker compose exec -u coder coder claude (سيطلب منك تسجيل الدخول إذا لم تكن قد فعلت ذلك).[coder].model في تكوينك إلى اسم مستعار لنموذج Claude Code (sonnet أو opus أو haiku).يتطلب Signal رقم هاتف منفصلًا — وليس رقمك الشخصي. يعمل شريحة SIM مسبقة الدفع أو رقم VoIP.