كيف تستضيف زملاء العمل OpenBot AI ذاتياً على VPS
تعرف على كيفية تشغيل OpenBot مع مشرف لتخصيص حاوية ومتصفح لكل روبوت. اكتشف آلية عمل البوابة في تنفيذ الأوامر، وتعرف على متطلبات الذاكرة العشوائية RAM لكل حاوية.
ما تحصل عليه عند الاستضافة الذاتية لزملاء OpenBot المعتمدين على الذكاء الاصطناعي
تستضيف زملاء OpenBot المعتمدين على الذكاء الاصطناعي ذاتياً عبر تشغيل خادم بوابة واحد على عتاد تتحكم فيه، إلى جانب مشرف يمنح كل bot حاوية خاصة به. لا توجد حاوية كل bot إلا عند ضبط COMPUTER_SUPERVISOR_URL. من دونها، تشترك جميع bots في الكمبيوتر الواحد الموجود في AGENT_COMPUTER_URL. عند تشغيل المشرف، تحتوي حاوية كل bot على متصفح Chromium الخاص بها، ووحدة تخزين workspace الخاصة بها، وملف تعريف متصفح يستمر بين الجلسات. تمر كل عملية ينفذها bot على كمبيوتر أو ملف أو خادم MCP (بروتوكول سياق النموذج) أو مكوّن UI عبر تلك البوابة. تتحقق البوابة من العملية وفق سياسة قبل تنفيذها، وتسجلها بعد ذلك. إذا كانت حلقة agent التي تغلفها البوابة ما تزال غير مألوفة لك، فإن المسار التدريجي في تعلّم agents المعتمدين على الذكاء الاصطناعي من الصفر يجعلك تكتب واحدة صغيرة بنفسك قبل أن تمنح bot متصفحاً وبيانات تسجيل الدخول الخاصة بك.
تنشر CopilotKit مشروع OpenBot بموجب ترخيص MIT في github.com/CopilotKit/openbot. نُشر أول إصدار موسوم، v0.0.1، في 17 August 2026. وحتى 3 November 2026، كان أحدث إصدار هو v0.2.0، وقد نُشر في 12 October 2026. يصف README الحالي المشروع بأنه إصدار تجريبي وما يزال قيد التطوير النشط. تعامل معه على أنه تصميم جاد، لكنه ما يزال يتضمن جوانب مبكرة. يثبّت النشر أدناه الإصدار v0.2.0؛ ويمنح الإصدار الحالي main كل شخص حاوية، كما يمنح bot المعلَّم Isolated حاوية خاصة به.
الجزء المثير للاهتمام في هذه البنية هو أيضاً الجزء الأعلى تكلفة. فوجود متصفح لكل agent يمثل تكلفة الذاكرة التي ينسى معظم الأشخاص التخطيط لها، لذلك يسبق تحديد الحجم عملية التثبيت هنا.
كيف يقرر الـgateway كل إجراء
يُعد خادم API على المنفذ 3001 المسار الخاضع للحوكمة إلى حاسوب البوت. يوفّر الحاسوب أيضاً نقاط نهاية لخدمات منخفضة المستوى محمية بالرموز. ينص المشروع على إبقائها خاصة وعدم استخدامها لتجاوز الـgateway، لذلك يبقى الـgateway المسار الوحيد فقط عندما يتعذر الوصول إلى تلك النقاط. قبل تنفيذ إجراء في المتصفح، يحدد الـgateway الهدف من لقطة الصفحة، ويقيّم قواعد سياسة CEL (لغة التعبيرات الشائعة) مقابل السياق، ويكتب صف تدقيق يتضمن القرار، ثم يستدعي الحاوية. إذا فشل التنفيذ بعد ذلك، يكتب صفاً ثانياً. توضّح الوثائق الحد الفاصل بعبارة صريحة: لا يقرر الحاسوب السياسة، بل إن بوابة الخادم هي حد الإجراء. لهذا الفصل اسم خارج OpenBot، لأن الحلقة وتعريفات الأدوات وفحوص الأذونات وحالة الجلسة تشكّل معاً الـharness المحيط بالنموذج، وهذه البوابة هي نصف الأذونات منه.
يفشل تقييم السياسة بطريقة تمنع التنفيذ، وتُقيَّم قواعد الرفض قبل قواعد السماح. واتجاه الفشل أهم من صياغة القاعدة. لا تسمح سياسة مفقودة أو فارغة بأي شيء، وتؤدي القاعدة المعطوبة إلى الحظر سواء كانت قاعدة رفض أو قاعدة سماح. لذلك، يسبب الخطأ في سياستك توقف البوت بدلاً من إطلاقه دون قيود على حساباتك. أما السياسة التي يأتي بها OpenBot فهي أمر مختلف. الإعداد الافتراضي عند بدء التشغيل هو deny: [] مع allow: ["true"]، ما يسمح بكل إجراء إلى أن يحدث AGENT_COMPUTER_POLICY أو تستبدله سياسة محفوظة من المسؤول. لذلك اكتب سياستك الخاصة قبل أن يلمس البوت أي شيء حقيقي. تتحكم هذه الطبقة فيما يفعله البوت، لا فيما يقرأه. لذلك تبقى الصفحة التي تحتوي على تعليمات موجّهة إلى الوكيل مشكلة منفصلة، وهي سطح حقن التعليمات نفسه الذي تواجهه عندما تسلّم الوكيل نتائج من مثيل SearXNG الخاص بك.
يوجد سجل التدقيق في PostgreSQL، لذلك يبقى بعد إعادة التشغيل. تُسجَّل عمليات تسليم التحكم بصفتها computer.help_requested وcomputer.control_taken وcomputer.control_released. بهذه الطريقة ترى أن البوت طلب تدخّل إنسان، وترى أن الإنسان أعاد التحكم. تُسجَّل الأسرار على شكل عدد الأحرف، وليس قيمها مطلقاً. تظهر عمليات قراءة الملفات وكتابتها وسردها في علامة التبويب Activity، حيث يظهر الملف المحفوظ على شكل مساره وحجمه، ولا تظهر محتوياته مطلقاً. يحتفظ المتصفح بهذا العرض، وهو ليس سجل التدقيق. إذا أردت حد التحكم نفسه من دون متصفح خلفه، فتتناول وضع إجراءات وكيل الذكاء الاصطناعي خلف الموافقات هذه الحالة الأضيق.
ما تكلفة بوت واحد من حيث الذاكرة ومساحة القرص
ينشر المشروع أرقاماً مقاسة لبوت واحد على arm64. هذه هي أرقام تحديد الحجم التي تعرضها وثائق النشر، وهي تصف بوتاً واحداً على بنية واحدة. لذلك استخدمها كنقطة بداية، لا كخطة سعة.
البيانات وراء هذا الرسم البياني
[
{
"label": "Measured, one Bot",
"memory_gb": 0.55,
"disk_gb": 1.4,
"vcpu": 0.06
},
{
"label": "Documented minimum",
"memory_gb": 2,
"disk_gb": 4,
"vcpu": 1
},
{
"label": "Documented recommended",
"memory_gb": 4,
"disk_gb": 8,
"vcpu": 2
}
]بلغت الذاكرة القصوى المقاسة 0.55 GB لبوت واحد، بينما الحد الأدنى الموثق هو 2 GB والتوصية هي 4 GB. ويمثل الفرق بين القياس والحد الأدنى مساحة لنمو استهلاك Chromium تحت الحمل، لأن استهلاك المتصفح للذاكرة يتتبع الصفحات المفتوحة فيه، لا العملية في حالة الخمول. تذكر الوثائق أن كل صفحة إضافية مفتوحة في الوقت نفسه تستهلك نحو 100 إلى 200 MB. يقترب استهلاك CPU في حالة الخمول من الصفر، إذ يبلغ 0.06 من نواة واحدة عند الحد الأعلى للنطاق المقاس. لذلك لا تشتري سعة CPU. تبلغ مساحة الصورة 1.4 GB، مقابل volume موصى به بسعة 8 GB. والفرق يوفر مساحة لـ /workspace، حيث يحتفظ البوت بملفاته. لا تتضمن الصورة سوى متصفحات عائلة Chromium. أما Firefox وWebKit في Playwright فغير مضمنين فيها.
لا تخبرك أي من هذه الأرقام بتكلفة تشغيل عدة بوتات معاً، ولا ينشر المشروع رقماً لذلك. الحد الأدنى الموثق هو الرقم الذي يختار المشروع نشره بثقة، وليس رقماً راقبه أحد تحت الحمل. ولهذا أيضاً يعتمد الاختيار بين PhotoPrism وImmich على الحد الأدنى المقاس لاستهلاك RAM لكل منهما، لا على الأرقام المنشورة. قِس بيئتك بنفسك. شغّل بوتاً واحداً، وأسند إليه مهمة فعلية مع فتح صفحة، وراقب الحاوية أثناء عمله.
docker stats --no-stream
free -mاستخدم قيمة العمود MEM USAGE الخاصة بحاوية البوت باعتبارها قيمة كل بوت، ثم أضف إليها gateway وPostgreSQL، وبعد ذلك اضرب قيمة كل بوت في عدد البوتات التي تتوقع تشغيلها في الوقت نفسه. يحتفظ البوت الخامل بمتصفحه حتى يغلقه مهلة الخمول، ومدتها الافتراضية 30 دقيقة. لذلك أدرج المتصفحات الخاملة في معامل الضرب. الحساب هو نفسه المستخدم في تحديد حجم RAM وCPU لـ coding agent VPS، بينما يغطي تشغيل متصفح headless للوكلاء على VPS جانب المتصفح من الحساب.
هناك تفصيل في Chromium يؤثر في الخطط الصغيرة. يشغّل OpenBot Chromium باستخدام --disable-dev-shm-usage، لذلك يكتب المتصفح إلى /tmp بدلاً من /dev/shm. يمنع ذلك التعطل الذي يحدث على المضيفين ذوي /dev/shm الصغيرة، لكنه ينقل الضغط إلى نظام الملفات الجذر، وهذا سبب إضافي لجعل مساحة القرص الموصى بها أكبر من مساحة الصورة.
كيف تستضيف OpenBot ذاتياً على VPS؟
تحتاج إلى Docker وBun 1.3 أو إصدار أحدث، ومشروع CopilotKit Intelligence وترخيصه، وإمكانية الوصول إلى نموذج، إما عبر API key أو عبر تسجيل الدخول إلى موفّر مدعوم بدلاً منها. يطلب ملف v0.2.0 README استخدام Bun 1.3+ للتطبيق وخادم API، بينما يرفع الإصدار الحالي main المتطلب إلى 1.4+، لذلك اقرأ README الخاص بالوسم الذي تستنسخه. أصبح تسجيل الدخول إلى حساب الموفّر بديلاً عن API key منذ v0.0.15. وتتوقع وثائق التطوير أيضاً وجود lsof وopenssl وcurl على الخادم، إضافة إلى npx من Node لتجهيز Intelligence. استنسخ إصداراً موسوماً بدلاً من main، لأن main في مشروع تجريبي يتغير دون تحذير. إذا كان لديك تثبيت v0.1.x قيد التشغيل، فاقرأ ملاحظات إصدار v0.2.0 قبل الترقية إليه: تنسخ الترقية اتصالات Composio المخزنة إلى جدول جديد، ويؤدي الرجوع إلى v0.1.2 بعدها إلى إخفاء أي حساب تم ربطه بعد الترقية.
git clone --branch v0.2.0 https://github.com/CopilotKit/openbot.git
cd openbot
cp .env.example .env
bun installجهّز مشروع Intelligence. يسجّلك الأمران الأولان إلى الحساب ويحددان المشروع. ثم يجهّز البرنامج النصي المساعد مفتاح التشغيل الخاص بذلك المشروع، وينشئ حاوية openbot Learning أو يعيد استخدامها، ويكتب الإعدادين في ملف البيئة.
npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
bun scripts/setup-learning.tsأنشئ المفتاح الذي يشفّر بيانات الاعتماد المخزنة، ثم ضع الناتج في .env بالقيمة KEY_ENCRYPTION_KEY. أضف OPENAI_API_KEY إلى الملف نفسه. يستخدم Bot لإثبات المفهوم OpenAI. أما LangGraph Bot، فيمكنك ضبط BOT_PROVIDER على anthropic أو google وإضافة المفتاح المطابق. لاستخدام تسجيل الدخول إلى النموذج بدلاً من المفتاح، يقبل v0.2.0 .env.example القيمة CLAUDE_CODE_OAUTH_TOKEN، وهي الرمز المميّز من claude setup-token، وCHATGPT_AUTH_FILE، وهو الملف الذي يكتبه حساب ChatGPT المسجّل الدخول. يقرأها خادم API للوكلاء المضمّنين فيه، ويمررها compose إلى بيئة Bot التي اخترتها.
openssl rand -base64 32أثناء فتح .env، راجع إعدادات الكمبيوتر. يترك .env.example كلاً من COMPUTER_SUPERVISOR_URL وSUPERVISOR_TOKEN فارغين، ويضبط AGENT_COMPUTER_URL على الكمبيوتر المشترك الوحيد عبر المنفذ 4100. يتضمن ملف compose المشرف، ويمكّن scripts/start.sh أجهزة الكمبيوتر الخاصة بكل Bot افتراضياً عبر تمرير COMPUTER_SUPERVISOR_URL وSUPERVISOR_TOKEN إلى الخادم. إذا شغّلت الخادم بنفسك، فاضبط القيمتين. من دون عنوان URL للمشرف، تستخدم كل Bots ذلك المتصفح الواحد وبيانات تسجيل الدخول الخاصة به.
ثم ابدأ التشغيل.
bash scripts/start.shيشغّل scripts/start.sh خدمات Docker، وينفّذ عمليات ترحيل قاعدة البيانات، ويبدأ الخادم والعامل الدوري والتطبيق، ثم يتحقق من حالتها. عند اكتماله، يستجيب التطبيق على المنفذ 3010 وتستجيب API على المنفذ 3001. يبلّغ البرنامج النصي عن تعارضات المنافذ ويترك الخدمة المطابقة التي تعمل مسبقاً دون تغيير، لذلك من الآمن تشغيله مرتين.
اختبره من الخادم نفسه قبل تعريضه لأي جهة خارجية.
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3010
ss -ltnp | grep -E ':(3010|3001|4100|4500|5432)'تعني نتيجة 200 من الأمر الأول أن التطبيق يستجيب. يعرض الأمر الثاني العناوين التي ترتبط بها تلك المنافذ، وهذه هي المعلومة المهمة على VPS. يكون السطر الذي يقرأ 127.0.0.1:3001 متاحاً داخل الخادم فقط. أما السطر الذي يقرأ 0.0.0.0:3001 فيعني أن أي جهة تستطيع توجيه حركة الشبكة إلى الخادم يمكنها الوصول إليه.
صورة الحاوية الواحدة
تتضمن وثائق النشر أيضاً صورة واحدة تحتوي على التطبيق وواجهة برمجة التطبيقات (API) ومتصفح Chromium، وتعمل على المنفذ 3001. يتم نشرها كـ ghcr.io/copilotkit/openbot مع وسوم الإصدار، أو يمكنك بناؤها من نسختك المستنسخة.
docker build -t openbot .
docker run -p 127.0.0.1:3001:3001 --env-file .env \
-e EMBEDDED_POSTGRES=on -v openbot-data:/var/lib/postgresql openbotتقوم EMBEDDED_POSTGRES=on بتشغيل PostgreSQL داخل الحاوية وتطبق عمليات الترحيل (migrations) عند بدء التشغيل. يحافظ المجلد المسمى (named volume) على سجل التدقيق عبر عمليات إعادة النشر، وبدونه تؤدي كل عملية إعادة بناء إلى فقدان ذلك السجل. قم بعمل mount للمجلد في الدليل الرئيسي، /var/lib/postgresql، وليس في دليل البيانات نفسه. تحذر الوثائق من أن عمل mount لدليل البيانات قد يترك العنقود (cluster) غير مهيأ، مما يجعل التطبيق يستجيب بالخطأ 502. إذا وجهت DATABASE_URL إلى قاعدة بيانات مدارة بدلاً من ذلك، فيجب تفعيل إضافة vector عليها. تدعم الخدمات المدارة مثل RDS وCloud SQL وAzure Database هذه الإضافة، لكن أياً منها لا يفعلها تلقائياً نيابة عنك. تتوقع عمليات الترحيل أيضاً أن يكون الدور الذي يشغلها هو مالك الإضافة، لذا إذا أُنشئت الإضافة تحت دور مختلف، فإنها تتوقف مع الخطأ must be owner of extension vector.
قم بتشغيل عمليات الترحيل كخطوة إصدار عندما تكون قاعدة البيانات خارجية.
docker run --rm --env-file .env --entrypoint sh openbot \
-c "cd /app/server && bun scripts/migrate.ts"استخدم scripts/migrate.ts وليس drizzle-kit migrate، لأن واجهة سطر أوامر drizzle-kit هي اعتمادية تطوير غير موجودة في صورة الإنتاج. احتفظ بـ --entrypoint sh، لأنه بدونها تبدأ واجهة برمجة التطبيقات قبل تشغيل عمليات الترحيل.
تترك تلك الصورة منفذ المتصفح غير منشور عمداً. كما أنها تستبعد المشرف (supervisor)، لأن المشرف يحتاج إلى مقبس Docker، وهو ما لا توفره منصات الحوسبة بدون خادم (serverless). بدون المشرف، يتشارك كل بوت في متصفح واحد وبالتالي في مجموعة واحدة من بيانات تسجيل الدخول، مما يلغي العزل الذي جعل تشغيل حاويات لكل بوت أمراً يستحق العناء. مسار الحاوية الواحدة هذا هو المسار الذي لا يمنح البوت حاوية خاصة به أبداً. إذا كان الحصول على بيانات تسجيل دخول منفصلة لكل بوت هو سبب وجودك هنا، فقم بتشغيل حزمة compose مع ضبط COMPUTER_SUPERVISOR_URL وSUPERVISOR_TOKEN، على مضيف تقبل فيه هذه المقايضة. العملية التي يمكنها التحدث إلى مقبس Docker يمكنها بدء حاوية ذات صلاحيات، لذا فهي عملياً بصلاحيات root على المضيف. هذا سبب وجيه للاحتفاظ بـ OpenBot على جهاز خاص به، بنفس روح منح وكلاء البرمجة جهازاً افتراضياً مؤقتاً.
لماذا يُعد OPENBOT_SINGLE_USER إعداداً مناسباً للحاسوب المحمول
يأتي .env.example مضبوطاً على OPENBOT_SINGLE_USER=true. يقبل هذا الإعداد كل طلب باعتباره قادماً من administrator ثابت واحد، ويتجاوز تسجيل الدخول بالكامل. يكون ذلك مريحاً على الحاسوب المحمول، لأن العميل الوحيد القادر على الوصول إلى المنفذ هو أنت. أما على VPS، فهذا يعني أن أي شخص يصل إلى المنفذ 3010 يصبح ذلك administrator، على نظام يخزن بيانات اعتماد مشفرة ويشغّل متصفحاً سجّل الدخول مسبقاً إلى حساباتك.
يعالج الخادم الآن جزءاً من هذه المشكلة. إذا كان OPENBOT_SINGLE_USER=true مضبوطاً وكان إدخال OPENBOT_PUBLIC_URL أو OPENBOT_APP_URL أو TRUSTED_ORIGINS موجهاً للعامة، يرفض الخادم بدء التشغيل ويذكر العنوان. أما العنوان الخاص فيبدأ التشغيل مع إصدار تحذير. يقرأ هذا الفحص عناوين URL في إعداداتك، وليس الواجهات التي ينشر عليها Docker المنافذ، لذلك تمر قيم localhost الافتراضية حتى عندما يكون منفذ ما مفتوحاً على الإنترنت. تظل مهمة الربط على عاتقك.
هناك طريقتان واضحتان لتشغيله. أبقِ OPENBOT_SINGLE_USER=true، واربط كل منفذ بـ127.0.0.1، ولا تصل إلى التطبيق إلا عبر نفق SSH أو واجهة شبكة خاصة.
ssh -N -L 3010:127.0.0.1:3010 -L 3001:127.0.0.1:3001 you@your-vpsيصبح التطبيق متاحاً عند http://localhost:3010 في متصفحك الخاص، ويُعد ذلك secure context، لذلك يحتفظ المتصفح بملفات تعريف الارتباط لتسجيل الدخول Secure. أما الشاشة المباشرة نفسها فلا تحتاج إلى secure context؛ إذ توضح وثائق النشر أن التطبيق لا يعتمد على أي من Browser APIs التي يحجبها http:// العادي. والطريقة الأخرى هي إيقاف وضع المستخدم الواحد وإعداد identity provider حقيقي. يدعم التطبيق Google وMicrosoft Entra وOkta وSAML وOIDC. تُضبط Google وEntra وOkta في البيئة، بينما تُسجّل موفّرات SAML وOIDC ضمن Admin ثم Identity providers بعد تشغيل النشر. يحتاج أي موفّر أيضاً إلى BETTER_AUTH_SECRET بطول 32 حرفاً أو أكثر، وإلى ضبط BETTER_AUTH_URL على عنوان API الأساسي العام لاستدعاءات OAuth، وإلى INITIAL_ADMIN_EMAILS. لا يوجد TRUSTED_ORIGINS ضمن القائمة المطلوبة، لكنه يحتوي على origins التطبيق التي تقبلها API، إضافة إلى كل host في مستند discovery لموفّر OIDC مسجّل. ويأخذ OPENBOT_APP_URL قيمته الافتراضية من الإدخال الأول فيه، لذلك اضبطه على public app origin. يجب أن تكون بيانات اعتماد الموفّر مكتملة، لأن الموفّر المعدّ جزئياً يوقف بدء التشغيل بدلاً من الرجوع إلى الوصول المفتوح. إذا كان سبب إضافة الحسابات هو أن كل شخص في الفريق يريد agent خاصاً به بدلاً من متصفح خاص به، فإن OneCLI مبني على هذا النموذج منذ البداية، مع agent معزول في sandbox لكل شخص، ومفاتيح النماذج محفوظة في بوابة واحدة.
إذا كان التطبيق متاحاً عبر اسم عام، فضع TLS (transport layer security) أمامه. لا تُعد الصفحة المقدمة عبر http:// العادي على أي عنوان غير localhost secure context، لذلك لا تُخزّن ملفات تعريف الارتباط التي تحمل الوسم Secure، ويفشل تسجيل الدخول بطريقة تبدو كأنها خلل في OpenBot.
تأمين المنافذ ذات المستوى الأدنى
تنص ملاحظة OpenBot الأمنية على أن نقاط نهاية الخدمات ذات المستوى الأدنى محمية بواسطة tokens، وأن عليك إبقاءها خاصة، وألا تستخدمها لتجاوز البوابة. تُعدّ tokens وسيلة الحماية الثانية. أما الحماية الأولى فهي ألا يكون الوصول إلى المنفذ ممكناً إطلاقاً.
يستمع agent-computer على المنفذ 4100 ويتطلب COMPUTER_TOKEN. وتستمع نقاط نهاية bot على المنفذين 4200 و4201، بينما يستمع agent harness على المنفذ 4202. ويستمع supervisor على المنفذ 4500 في المضيف، وعلى المنفذ 4300 داخل حاويته، ويربطه ملف compose بـ 127.0.0.1:4500. ويستمع PostgreSQL على المنفذ 5432. لا ينبغي أن تكون أي من هذه الخدمات على واجهة عامة، وفي عملية نشر لمستخدم واحد لا ينبغي أن يكون app وAPI على واجهة عامة أيضاً.
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw enable
sudo ufw status verboseيوجد هنا فخّ يوقع الأشخاص الذين يفترضون أن جدار الحماية كافٍ. يؤدي نشر منفذ حاوية باستخدام -p 3001:3001 إلى جعل Docker يثبّت قاعدة DNAT، ولذلك تُعالَج حركة الشبكة في مسار FORWARD ولا تمر مطلقاً عبر سلسلة INPUT التي يفرض عليها الرفض الافتراضي في ufw قيوده. يظل المنفذ مفتوحاً بينما لا يزال ufw status يعرض Status: active. اربط المنفذ المنشور بواجهة loopback ضمن عملية الربط نفسها، مثل -p 127.0.0.1:3001:3001، أو حدّد عنوان المضيف في ملف compose. تحقّق باستخدام ss -ltnp، وليس باستخدام ufw status. لا يقتصر هذا الفخ على OpenBot، لذلك نفّذ الفحص نفسه على كل حاوية أخرى نشرتها على هذا الخادم، بما في ذلك أي خدمة تعرض مكتبة Jellyfin أُعيد بناؤها كمتجر فيديو من حقبة التسعينيات.
يمكن لـOpenBot العمل دون اتصال بالإنترنت باستخدام Intelligence مستضاف ذاتياً
اذكر ذلك قبل التخطيط للنشر. يعتمد OpenBot على مشروع Intelligence من CopilotKit، الذي يحتفظ بسلاسل المحادثات الدائمة وذاكرة المحادثة على الخدمة المستضافة أو على بنيتك التحتية الخاصة. يتحقق خادم v0.2.0 المثبت من INTELLIGENCE_API_URL وINTELLIGENCE_GATEWAY_WS_URL وINTELLIGENCE_API_KEY عند بدء التشغيل. ويتحقق منها معاً، ويرفض البدء إذا كان أي منها مفقوداً. COPILOTKIT_LICENSE_TOKEN اختياري، ولا يستخدمه إلا Intelligence مستضاف ذاتياً مع ترخيصه الخاص. اعتباراً من 3 November 2026، يتضمن Intelligence المستضاف المجاني 1,000 تفاعل لكل مؤسسة شهرياً، لكن منذ v0.1.0 يعرض OpenBot شريطاً يطلب الاستضافة الذاتية ما لم يكن للنشر خطة Intelligence مدفوعة أو يضبط OPENBOT_SELF_HOST_BANNER=false. ويمكن استضافة Intelligence ذاتياً أيضاً، لذلك يصبح النشر المحلي بالكامل ممكناً، لكنه يتطلب عملاً أكثر مما يوضحه دليل البدء السريع. يتطلب النشر الإنتاجي دون اتصال خطة Annual؛ أما خيار self-hosted pay as you go فيجب أن يتصل للإبلاغ عن الاستخدام لأغراض الفوترة. يدعم Developer Edition المجاني التقييم المحلي غير الإنتاجي بترخيص قابل للتجديد مدته 30 يوماً؛ ويتطلب التثبيت والتجديد اتصالاً بالإنترنت. تكتب أداة Intelligence CLI المحلية مفتاحها في CPK_INTELLIGENCE_API_KEY، بينما لا يقرأ الإصدار المثبت v0.2.0 إلا INTELLIGENCE_API_KEY، لذلك انسخ القيمة إلى الموضع المقابل لهذا الإصدار. يقبل main الحالي مفتاح CLI مباشرة ويمنحه الأولوية.
النموذج هو التبعية الثانية. لا يتضمن المنتج نموذجاً جاهزاً. يقبل BOT_PROVIDER openai أو anthropic أو google لـLangGraph Bot، ويوجّه OPENAI_BASE_URL مسار OpenAI إلى أي endpoint متوافق. وهذا يناسب تشغيل Ollama على VPS لاستضافة LLM ذاتياً إذا أردت إبقاء الرموز المميزة على أجهزتك الخاصة. يتطلب التحكم في المتصفح كثيراً من النموذج، لذلك اختبر نموذجاً محلياً في مهمة حقيقية قبل اعتماده.
توسيع النطاق إلى أكثر من نسخة
تحل البوابة مراجع العناصر مقابل لقطة للصفحة. توجد هذه اللقطة الآن في PostgreSQL، لذلك يمكن لنسخة ثانية تنفيذ إجراء على لقطة أنشأتها النسخة الأولى. يشغّل مخطط Helm الرسمي نسختين من API افتراضياً، ويحفظ في PostgreSQL كل ما تحتاج النسخة إلى الاحتفاظ به. كما يعطّل المتصفح المضمّن ويرفض تثبيت متصفح مضمّن عند استخدام أكثر من نسخة واحدة. سيحتفظ المتصفح داخل حاوية API ببيانات تسجيل دخول روبوت واحد، وسيؤدي توسيع نطاق API إلى مضاعفة بيانات تسجيل الدخول هذه. يجب الانتباه إلى حالة الصورة الواحدة، لأن كل نسخة تحمل متصفحها الخاص، ولذلك تبقى بيانات تسجيل دخول الروبوت على المثيل الذي خدم طلباته. على VPS واحد، يظل متصفح كل روبوت يعمل على المضيف نفسه، لذلك توسّع النظام بزيادة موارد الجهاز. ويظل العزل بين الروبوتات ناتجاً عن الحاويات الخاصة بكل روبوت، بالطريقة نفسها التي تمنع بها بيئات تشغيل الوكلاء المستضافة ذاتياً أخطاء وكيل واحد من التأثير في الوكلاء الآخرين.
أنماط الفشل وما ستراه
يتوقف الإقلاع فوراً بعد ملء .env. يتحقق الخادم من الإعدادات قبل تقديم أي خدمة. كل من هذه الأخطاء يوقف الإقلاع بدلاً من العمل بشكل ناقص: كتلة Intelligence غير مكتملة، أو فقدان KEY_ENCRYPTION_KEY، أو مزود OAuth بمعرف عميل دون كلمة سر، أو وضع المستخدم الواحد مع رابط عام. اقرأ الخطأ الأول، صحح ذلك الحقل، ثم ابدأ مجدداً.
تفشل عمليات الترحيل (Migrations) على قاعدة بيانات مدارة. هناك سببان محتملان. قد لا تكون إضافة vector مفعّلة ولا يملك دور الترحيل صلاحية إنشائها، مما يؤدي لفشل الترحيل عند الوصول لنوع عمود لا يعرفه PostgreSQL. أو أن الإضافة أُنشئت تحت دور آخر، فيتوقف الترحيل مع ظهور must be owner of extension vector. أنشئ الإضافة باستخدام الدور الذي ينفذ عمليات الترحيل، ثم أعد تشغيل خطوة الترحيل.
يُحمّل التطبيق لكن تسجيل الدخول لا يستمر. أنت تقدم الخدمة عبر http:// عادي على عنوان عام، وهو ليس سياقاً آمناً، لذا يتم تجاهل ملف تعريف الارتباط Secure. ضع طبقة TLS في المقدمة، أو استخدم نفق SSH ليرى المتصفح localhost.
تتشارك الروبوتات عمليات تسجيل دخول كنت تتوقع فصلها. المشرف (supervisor) غير مستخدم، لذا لا يوجد حاسوب لكل روبوت ويستخدم كل روبوت المتصفح المشترك في AGENT_COMPUTER_URL. تأكد من ضبط COMPUTER_SUPERVISOR_URL وأن المشرف يمكنه الوصول إلى مقبس Docker.
يتوقف الروبوت ويطلب المساعدة. هذا هو التصميم في حالته الطبيعية. يسجل مسار التدقيق computer.help_requested، وتتولى أنت التحكم عبر الشاشة الحية، ويتم تسجيل عملية التسليم من كلا الجانبين.
FAQ
هل من الآمن إبقاء OPENBOT_SINGLE_USER مفعّلاً عند نشره على VPS؟
فقط عندما يتعذر الوصول إلى البوابة من الإنترنت. يتيح OPENBOT_SINGLE_USER=true كل طلب بصلاحيات مدير ثابت واحد من دون تسجيل دخول، لذلك فإن أي شخص يستطيع فتح المنفذ يسيطر على النشر وبيانات الاعتماد المخزنة والمتصفح الذي سجّل الدخول. في هذا الوضع، يرفض الخادم بدء التشغيل عندما يكون عنوان URL عاماً مهيأً أو أصل موثوق موجهاً علناً، لكن هذا الفحص لا يستطيع معرفة كيفية نشر المنافذ لديك. يكون ذلك مقبولاً عندما يكون كل منفذ مرتبطاً بـ127.0.0.1 وتصل إلى التطبيق عبر نفق SSH أو واجهة شبكة خاصة. أما على واجهة عامة، فعطّله واضبط Google أو Microsoft Entra أو Okta أو OIDC مع BETTER_AUTH_SECRET وBETTER_AUTH_URL وINITIAL_ADMIN_EMAILS، واضبط TRUSTED_ORIGINS على أصل تطبيقك العام.
ما مقدار RAM الذي يحتاج إليه روبوت OpenBot واحد؟
تضع الأرقام المنشورة للمشروع، الخاصة بروبوت واحد على arm64، ذروة الذاكرة عند 0.55 GB، مع حد أدنى موثق يبلغ 2 GB، وحجم موصى به يبلغ 4 GB. لا يوجد رقم منشور لتشغيل عدة روبوتات في الوقت نفسه، لأن كل روبوت يحتفظ بعملية Chromium مستقلة. شغّل روبوتاً واحداً على مهمة فعلية، واقرأ ذاكرة حاويته في docker stats، ثم أضف البوابة وقاعدة البيانات، واضرب الناتج في عدد الروبوتات التي تتوقع تشغيلها في الوقت نفسه.
هل أحتاج إلى حساب CopilotKit لاستضافة OpenBot ذاتياً؟
نعم. يعتمد OpenBot على مشروع CopilotKit Intelligence للاحتفاظ الدائم بالمحادثات والذاكرة، ويرفض خادم v0.2.0 المثبّت بدء التشغيل ما لم يتم ضبط عنوان URL لواجهة Intelligence API، وعنوان URL لـWebSocket الخاص بالبوابة، ومفتاح API. تتوفر خطة استضافة مجانية حتى 3 November 2026، كما يُدعم النشر الإنتاجي دون اتصال باستخدام Intelligence مستضاف ذاتياً على Annual ونموذج محلي. وعليك أيضاً توفير وصولك الخاص إلى نموذج، أي مفتاح API للنموذج أو تسجيل دخول إلى موفّر مدعوم بدلاً منه، لأن OpenBot لا يضمّن أي نموذج.
لماذا يحصل كل روبوت على متصفح خاص به بدلاً من مشاركة متصفح واحد؟
لأن ملف تعريف المتصفح يمثل هوية. يعني المتصفح المشترك مشاركة ملفات تعريف الارتباط والجلسات، ولذلك فإن روبوتاً واحداً سجّل الدخول إلى حساب ما يعني أن كل الروبوتات سجّلت الدخول إلى الحساب نفسه. تمنح الحاويات المنفصلة لكل روبوت ملف تعريف خاصاً وتسجيلات دخول خاصة، ولكن فقط عندما يوجّه COMPUTER_SUPERVISOR_URL الخادم إلى المشرف. من دونه، تشارك كل الروبوتات متصفحاً واحداً. وتتمثل الكلفة في الذاكرة، لأن تشغيل Chromium لكل روبوت هو أكبر عنصر منفرد في تقدير الموارد.
ما منافذ OpenBot التي ينبغي فتحها في الجدار الناري؟
لا تفتح أياً من المنافذ ذات المستوى الأدنى. يجب أن تبقى agent-computer على 4100، ونقطتا نهاية الروبوت على 4200 و4201، وagent harness على 4202، والمشرف على 4500، وPostgreSQL على 5432 خاصة. يحميها المشروع بالرموز، ويطلب منك إبقاءها غير قابلة للوصول على أي حال. انشر فقط ما يحتاج الشخص إلى فتحه، وتذكر أن منفذ حاوية منشوراً باستخدام -p 3001:3001 يمكن الوصول إليه بغض النظر عن قاعدة ufw الافتراضية التي ترفض الاتصالات، لأن قاعدة DNAT في Docker تضع تلك الحركة في مسار FORWARD بدلاً من INPUT.