ورشة عمل Skills

Skill Workshop هو المسار الخاضع للحوكمة في OpenClaw لإنشاء Skills مساحة العمل وتحديثها. لا تكتب الوكلاء ولا الجهات المشغّلة SKILL.md مباشرةً عبر هذا المسار، بل ينشئون مقترحًا (مسودة معلّقة تتضمن المحتوى وربط الهدف وحالة الماسح والتجزئات وبيانات التراجع الوصفية) لا يصبح Skill نشطة إلا عند تطبيقه.

لا يكتب Skill Workshop إلا Skills مساحة العمل. ولا يمس مطلقًا Skills المضمّنة أو التابعة لـ Plugin أو ClawHub أو الجذر الإضافي أو المُدارة أو الخاصة بالوكيل الشخصي أو النظام.

آلية العمل

• المقترح أولًا: يُخزَّن المحتوى المُنشأ بوصفه PROPOSAL.md، وليس SKILL.md.
• التطبيق هو عملية الكتابة المباشرة الوحيدة: لا تؤدي عمليات الإنشاء والتحديث والمراجعة مطلقًا إلى تغيير Skills النشطة.
• مقيّد بمساحة العمل: تستهدف عمليات الإنشاء جذر skills/ لمساحة العمل؛ ولا يُسمح بالتحديثات إلا لـ Skills مساحة العمل القابلة للكتابة.
• منع الاستبدال: تفشل عملية الإنشاء إذا كانت Skill المستهدفة موجودة بالفعل.
• مرتبط بالتجزئة: ترتبط مقترحات التحديث بالتجزئة الحالية للهدف وتصبح stale إذا تغيرت Skill المباشرة قبل التطبيق.
• مقيّد بالماسح: يعيد التطبيق تشغيل ماسح الأمان قبل الكتابة.
• قابل للاسترداد: يكتب التطبيق بيانات التراجع الوصفية قبل المساس بالملفات المباشرة.
• واجهات متسقة: تستدعي الدردشة وCLI وGateway جميعًا الخدمة نفسها.

دورة الحياة

إنشاء/تحديث -> معلّقمراجعة       -> معلّقتطبيق        -> مطبّقرفض          -> مرفوضعزل          -> معزولتغيير الهدف  -> قديم

لا يمكن مراجعة المقترح أو تطبيقه أو رفضه أو عزله إلا إذا كان pending.

تنظيم دورة الحياة

يتتبع Gateway الاستخدام الإجمالي لـ Skills في قاعدة بيانات الحالة المشتركة. ومرة يوميًا، يراجع Skills التي أنشأها وطبّقها Skill Workshop. تصبح Skills غير المستخدمة لأكثر من 30 يومًا stale؛ وبعد 90 يومًا تصبح archived ويجري استبعادها من لقطات Skills الجديدة للوكلاء. تظل ملفات Skills المؤرشفة دون تغيير على القرص. لا تخضع Skills المؤلفة يدويًا للتنظيم مطلقًا؛ فلا تدخل تنظيم دورة الحياة إلا Skills التي أنشأتها مقترحات Skill Workshop.

تتجاوز Skills المثبّتة انتقالات دورة الحياة. وتعود Skill القديمة إلى active بعد استخدامها وتشغيل عملية الفحص التالية. ولا تعود Skills المؤرشفة إلا من خلال استعادة صريحة:

تنطبق انتقالات دورة الحياة وعمليات الاستعادة على الجلسات الجديدة؛ وتحتفظ الجلسات قيد التشغيل بلقطة Skills الحالية لديها.

openclaw skills curator statusopenclaw skills curator pin <skill>openclaw skills curator unpin <skill>openclaw skills curator restore <skill>

تقبل جميع أوامر المنظّم --json. وتُبلغ الحالة أيضًا عن مرشحي التداخل الحتميين بوصفهم اقتراحات فقط؛ ولا تدمج Skills مطلقًا ولا تستدعي نموذجًا.

الدردشة

اطلب من الوكيل Skill التي تريدها؛ فيستدعي skill_workshop ويعيد معرّف مقترح.

التعلّم من العمل الأخير

