منح وكيل برمجة مستقل وصولاً مباشراً إلى طرفية جهاز المطور قد يفسد حزم النظام والمستودعات المحلية بعد تحديث خاطئ واحد. ضمن اتجاهات منظومة وكلاء الذكاء الاصطناعي مفتوحة المصدر في نوفمبر 2026، تتجه الفرق التي تبني حلول الذكاء الاصطناعي المؤسسية إلى منصة OpenHands لأن عزل التنفيذ داخل حاويات مؤقتة يشكل قلب معماريتها.
ما هو OpenHands؟ منصة OpenHands (تطور مشروعي OpenDevin وAll-Hands-AI) هي منصة هندسة برمجيات مستقلة مفتوحة المصدر بترخيص MIT دون تبعية لأي مزود. تنشئ بيئات Sandbox معزولة عبر Docker أو Kubernetes لتعديل ملفات متعددة، وتثبيت الاعتماديات، وتشغيل الاختبارات، وإصلاح الأعطال تكرارياً حتى نجاح الفحوصات دون تعريض الجهاز المضيف للخطر.
هام
ملخص تنفيذي — الركائز المعمارية لمنصة OpenHands
- رخصة MIT واستقلالية كاملة: المنصة الأساسية وحزمة Software Agent SDK وأداة CLI وبيئة التقييم مرخصة بـ MIT وتعمل مع واجهات تجارية أو نماذج مستضافة داخلياً.
- عزل Sandbox لملفات متعددة واختبارات مستقلة: Docker Runtime افتراضياً وKubernetes Remote Runtime يعزلان تعديل الشيفرة وتثبيت الحزم والاختبارات في حاويات مؤقتة.
- بنية V1 SDK وحوكمة أمنية: تضم سجل
EventStreamالحتمي، وسياسات الموافقة (AlwaysConfirmوConfirmRiskyوNeverConfirm)، ومحلل--llm-approve، وMicroagents، ودعم MCP مع OAuth.
البنية المعيارية لإصدار OpenHands V1 وسجل EventStream
تطورت OpenHands نحو بنية V1 مفصولة بين المستودع الرسمي لـ OpenHands على GitHub وحزمة Software Agent SDK، ما يتيح تشغيل واجهة المتصفح ومسارات CI الصامتة على المحرك نفسه.
حزم V1 المفصولة
openhands.sdk: يضمLLMوAgentوConversationوEventوسياسات الأمان، مع توجيه متوافق مع LiteLLM لتبديل مزود النماذج عبر متغيرات البيئة فقط.openhands.tools: يوفر أدوات قياسية هيTerminalToolللأوامر، وFileEditorToolلتعديل عدة ملفات بدقة، وTaskTrackerToolلتخطيط المهام الفرعية.openhands.workspace: يعزل حدود التنفيذ بين مجلد محلي أو حاوية Docker مؤقتة أو بيئة تشغيل بعيدة.openhands.agent_server: يتيح حالة الجلسة عبر REST وWebSocket لعميل المتصفح Agent Canvas وأداة OpenHands CLI.
سجل EventStream الحتمي
بدلاً من حفظ محادثات نصية غير مهيكلة، تسجل OpenHands كل خطوة تخطيط وأمر طرفية ورقعة ملف ومخرج خطأ في سجل EventStream مرتب زمنياً ومهيكَل برمجياً. يبث خادم openhands.agent_server هذا التدفق لحظياً عبر WebSocket إلى واجهة Agent Canvas وعميل CLI، مما يسمح للمهندسين بمراقبة فروقات الملفات ومخرجات الاختبارات مباشرة دون الدخول اليدوي إلى الحاوية. ومع تفعيل LOG_ALL_EVENTS=true، تحصل فرق المنصات على تشخيص دقيق وقابل للتكرار عند تعثر المهام المستقلة، وأثر تدقيق موثوق للامتثال الأمني، وإمكانية استئناف الجلسات الطويلة بأمان بعد أي انقطاع في الشبكة أو الخادم.
تعديل ملفات متعددة داخل Sandbox ودورات الاختبار المستقلة
إصلاح الأعطال الفعلية أو بناء ميزة خلفية جديدة يمس عادة مخططات البيانات وطبقات الخدمات ونقاط API وملفات الاختبار معاً. تعالج OpenHands هذا التعقيد بالجمع بين التحرير المتزامن لعدة ملفات وحدود العزل الصارمة داخل حاوية قابلة للتدمير.
خيارات Docker Runtime وKubernetes Remote Runtime وLocal Runtime
يشغّل Docker Runtime افتراضياً حاوية مؤقتة نظيفة لكل جلسة، فيعزل تثبيت المكتبات وتشغيل أوامر البناء داخل نطاقات الحاوية ويظل النظام المضيف سليماً بالكامل بعد انتهاء الجلسة وحذفها. ولأحمال التكامل المستمر الواسعة والترحيلات الجماعية والتقييمات المتوازية، يوزع Remote Runtime الجلسات تلقائياً على وحدات Pod مستقلة داخل عنقود Kubernetes بحيث يعمل عشرات الوكلاء بالتوازي دون تضارب على الموارد أو تلويث بيئات البناء. كما يظل خيار Local Runtime متاحاً بوضوح للمهام المحلية الخفيفة التي لا تستدعي تشغيل حاوية.
دورة التحقق المغلقة حتى اجتياز الاختبارات
داخل Sandbox، يخطط الوكيل عبر TaskTrackerTool، ويعدل الملفات المترابطة عبر FileEditorTool، ويثبت الاعتماديات المطلوبة داخل الحاوية، ثم يشغل اختبارات الوحدة والتكامل عبر TerminalTool. عند فشل أي اختبار، يقرأ الوكيل تتبع الخطأ الكامل (Stack Trace) من سجل EventStream، ويحدد ما إذا كان العطل في الشيفرة المصدرية أو في إعداد الاختبار، ثم يطبق رقعة جديدة ويعيد التشغيل حتى تنجح كل الاختبارات. تستفيد فرق تطوير البرمجيات المخصصة من هذه الدورة المغلقة لتقليص ديون الاختبارات القديمة وتسريع ترقيات الأطر الكبرى بأدلة تحقق قابلة لإعادة الإنتاج.
التثبيت، وتشغيل CLI الصامت، وحاوية Docker، وحزمة Python SDK
تتوفر المراجع الكاملة في docs.openhands.dev وopenhands.dev عبر ثلاثة مسارات: CLI المحلي، أو Docker، أو Python V1 SDK.
تثبيت CLI والتشغيل Headless وإدارة MCP
ثبّت عبر uv مع Python 3.12 (أو pip install openhands-ai)، وشغّل Agent Canvas بـ --mount-cwd (وخيار --gpu)، ونفّذ مهام headless مع --llm-approve، وأضف خوادم MCP:
uv tool install openhands --python 3.12
openhands serve --mount-cwd
openhands --headless --llm-approve \
--task "إصلاح حالة التسابق في تجديد رمز المصادقة واجتياز اختبارات pytest"
openhands mcp add internal-docs --url https://mcp.example.internal/sse
openhands mcp list
تشغيل بيئة Docker المعزولة
لتشغيل التطبيق مع صورة agent-server وتسجيل EventStream الكامل، استخدم الأمر الرسمي:
docker run -it --rm --pull=always \
-e AGENT_SERVER_IMAGE_REPOSITORY=ghcr.io/openhands/agent-server \
-e AGENT_SERVER_IMAGE_TAG=1.26.0-python \
-e LOG_ALL_EVENTS=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-v ~/.openhands:/.openhands \
-v $(pwd):/workspace:rw \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openhands-app \
docker.openhands.dev/openhands/openhands:1.8
تحذير
حدود صلاحيات مقبس Docker: ربط /var/run/docker.sock يتيح إنشاء حاويات Sandbox شقيقة بصلاحية إدارة الحاويات على المضيف. تجنب تفعيل NeverConfirm على أجهزة تحمل مفاتيح إنتاجية أو SSH شخصية؛ واحصر المهام غير المراقبة في مشغلات CI محصنة أو Kubernetes Remote Runtime.
الأتمتة عبر حزمة Python V1 SDK
يدمج مهندسو المنصات دورات الإصلاح المستقل مباشرة باستخدام openhands.sdk:
import os
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.sdk.security.confirmation_policy import ConfirmRisky
from openhands.tools.file_editor import FileEditorTool
from openhands.tools.task_tracker import TaskTrackerTool
from openhands.tools.terminal import TerminalTool
llm = LLM(
model=os.getenv("LLM_MODEL", "anthropic/claude-sonnet-4-5-20250929"),
api_key=os.getenv("LLM_API_KEY"),
base_url=os.getenv("LLM_BASE_URL"),
)
agent = Agent(
llm=llm,
tools=[
Tool(name=TerminalTool.name),
Tool(name=FileEditorTool.name),
Tool(name=TaskTrackerTool.name),
],
)
conversation = Conversation(agent=agent, workspace=os.getcwd())
conversation.set_confirmation_policy(ConfirmRisky())
conversation.send_message(
"إصلاح تقريب الوحدات الصغرى في الفوترة والتحقق من جميع اختبارات الوحدة."
)
conversation.run()
سياسات الأمان وقواعد Microagents ودعم MCP
تحمي الحاوية النظام المضيف، بينما تضبط السياسات الأوامر المسموح بها والالتزام بقواعد المستودع.
سياسات التأكيد ومحلل الأمان LLM
AlwaysConfirm: يطلب موافقة صريحة قبل كل أمر طرفية أو تعديل ملف.ConfirmRisky: الوضع المتوازن افتراضياً؛ ينفذ القراءة والاختبارات الآمنة تلقائياً ويتوقف عند الأوامر عالية الخطورة.NeverConfirm: تشغيل مستمر دون توقف، مخصص فقط لحاويات CI المؤقتة بصلاحيات مقيدة.
عند تفعيل --llm-approve، يفحص محلل الأمان المعتمد على LLM دلالة كل أمر قبل تنفيذه لمنع الحذف المدمر أو تسريب الأسرار أو التنزيلات غير المصرح بها.
قواعد Microagents ودعم MCP مع OAuth
تُحفظ قواعد المستودع الهندسية وقيود الترحيل ومعايير المراجعة في ملفات Microagents بصيغة Markdown مع ترويسة YAML (name وtrigger_type وkeywords) داخل المسار ~/.openhands/microagents/ وبالتوافق الكامل مع بنية .agents/skills/ القياسية القابلة للنقل بين الأدوات. تُحقن هذه القواعد تلقائياً في سياق الوكيل عند لمس المسارات أو الكلمات المفتاحية المحددة دون الحاجة إلى تكرار التعليمات في كل جلسة. كما يربط دعم MCP الأصيل (openhands mcp add وopenhands mcp list) خوادم الأدوات المؤسسية المحمية بمصادقة OAuth مباشرة بجلسة التنفيذ. وفي تحليل البروتوكولات القديمة أو الملفات التنفيذية المغلقة، يمكن توصيل أدوات دليل بنية REA (Reverse Engineer Anything) عبر MCP مباشرة بجلسة OpenHands لتحويل نتائج الهندسة العكسية إلى شيفرة مختبرة داخل الحاوية المعزولة نفسها.
نصيحة
نصيحة تطبيق مرحلي: ابدأ مع كل مستودع جديد بسياسة ConfirmRisky و--llm-approve وحفظ Microagents داخل Git، ثم راجع EventStream بعد أول سبرينت لمعايرة العتبات ببيانات فعلية قبل أتمتة مهام CI الصامتة.
مقارنة معمارية: OpenHands مقابل OpenCode وGoose والوكلاء المغلقين
| المعيار | OpenHands | OpenCode | Goose | وكلاء السحابة وIDE المغلقة |
|---|---|---|---|---|
| نموذج التنفيذ | دورة مستقلة (Agent Canvas وCLI وHeadless وPython V1 SDK) | جلسة طرفية تفاعلية أصلية (TUI) | تطبيق سطح مكتب وCLI وصفات API | إضافة IDE مغلقة أو سحابة مملوكة |
| عزل Sandbox | Docker Runtime مؤقت وKubernetes Remote (+ Local) | مجلد المطور والطرفية المحلية مباشرة | تشغيل محلي؛ الحاوية إعداد خارجي | متفاوت؛ سحابة مزود أو IDE محلي |
| اختبارات متعددة الملفات | اعتماديات واختبارات شاملة وإصلاح تكراري داخل الحاوية | تحرير متعدد الملفات بإشراف طرفي | سلاسل خطوات بالإضافات والوصفات | متباين؛ البناء والاختبار غالباً مقيد |
| تقييد النموذج | لا يوجد — رخصة MIT ونماذج تجارية أو محلية عبر LiteLLM | لا يوجد — عدة مزودين ونقاط محلية | لا يوجد — مفتوح المصدر متعدد النماذج | مرتفع — مرتبط بنموذج أو اشتراك |
| MCP والتوسعة | MCP أصيل (openhands mcp add وOAuth) وMicroagents وV1 SDK | دعم واسع لخوادم MCP والأدوات | إضافات MCP غنية وصفات YAML | محصور في موصلات المتجر المغلق |
لمحبي السرعة التفاعلية في الطرفية يبرز دليل OpenCode لوكيل البرمجة الطرفي مفتوح المصدر، بينما يخدم دليل Goose للوكيل البرمجي مفتوح المصدر الفرق التي تجمع سطح المكتب وCLI ووصفات API. أما عند الحاجة إلى عزل صارم بالحاويات ودورات اختبار مستقلة وتدقيق EventStream، فتتفرد OpenHands بوضوح.
حوكمة الإنتاج ومنهجية Kling Digital
يتطلب نقل OpenHands من التجربة الفردية إلى منصة هندسية مؤسسية تطبيق أربع ضوابط تشغيلية محددة:
- تقييد الشبكة الصادرة (Egress): حصر الاتصالات الصادرة من حاويات Sandbox في مرايا الحزم الداخلية وبوابة نماذج اللغة المعتمدة لدى المؤسسة فقط.
- عزل الأسرار والرموز قصيرة العمر: منع تخزين مفاتيح API أو رموز Git داخل المجلد المربوط، وإصدار رموز مؤقتة بأقل صلاحية مقيدة بالفرع النشط فقط.
- الأرشفة المركزية لسجل EventStream: إرسال مخرجات
LOG_ALL_EVENTS=trueإلى تخزين تدقيق غير قابل للتعديل للاحتفاظ بسلسلة أدلة كاملة لكل طلب دمج. - المراجعة البشرية الإلزامية وفحوصات SAST: التعامل مع نجاح الاختبارات داخل Sandbox كدليل تحقق فني لا كإذن دمج مباشر، وتمرير كل تعديل عبر مراجعة الكود وفحوصات الأمان الثابت.
تصمم Kling Digital منصات برمجة مستقلة محايدة تقنياً، وعناقيد Kubernetes Remote Runtime، وتكاملات MCP بمصادقة OAuth لمستودعات المؤسسات. نسّق جلسة تقييم معماري لإصدار OpenHands V1 عبر التواصل مع Kling Digital.




