كيفية تثبيت نظام Agentlas OS على خادم VPS ذاتياً

ماهية نظام Agentlas OS فعلياً

نظام Agentlas OS هو بيئة تشغيل وكلاء (agent runtime) مفتوحة المصدر، تحتفظ بالوكلاء المتخصصين على القرص كحزم، وتُنشئ مُنسّقاً (orchestrator) مؤقتاً لكل مهمة. أنت تستضيف النظام ذاتياً عبر تثبيته في حساب المستخدم الخاص بك على خادم Linux VPS. هذا النظام ليس خدمة (service). لا يوجد برنامج خفي (daemon)، ولا منفذ استماع، ولا واجهة ويب، ولا صورة حاوية (container image) في المستودع.

تلك الجملة الأخيرة تحدد كل شيء آخر في هذه الصفحة. معظم أنظمة الوكلاء المتعددين تُشغّل عملية إشراف (supervisor process) تبقى قيد العمل وتستضيف الوكلاء. نظام Agentlas يعكس هذا المفهوم: الوكلاء المتخصصون هم ملفات ساكنة، والمُنسّق لا يوجد إلا أثناء تنفيذ المهمة. النتيجة العملية هي أن المركز (hub) في حالة الخمول يستهلك مساحة من القرص فقط، وليس من الذاكرة.

يُطلق المشروع على نواته المفتوحة اسم Hephaestus، وهذا الاسم هو ما ستراه في الأوامر والمسارات ومتغيرات البيئة. المستودع هو agentlas-ai/Agentlas-OS، وهو مرخّص برخصة Apache-2.0، ومكتوب في الغالب بلغة Python.

ما مدى حداثة هذا المشروع، بصراحة

تم إنشاء المستودع في 4 يونيو 2026. وبحلول 12 أغسطس 2026، يبلغ عمر المشروع حوالي عشرة أسابيع، مع ما يقرب من 1,150 نجمة و112 نسخة (fork). هذا عمر صغير جداً لمشروع تعتمد عليه في مهام حقيقية.

وتيرة الإصدارات أهم من عمر المشروع. تم نشر الإصدار v1.1.103 في 8 أغسطس 2026، ووصل الإصدار v1.2.0 في 12 أغسطس 2026. هذا يعني أكثر من مئة إصدار موسوم (tagged release) ضمن سلسلة 1.1، حيث صدرت عدة إصدارات في بعض الأيام، وكلها نُشرت عبر الأتمتة. المشروع الذي يتحرك بهذه السرعة سيغير سلوكه تحت يدك بين يوم الثلاثاء ويوم الخميس.

لذا، قم بتثبيت نسخة الإصدار (pin the release). يقرأ المثبّت متغيراً بيئياً لهذا الغرض، ويستخدمه الدليل بأكمله أدناه. إن التثبيت غير المقيّد لمشروع يُصدر تحديثات عدة مرات في اليوم سيمنحك أياً كان ما صادف وجوده على main في تلك الساعة.

ما تحتاجه على خادم VPS

المتطلبات بسيطة لأنّه لا يوجد شيء يعمل في الخلفية.

• خادم Linux VPS. يُعد Ubuntu 24.04 خياراً أساسياً جيداً. يكتشف المثبّت نظام التشغيل باستخدام uname -s ويختار فرعاً غير macOS لنظام Linux، لذا فإن الخوادم التي لا تحتوي على واجهة رسومية (headless) مدعومة.
• curl وtar وgit على الخادم، بالإضافة إلى مفسّر Python يعمل بشكل سليم.
• اتصال HTTPS صادر إلى raw.githubusercontent.com وgithub.com. يقوم المثبّت بتنزيل أرشيف الإصدار والتحقق من بصمة SHA-256 الخاصة به، لذا لا يمكن التثبيت على خادم لا يملك وصولاً صادراً للإنترنت.
• بيئة تشغيل مضيفة (host harness)، وهي وكيل البرمجة الذي يتواصل فعلياً مع النموذج. تُدعم جميع المحولات التالية: Claude Code وCodex وopencode وgoose وHermes.