استخدم /learn لتحويل المحادثة الحالية أو المصادر المسماة إلى مقترح Skill واحد موجّه بالمعايير:

/learn/learn docs/runbook.md وhttps://example.com/guide؛ ركّز على الاسترداد

من دون طلب، يطلب /learn من الوكيل استخلاص سير العمل القابل لإعادة الاستخدام من المحادثة الحالية. ومع وجود طلب، يتعامل الوكيل مع المسارات وعناوين URL والملاحظات الملصقة ومراجع المحادثة بوصفها مصادر، مع مراعاة متطلبات التركيز والنطاق والتسمية. ويجمع المصادر باستخدام أدواته الحالية، ثم يستدعي skill_workshop مع action: "create".

يظل المقترح الناتج pending؛ ولا يطبّقه /learn مطلقًا. راجعه وطبّقه من خلال مسار الموافقة المعتاد أو باستخدام openclaw skills workshop.

الإنشاء:

أنشئ Skill باسم morning-catchup تنفّذ روتين صندوق الوارد الخاص بي يوم الاثنين.

تحديث Skill موجودة في مساحة العمل:

حدّث trip-planning ليتحقق أيضًا من خرائط المقاعد قبل الحجز.

التكرار على مقترح معلّق:

اعرض لي مقترح morning-catchup.راجعه ليضع أيضًا علامة على كل ما هو محدد بأنه عاجل.طبّق مقترح morning-catchup.

تُشغَّل عمليات apply وreject وquarantine التي يبدأها الوكيل دون مطالبة موافقة إضافية افتراضيًا. اضبط skills.workshop.approvalPolicy على "pending" لطلب موافقة الجهة المشغّلة قبل هذه الإجراءات.

عندما تكون الموافقة مطلوبة، تحدد المطالبة معرّف المقترح وSkill المستهدفة، وتعرض وصف المقترح وعدد ملفات الدعم وحجم المتن. تكون طلبات الموافقة محددة زمنيًا لتنتهي قبل مراقب مهلة أداة الوكيل. وإذا لم يصل قرار قبل انتهاء صلاحية المطالبة، فلن يُنفَّذ إجراء دورة الحياة: يظل المقترح معلّقًا ودون تغيير. اتخذ القرار لاحقًا في واجهة Skill Workshop أو شغّل openclaw skills workshop apply|reject|quarantine <proposal-id>. ينبغي ألا تعيد الوكلاء محاولة إجراء دورة حياة منتهي الصلاحية في حلقة.

CLI

# إنشاءopenclaw skills workshop propose-create \  --name morning-catchup \  --description "متابعة يومية لصندوق الوارد: الفرز، الأرشفة، الإبراز، إعداد المسودات، التخطيط" \  --proposal ./PROPOSAL.md # تحديث Skill موجودة في مساحة العملopenclaw skills workshop propose-update trip-planning --proposal ./PROPOSAL.md # العرض والفحصopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id> # المراجعة قبل الموافقةopenclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md # الإنهاءopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "مكرر"openclaw skills workshop quarantine <proposal-id> --reason "يحتاج إلى مراجعة أمنية"

يقبل كل أمر فرعي --agent <id> (مساحة العمل المستهدفة؛ وتكون افتراضيًا المستنتجة من cwd، ثم الوكيل الافتراضي) و--json (مخرجات منظّمة). كما تقبل propose-create وpropose-update وrevise أيضًا --goal <text> و --evidence <text> لتسجيل سياق المقترح إلى جانب --proposal.

محتوى المقترح

أثناء التعليق، يُخزَّن المقترح بوصفه PROPOSAL.md مع frontmatter خاص بالمقترح فقط:

---name: "morning-catchup"description: "متابعة يومية لصندوق الوارد: الفرز، الأرشفة، الإبراز، إعداد المسودات، التخطيط"status: proposalversion: "v1"date: "2026-05-30T00:00:00.000Z"---

عند التطبيق، يكتب Skill Workshop ملف SKILL.md النشط ويزيل الحقول الخاصة بالمقترح فقط: status وversion للمقترح وdate للمقترح.

ملفات الدعم

