---
read_when:
    - تشغيل عمال السحابة الذين يشغّلهم Gateway أو تصحيح أخطائهم
    - التحقق من قبول العامل، أو تعيين الجلسة، أو عزل الأدوات المحلية
summary: مرجع المشغّل الداخلي لبيئة تشغيل العامل السحابي المقيّدة
title: العامل
x-i18n:
    generated_at: "2026-07-16T14:07:45Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 6591eb66c201a56e60638ce832c569b030d2d4a01b984d577e0ea44c10a0fa5e
    source_path: cli/worker.md
    workflow: 16
---

# `openclaw worker`

يمثّل `openclaw worker` نقطة دخول وقت التشغيل المقيّدة التي يشغّلها منسّق عمال سحابي
داخل بيئة عامل مُعدّة مسبقًا. وهو ليس أمرًا عامًا لتسجيل العمال يدويًا.

يثبّت Gateway حزمة OpenClaw المطابقة ويفتح نفق SSH عكسيًا
مثبّتًا بمفتاح المضيف. يشغّل مُطلِق العامل هذا الأمر باستخدام تعيين مُعدّ
مسبقًا. يتصل الأمر عبر المقبس المحلي المُمرَّر عبر النفق ويُقبل
بالدور المخصص `worker`.

## عقد التشغيل

يقرأ الأمر مغلّف تشغيل JSON واحدًا محدود الحجم بالضبط من الإدخال القياسي.
يحمل المغلّف موقع المقبس المحلي وبيانات اعتماد العامل المُنشأة وهوية الحزمة
والبروتوكول وحقبة المالك والجلسة والدور المعيّنين وحدهما.
لا تُقبل بيانات الاعتماد مطلقًا عبر وسائط سطر الأوامر، ولا تقدّم هذه الصفحة
عن قصد أي مثال لبيانات اعتماد أو مغلّف مكتوب يدويًا.

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

## حدود وقت التشغيل

تشغّل العملية حلقة الوكيل المضمّنة المعتادة باستخدام واجهة خلفية مقيّدة:

- تعمل أدوات البرمجة `read` و`write` و`edit` و`apply_patch` و`exec` و`process`
  محليًا في مساحة عمل العامل.
- تستخدم استدعاءات النموذج وكيل الاستدلال في Gateway. ولا يُحمَّل أي ملف
  تعريف محلي لمصادقة النموذج.
- تستخدم عمليات كتابة النص المنسوخ استدعاء RPC لتثبيت النص المنسوخ في Gateway.
- تستخدم تحديثات البث ودورة حياة الأدوات استدعاء RPC للأحداث الحية في Gateway.
- لا تُقبل إلا الجلسة والدور المعيّنان.

لا يبدأ وضع العامل القنوات أو واجهات HTTP في Gateway أو التشغيل التلقائي للـ Plugin
خارج مجموعة أدوات الجلسة المعيّنة. ويستخدم دليل حالة مؤقتًا ويخلو
من بيانات اعتماد دائمة لمزوّد أو منصة تطوير.

لا يتوفر إرسال الجلسات من عامل إلى آخر في هذا الوضع. يظل التوضيع
والإرسال مملوكين لـ Gateway: يمكن للمشغّل إرسال جلسة محلية حالية
ذات شجرة عمل مُدارة عبر Gateway، بينما لا يمكن لعملية العامل
إرسال نفسها أو عامل آخر.

يحمل التعيين المُعدّ مسبقًا سياق النص المنسوخ والورقة الأساسية المقبولة
وتسلسل التثبيت ومؤشر الأحداث الحية. عند إعادة اتصال النفق، تعيد العملية
القبول باستخدام بيانات الاعتماد وحقبة المالك نفسيهما، وتحتفظ
بقاعدة النص المنسوخ المقبولة، وتعيد تشغيل ذيل أحداثها الحية غير المُقرّ بها، وتعيد إرفاق
دور استدلال قيد التنفيذ بالهوية نفسها. تكون رسالة الاستدلال النهائية
هي المرجع المعتمد إذا فاتت دلتا البث. تحجب حقبة مالك لاحقة
العملية وتتسبب في خروج سليم.

يؤدي رفض النص المنسوخ `stale-base-leaf` إلى إيقاف التشغيل الحالي عند الفشل. لا يحاول وضع
العامل إعادة تنفيذ التسلسل المرفوض مقابل ورقة مختلفة، ولذلك لا ينتج
أي تثبيت مكرر؛ ويُفقد أي ذيل في الذاكرة لم يُثبّت بعد من ذلك
التشغيل. تقع إعادة التشغيل على عاتق مالك التوضيع للمرحلة الرئيسية 3، الذي يجب أن
ينشئ تعيينًا جديدًا من النص المنسوخ وسجل التثبيت المرجعيين في Gateway.
وبالمثل، تؤدي إعادة تشغيل عملية Gateway إلى إنهاء
دور استدلال معلّق بخطأ من المزوّد؛ ولا يمكن إعادة الإرفاق بتدفق استدلال نشط
في العملية نفسها إلا عبر إعادة اتصال النفق أو WebSocket العامل.

راجع [بروتوكول Gateway](/ar/gateway/protocol#worker-role-and-closed-protocol) للاطلاع على
واجهة RPC المغلقة للعامل، و[خطة العمال السحابيين](/ar/plan/cloud-workers) للاطلاع على
البنية ونموذج الأمان.