لا تحتاج إلى صلاحيات root. يكتب المثبّت فقط في دليل المستخدم (home directory) وفي ~/.local/bin، ويقوم بإصدار تحذير بدلاً من إيقاف العملية إذا كان المسار غير قابل للكتابة. إذا كنت لا تزال في مرحلة اختيار الخادم، فإن تشغيل وكيل برمجة على خادم VPS يغطي الصورة الأساسية وإعدادات الوصول التي يُبنى عليها هذا النظام.

تثبيت الإصدار المُثبَّت (Pinned Release)

يوثّق ملف README الخاص بالمصدر سطرًا واحدًا يقوم بتمرير (pipe) سكربت من main مباشرة إلى bash. قم بتنزيل السكربت وقراءته أولاً. يقوم السكربت بالكتابة في إعدادات الـ shell الخاصة بك وفي كل أداة ربط (harness) يعثر عليها، لذا فإن قضاء عشر ثوانٍ في مراجعته أمر يستحق العناء.

curl -fsSL -o install-all-runtimes.sh \
  https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/main/scripts/install-all-runtimes.sh
less install-all-runtimes.sh
HEPHAESTUS_REF=v1.2.0 bash install-all-runtimes.sh

HEPHAESTUS_REF هو المتغير المسؤول عن التثبيت (pin). داخل السكربت، السطر المعني هو version="${HEPHAESTUS_REF:-v1.2.0}"، لذا فإن تركه دون تعيين سيمنحك الإصدار v1.2.0 اليوم، وقد يمنحك إصداراً مختلفاً في الأسبوع القادم. قم بتعيينه بشكل صريح لضمان أن عملية إعادة البناء في أكتوبر ستثبّت نفس الإصدار الذي اختبرته في أغسطس.

هناك قيد واحد يجب توضيحه: رابط السكربت أعلاه يتبع main، بينما يقوم HEPHAESTUS_REF بتثبيت حمولة وقت التشغيل (runtime payload) التي يقوم السكربت بتنزيلها. هذان أمران مختلفان. لتثبيت كليهما، قم بجلب السكربت من الوسم (tag) بدلاً من main عن طريق استبدال main بـ v1.2.0 في ذلك الرابط.

عند نجاح التشغيل، ستظهر المسارات التي تم الكتابة فيها، بما في ذلك هذان السطران:

Installed runner: /home/you/.agentlas/runtime/current/bin/hephaestus
Installed shell commands in /home/you/.local/bin (add ~/.local/bin to PATH to use them)

السطر الثاني هو ما يتجاهله المستخدمون عادةً. في أنظمة Ubuntu الجديدة، غالباً ما يكون ~/.local/bin مفقوداً من PATH، مما يؤدي إلى فشل كل أمر hep-* مع ظهور الخطأ command not found، على الرغم من نجاح عملية التثبيت. قم بإصلاح ذلك وتأكد من النتيجة:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
hep-global status

يقوم hep-global status بالإبلاغ عما قام الموجه العام (global router) بتثبيته وأدوات الربط التي اكتشفها. إذا تم تنفيذ الأمر بنجاح، فهذا يعني أن PATH الخاص بك مضبوط بشكل صحيح.

أين تُحفظ الحالة

كل شيء عبارة عن ملف ضمن دليل المستخدم الخاص بك، مما يجعل النسخ الاحتياطي والترحيل أمراً بسيطاً.

• يحتوي ~/.agentlas/runtime/v1.2.0/ على بيئة التشغيل نفسها، مع وجود ~/.agentlas/runtime/current/ كرابط رمزي (symlink) يشير إلى الإصدار النشط. يمكن الاحتفاظ بإصدارين مثبتين جنباً إلى جنب.
• يحتوي ~/.local/bin/ على أغلفة الصدفة (shell wrappers): hephaestus، وhep-build، وhep-network، وhep-search، وhep-storm، وhep-cloud، وhep-upload.
• يحتوي ~/.agentlas/networking/memory/ على الذاكرة الدائمة: playbook-registry.json، وplaybook-candidates.jsonl، وmemory-events.jsonl.
• يحتوي ~/.agentlas/networking/hub-agents/<slug>/memory/experience.sqlite على تجربة كل وكيل (agent)، محددة حسب المالك.
• يحتوي <project>/.agentlas/ontology-runtime.sqlite على حالة كل مشروع، لذا فهي تنتقل مع المستودع (repository) بدلاً من البقاء على الخادم.
• يحتوي ~/.cache/agentlas/python على ذاكرة التخزين المؤقت لـ Python على نظام Linux. يستخدم نظام macOS مساراً مختلفاً، وهو الفرع الذي يختاره المثبّت باستخدام uname.