استخدم --proposal-dir عندما تحتاج Skill المقترحة إلى ملفات بجانب PROPOSAL.md:

openclaw skills workshop propose-create \  --name weekly-update \  --description "ملخص الجمعة: الإحصاءات، أبرز النقاط، أهم ثلاثة أمور للأسبوع المقبل" \  --proposal-dir ./weekly-update-proposal

يجب أن يحتوي الدليل على PROPOSAL.md. ويجب أن توجد ملفات الدعم ضمن assets/ أو examples/ أو references/ أو scripts/ أو templates/. يفحص Skill Workshop هذه الملفات ويحسب تجزئاتها ويخزنها مع المقترح، ثم يكتبها بجانب SKILL.md المباشر عند التطبيق فقط.

مسارات ملفات الدعم المرفوضة: المسارات المطلقة، ومقاطع المسارات المخفية، واجتياز المسار، والمسارات المتداخلة، والملفات القابلة للتنفيذ، والنصوص غير المشفرة بـ UTF-8، والبايتات الفارغة، والمسارات الواقعة خارج مجلدات الدعم القياسية.

أداة الوكيل

يستخدم النموذج skill_workshop مع action مطلوب واحد: create | update | revise | list | inspect | apply | reject | quarantine. وتنطبق المعلمات الأخرى بحسب الإجراء:

يجب على الوكلاء استخدام skill_workshop لعمل Skills المُنشأة. ويجب ألا ينشئوا ملفات المقترحات أو يغيروها من خلال write أو edit أو exec أو أوامر shell أو عمليات نظام الملفات المباشرة.

Skills المقترحة

يكتشف OpenClaw التعليمات الدائمة مثل «في المرة القادمة» و«تذكّر أن»، والتصحيحات التفاعلية عند انتهاء دورة تفاعلية، بما في ذلك الدورات الفاشلة. وفي الدورة التالية، يعرض الوكيل حفظ أحدث سير عمل مكتشف من خلال skill_workshop؛ ويقرر المستخدم ما إذا كان سينشئ مقترحًا. لا ينشئ هذا الاقتراح المضمّن Skill ولا يغيرها من تلقاء نفسه. فعّل skills.workshop.autonomous.enabled لإنشاء مقترحات معلّقة مباشرةً بدلًا من ذلك. في واجهة Control UI، توفر علامة التبويب Workshop الإعداد نفسه كمفتاح تبديل التعلّم الذاتي في رأس الصفحة، وكزر تمكين على لوحة المقترحات الفارغة.

فحص الجلسات السابقة

يمكن لواجهة Control UI مراجعة الأعمال الأقدم من دون تمكين التعلّم الذاتي المستقل. افتح Plugins → Workshop وحدد البحث عن أفكار لـ Skills. يبدأ الفحص بأحدث الجلسات المؤهلة ويراجع نافذة محدودة من العمل الجوهري. ويتخطى جلسات cron وheartbeat وhook والوكيل الفرعي وACP والجلسات المملوكة لـ Plugin وجلسات المراجعة الداخلية، إضافةً إلى المحادثات التي تحتوي على أقل من ست دورات للنموذج.

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

يمكن لفحص واحد إنشاء أو مراجعة ثلاثة مقترحات معلّقة على الأكثر. ولا يمكنه تطبيق Skill مباشرة أو رفضها أو عزلها أو تعديلها. يعرض Workshop التغطية التراكمية، مثل تمت مراجعة 20 جلسة · 18 يونيو–اليوم · عُثر على فكرتين. حدد فحص عمل أقدم للمتابعة من مؤشر أقدم جلسة المخزّن. وبعد استنفاد السجل المتاح، يصبح الإجراء فحص عمل جديد.

المراجعة التاريخية يدوية حتى عندما تكون skills.workshop.autonomous.enabled هي false. تبدأ كل نقرة تشغيلًا للنموذج، لذا تنطبق شروط التسعير ومعالجة البيانات الخاصة بموفّر الخدمة. يُخزَّن المؤشر وأعداد التغطية في قاعدة بيانات حالة OpenClaw المشتركة؛ ولا يُنسخ محتوى النص المنسوخ إلى حالة الفحص.

عند تمكين الالتقاط الذاتي، يمكن لـ OpenClaw أيضًا إجراء مراجعة متحفظة بعد إنجاز عمل ناجح وجوهري، وبعد أن يصبح نظام الوكلاء بأكمله خاملًا. يمكن لهذه المراجعة المعزولة إنشاء مقترح معلق واحد على الأكثر أو تنقيحه. ولا يمكنها تحديث مهارة قيد الاستخدام، أو تطبيق مقترح أو رفضه أو عزله، حتى عندما تكون approvalPolicy هي "auto".

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

الموافقة والاستقلالية

{  skills: {    workshop: {      autonomous: {        enabled: false,      },      allowSymlinkTargetWrites: false,      approvalPolicy: "auto",      maxPending: 50,      maxSkillBytes: 40000,    },  },}

يتعرّف الالتقاط الذاتي على القواعد المستقبلية (على سبيل المثال، «من الآن فصاعدًا») والتصحيحات التفاعلية (على سبيل المثال، «هذا ليس ما طلبته»). ويُجمّع التعليمات الجديدة حسب الموضوع في ما يصل إلى ثلاثة مقترحات لكل دور، ويوجّه مطابقات المفردات إلى مهارات مساحة العمل الحالية القابلة للكتابة، كما ينقّح مقترحه المعلق عندما يستهدف تصحيح آخر المهارة نفسها.

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

راجع التعلّم الذاتي للاطلاع على السلوك الكامل للمراجعة الذاتية ونموذج السلامة.

يقتصر وصف المقترح دائمًا على 160 بايت، بصرف النظر عن maxSkillBytes.

أساليب Gateway

تتوفر requestRevision في Gateway فقط (ولا يوجد مكافئ لها في CLI أو أدوات الوكيل): فهي تمرّر تعليمات تنقيح ذات نص حر إلى جلسة محادثة الوكيل المالك بدلًا من استبدال PROPOSAL.md مباشرةً، وذلك لواجهات المستخدم التي تطلب من الوكيل التنقيح بدلًا من إرسال محتوى جديد حرفيًا.

تُعد historyStatus وhistoryScan أسلوبَي دعم لواجهة التحكم. تقبل historyScan القيمة direction: "older" | "newer"؛ وهي تترك النتائج دائمًا في صورة مقترحات معلقة.

التخزين

&lt;OPENCLAW_STATE_DIR&gt;/skill-workshop/  proposals.json  proposals/<proposal-id>/    proposal.json    PROPOSAL.md    rollback.json    assets/    examples/    references/    scripts/    templates/

دليل الحالة الافتراضي: ~/.openclaw.

• proposal.json: سجل المقترح المعتمد.
• proposals.json: فهرس سريع لإعداد القوائم، وقابل لإعادة البناء من مجلدات المقترحات.
• PROPOSAL.md: مقترح مهارة معلق.
• rollback.json: بيانات تعريف الاسترداد التي تُكتب قبل أن يطبّق الإجراء التغييرات على الملفات قيد الاستخدام.

الحدود

استكشاف الأخطاء وإصلاحها

تشخيص سياسة الأدوات

عند تمكين الالتقاط الذاتي، تشغّل openclaw doctor عملية التحقق core/doctor/skill-workshop-tool-policy للوكيل الافتراضي. وإذا كانت السياسة تخفي skill_workshop، يسمّي التحذير أول طبقة إعداد مستبعِدة والتغيير الدقيق المطلوب إجراؤه في allow أو alsoAllow. قد تظل أدلة التشغيل الأقدم تستخدم openclaw plugins inspect skill-workshop؛ ويوضح هذا الأمر الآن أن ورشة المهارات مضمّنة، ويطبع تلميح السياسة نفسه عند انطباقه.

ذو صلة

• المهارات لمعرفة ترتيب التحميل والأسبقية وإمكانية الظهور
• التعلّم الذاتي لمقترحات المهارات المتحفظة بعد التشغيل
• إنشاء المهارات للتعرّف على أساسيات SKILL.md المكتوبة يدويًا
• إعداد المهارات لمخطط skills.workshop الكامل
• CLI للمهارات لأوامر openclaw skills