تؤكد وثائق الذاكرة بوضوح على عدم وضع الأسرار، أو بيانات الاعتماد الخام، أو النصوص الكاملة (transcripts) في أي نطاق من نطاقات الذاكرة. تظل قيم بيانات الاعتماد في ملفات محلية متجاهلة من قبل git، ولا تسجل الذاكرة سوى الأسماء والمسارات. قم بنسخ ~/.agentlas وأدلة مشروعك .agentlas احتياطياً، وستتمكن من إعادة البناء على خادم VPS جديد.

ما هي نماذج الخلفية (Backends) التي يمكن توجيهها إليها

إليك التفاصيل التي تعيد صياغة الإعداد بالكامل: لا يقوم Agentlas باستدعاء واجهة برمجة تطبيقات (API) للنموذج، بل يقوم بذلك "حزام المضيف" (host harness).

تصف وثيقة البنية محولات وقت التشغيل التي تترجم النواة الواحدة إلى كل حزام، وتوضح أن وقت تشغيل المضيف هو المسؤول عن بيانات اعتماد النموذج. يساهم Agentlas بسطحين يلتقطهما الحزام: ملف AgentSkills وخادم MCP (بروتوكول سياق النموذج) الذي يتواصل عبر stdio. لذا، فإن السؤال "ما هي النماذج التي يدعمها Agentlas" هو في الواقع "ما هي النماذج التي يدعمها حزامك"، والإجابة هي أي نموذج يمكن لـ Claude Code أو Codex أو opencode أو goose أو Hermes الوصول إليه.

يبدو تسجيل خادم MCP كما يلي في ملف إعداد TOML بنمط Codex:

[mcp_servers.hephaestus-network]
command = "~/.agentlas/runtime/current/bin/hephaestus"
args = ["mcp", "serve"]

يتم تسجيل الخادم نفسه تلقائياً في ~/.cursor/mcp.json و~/.config/goose/config.yaml وإعدادات الأحزمة الأخرى أثناء التثبيت. إذا كنت تقوم بربط العديد من هذه الأدوات في جهاز واحد، فإن تشغيل خوادم MCP على خادم افتراضي خاص (VPS) يغطي نموذج stdio والعمليات بمزيد من التفصيل.

توجيه الطلبات إلى نقطة نهاية Ollama ذاتية الاستضافة

بما أنّ أداة الربط (harness) هي المسؤولة عن الاتصال بالنموذج، فإنّ توجيه Agentlas إلى النماذج المحلية يعني توجيه أداة الربط الخاصة بك إلى Ollama. أضافت Ollama أمراً فرعياً launch في الإصدار v0.15 لهذا الغرض تحديداً، وهو لا يزال متاحاً في الإصدار v0.32.9 بتاريخ 11 أغسطس 2026. يقوم هذا الأمر بضبط أداة الربط الحالية للعمل مع النماذج المحلية دون الحاجة إلى تعيين أي متغيرات بيئة:

ollama pull qwen3-coder:30b
ollama launch opencode

استبدل opencode بـ claude أو codex أو droid بناءً على أداة الربط التي قمت بتثبيتها. بعد ذلك، وجّه طلباً عبر بيئة التشغيل المحلية:

~/.agentlas/runtime/current/bin/hephaestus route "summarise the failing tests" --runtime ollama

في حال نجاح التوجيه، ستحصل على استجابة بصيغة JSON تتضمن اسم الوكيل أو الفريق الذي تم اختياره، مع رمز الحالة receipt_id. إذا لم تحصل على نتيجة مفيدة، فالسبب المعتاد هو طول السياق (context length). تطلب وثائق Agentlas نموذجاً بسياق لا يقل عن 64k للجلسات التي تتطلب توجيهاً مكثفاً، وتذكر qwen3-coder وgemma3 وdeepseek-r1 كأمثلة. توصي Ollama بنفس الحد الأدنى البالغ 64k لأدوات البرمجة. قرارات التوجيه تحمل قائمة الوكلاء المتاحين ضمن الـ prompt، لذا فإن استخدام نموذج بسياق 8k أو 32k سيؤدي إلى اقتطاع القائمة واختيار وكيل غير مناسب.

هناك تحذير واحد لن تجده في العناوين التسويقية. لا تمتلك Ollama أو Gemma أو DeepSeek نظام إضافات أو أوامر خاصاً بها، لذا فإن أوامر الشرطة المائلة /agentlas غير موجودة هناك. في إعداد النماذج المحلية، أنت تدير النظام عبر خادم MCP والأمر hephaestus route بدلاً من ذلك. هذا يقلل من مساحة الهجوم بشكل فعلي، وهو المقابل العادل للاحتفاظ بأوزان النماذج على خادمك الخاص.

تكلفة مركز المتخصصين الخاملين من ذاكرة الوصول العشوائي (RAM)

لا شيء. هذه هي الإجابة الكاملة، ويمكنك إثبات ذلك بدلاً من الاكتفاء بتصديقه.

يصل المتخصصون في المركز كحزم برمجية (artifacts)، وليس كعمليات (processes). يتكون المتخصص من agent.md بالإضافة إلى دليل .agentlas/ يحتوي على ملفات JSON: ملف routing-card.json للمشغلات والقدرات، وملف memory-map.json لحدود الكتابة، وملف mode-map.json لتحديد ما إذا كان يعمل منفرداً أو ضمن فريق. توصف شبكة Hephaestus بأنها مجدول يعمل داخل العملية (in-process scheduler) ولا توجد لها خدمة تعمل في الخلفية. بين المهام، يمكنك التحقق بنفسك:

pgrep -af hephaestus
systemctl --user list-units --type=service | grep -i agentlas
du -sh ~/.agentlas

لا تطبع الأوامر الاثنان الأولان شيئاً على خادم خامل، لأنه لا يوجد شيء مقيم في الذاكرة. يطبع الأمر الثالث التكلفة الوحيدة التي يفرضها المركز المتوقف عليك، وهي مساحة القرص، وتزداد هذه التكلفة مع عدد المتخصصين الذين تحتفظ بهم بالإضافة إلى نموذج التضمين (embedding model) المرفق الذي توفره بيئة التشغيل.

لذا، فإن مسألة الذاكرة تتعلق بالكامل بفترة الذروة، وتتكون الذروة من إطار العمل الخاص بك بالإضافة إلى محرك النموذج (model backend). إذا كان إطار العمل يتصل بواجهة برمجة تطبيقات مستضافة (hosted API)، فإن التكلفة المقيمة هي عملية واحدة تستهلك بضع مئات من الميجابايت. إذا كنت تستضيف الأوزان (weights) محلياً، فإن الأوزان هي التي تحدد التكلفة:

[
  {
    "label": "Hosted API model",
    "weights_gb": 0
  },
  {
    "label": "gemma3:4b",
    "weights_gb": 3.3
  },
  {
    "label": "gemma3:12b",
    "weights_gb": 8.1
  },
  {
    "label": "gemma3:27b",
    "weights_gb": 17
  },
  {
    "label": "qwen3-coder:30b",
    "weights_gb": 19
  }
]

هذه هي أحجام التنزيل المنشورة من مكتبة نماذج Ollama، وليست قياسات من اختبار أداء، كما أن ذاكرة التخزين المؤقت KV لسياق بحجم 64k تضاف فوق كل رقم أكبر من الصفر. النموذج الذي تذكره وثائق Agentlas أولاً، وهو qwen3-coder:30b، يحتاج إلى 19 جيجابايت من الأوزان قبل احتساب السياق، وحتى متغير Gemma بحجم 27B يتطلب 17 جيجابايت. مقابل هذه الأرقام، لا تظهر طبقة Agentlas نفسها في الميزانية.

كيف يقارن هذا بتشغيل أداة تنفيذ واحدة

عند تشغيل أداة تنفيذ (harness) واحدة مقابل واجهة برمجة تطبيقات (API) مستضافة، يتحمل خادمك الافتراضي (VPS) عملية واحدة فقط. وعند إضافة Agentlas، فإنه يتحمل نفس العملية الواحدة، بالإضافة إلى الملفات. المنسق (orchestrator) ليس برنامجاً إضافياً طويل الأمد، بل هو مطالبة (prompt) أكبر يتم تجميعها من الحزم الموجودة على القرص ثم التخلص منها.

التكلفة التي تتغير هي السياق (context)، وليس الذاكرة. المنسق الذي يسحب عدة بطاقات متخصصة وبيانات التوجيه الوصفية الخاصة بها يستهلك رموزاً (tokens) أكثر لكل مهمة مقارنة بأداة التنفيذ البسيطة، وفي حالة واجهة برمجة التطبيقات المستضافة، فإن هذا يعني تكلفة مالية بدلاً من استهلاك ذاكرة الوصول العشوائي (RAM). أما في حالة الأوزان المحلية، فإن التكلفة هي الوقت، لأن المطالبة الأطول تعني مرحلة تعبئة مسبقة (prefill) أطول على وحدة المعالجة المركزية (CPU) أو عبئاً أكبر على وحدة معالجة الرسومات (GPU).

لهذا السبب تتبع نصائح تحديد حجم الخادم لهذا النوع من الإعدادات قرار النموذج وليس إطار عمل الوكيل. يشرح تحديد حجم ذاكرة الوصول العشوائي ووحدة المعالجة المركزية لخادم وكيل البرمجة الافتراضي ذلك بالتفصيل، والخلاصة هنا ثابتة: اختر الخطة المناسبة للواجهة الخلفية التي تنوي تشغيلها، ثم أضف بضعة جيجابايتات كحيز إضافي لأداة التنفيذ. إذا كنت تفضل تصميم المشرف الدائم (always-on supervisor) للمقارنة بدلاً من ذلك، فإن أداة تنفيذ الوكلاء المتعددين Omnigent تُبقي منسقها مقيماً في الذاكرة، وهو ما يمثل المقايضة المعاكسة ويظهر تأثيره مباشرة في استهلاك الذاكرة أثناء الخمول.

أنماط الفشل والرسائل التي ستراها

hep-build: command not found مباشرة بعد تثبيت نظيف. كتب المثبّت إلى ~/.local/bin، وهو مسار غير موجود في PATH في صورة Ubuntu الافتراضية. ذُكر ذلك في السطر الأخير، لكن السطر اختفى عند التمرير. أضف أمر export الموضح أعلاه.

تغيرات في السلوك بعد إعادة بناء الخادم. لم تقم بتعيين HEPHAESTUS_REF، لذا استخدم المثبّت الوسم (tag) الذي كان متاحاً في ذلك اليوم. ثبّت الإصدار (pin) وسجّل رقم الإصدار بجانب أرقام إصداراتك الأخرى.

التوجيه يختار المتخصص الخطأ في نموذج محلي. نافذة سياق النموذج صغيرة جداً بالنسبة لمخزون الوكلاء. انتقل إلى نموذج بسعة 64k أو أكثر واضبط طول سياق Ollama ليتطابق معه، لأن القيمة الافتراضية أقل مما تتطلبه أدوات البرمجة.

ollama launch غير معروف. ظهر هذا الأمر الفرعي في Ollama v0.15. الحزم القديمة من مستودعات التوزيع تسبق هذا الإصدار، لذا ثبّت إصداراً حديثاً من Ollama.

التثبيت يكتب في بيئات لم تتوقعها. يكتشف البرنامج النصي كل بيئة (harness) يعثر عليها ويقوم بتهيئتها، ويكتب في ~/.claude/ و~/.codex/ و~/.gemini/ و~/.cursor/ وغيرها. على خادم بناء مشترك، اقرأ البرنامج النصي قبل تشغيله واعرف أي من تلك الأدلة يهمك.

هل يجب عليك تشغيل هذا الآن

مشروع عمره عشرة أسابيع مع إصدارات مؤتمتة عدة مرات في اليوم ليس شيئاً تضعه تحت عبء عمل إنتاجي. البنية الهندسية مثيرة للاهتمام حقاً، والترخيص هو Apache-2.0، والتصميم القائم على الملفات يعني أن إلغاء التثبيت يتم بحذف مجلدين فقط. هذه الحقائق تجعل تجربته غير مكلفة، لكن الاعتماد عليه مكلف.

موقف منطقي حالياً: ثبّت الإصدار v1.2.0، وشغّله على خادم يمكنك إعادة بنائه، واحتفظ بـ ~/.agentlas في نسخك الاحتياطية، وأعد قراءة سجل التغييرات قبل تغيير رقم الإصدار المثبت. للحصول على نظرة عامة أوسع حول ما هو موجود أيضاً في هذا المجال ومدى نضج كل خيار، فإن ملخص وكلاء الذكاء الاصطناعي ذاتيي الاستضافة هو نقطة البداية الأفضل، ويغطي استضافة وكيل Hermes ذاتياً على خادم VPS أحد بيئات التشغيل التي يتكيف معها Agentlas.

FAQ

هل يعمل نظام Agentlas OS كخادم على خادمي الافتراضي (VPS)؟

لا. لا يوجد برنامج خفي (daemon)، ولا منفذ في حالة استماع، ولا صورة حاوية في المستودع. يكتب المثبّت بيئة تشغيل تحت ~/.agentlas/runtime/ وأغلفة أوامر في ~/.local/bin، وتُعد Hephaestus Network مجدولاً يعمل ضمن العملية (in-process) وليس كخدمة خلفية. يمكنك التأكد من ذلك على جهاز خامل: لا يطبع pgrep -af hephaestus أي شيء، ولا توجد وحدة systemd لتفعيلها. الاستضافة الذاتية هنا تعني أن الكود والحالة موجودان على جهازك، وليس أن هناك خدمة في حالة استماع.

كم تستهلك ذاكرة الوصول العشوائي (RAM) مجموعة من المتخصصين الخاملين؟

لا شيء، لأن المتخصصين الخاملين ليسوا عمليات. المتخصص عبارة عن ملف agent.md بالإضافة إلى دليل .agentlas/ يحتوي على routing-card.json وmemory-map.json وبيانات وصفية مشابهة، لذا فإن تكلفة المجموعة المركونة هي مساحة القرص فقط. قِس ذلك باستخدام du -sh ~/.agentlas. تُستهلك الذاكرة فقط أثناء تشغيل المهمة، وما يستهلكها هو عملية التسخير (harness process) وخلفية النموذج (model backend) الخاصة بك، وليس طبقة Agentlas.

ما هي النماذج التي يمكنني استخدامها، وهل يمكنني توجيهه إلى خادم Ollama الخاص بي؟

لا تستدعي Agentlas واجهات برمجة تطبيقات النماذج بنفسها. يمتلك تسخير المضيف (host harness) بيانات الاعتماد والاتصال، لذا فإن النماذج المدعومة هي أي نماذج يدعمها التسخير الخاص بك. للأوزان المحلية، شغّل ollama launch opencode (مع استبدال claude أو codex أو droid)، مما يضبط التسخير مقابل خادم Ollama الخاص بك دون الحاجة إلى متغيرات بيئة. استخدم نموذجاً بسياق لا يقل عن 64k، مثل qwen3-coder أو gemma3، لأن مطالبات التوجيه (routing prompts) تحمل مخزون الوكيل وتتعرض لاقتطاع سيئ في النوافذ الأصغر.

ما هو الإصدار الذي يجب أن أثبته، ولماذا يعد التثبيت بإصدار محدد (pinning) مهماً هنا؟

ثبّت الإصدار v1.2.0، وهو الإصدار الموسوم الحالي بتاريخ 12 أغسطس 2026، عن طريق ضبط HEPHAESTUS_REF=v1.2.0 قبل تشغيل المثبّت. القيمة الافتراضية للنص البرمجي هي version="${HEPHAESTUS_REF:-v1.2.0}"، والتي تتبع أي إصدار يوسمه القائمون على الصيانة لاحقاً. يعد التثبيت بإصدار محدد أكثر أهمية من المعتاد لأن المشروع نشر أكثر من مئة إصدار في سلسلة 1.1، وبعضها في نفس اليوم، لذا فإن إعادة البناء غير المثبتة بعد أسابيع لن تمنحك النظام الذي اختبرته.