CLI commands
Skills
openclaw skills
افحص Skills المحلية، وابحث في ClawHub، وثبّت Skills من ClawHub أو Git أو الأدلة المحلية، وتحقق من Skills في ClawHub، وحدّث عمليات التثبيت التي يتتبعها ClawHub.
ذات صلة:
- نظام Skills: Skills
- ورشة عمل Skills: ورشة عمل Skills
- إعدادات Skills: إعدادات Skills
- عمليات تثبيت ClawHub: ClawHub
الأوامر
openclaw skills search "calendar"openclaw skills search --limit 20 --jsonopenclaw skills install @owner/<slug>openclaw skills install @owner/<slug> --version <version>openclaw skills install git:owner/repoopenclaw skills install git:owner/repo@mainopenclaw skills install ./path/to/skill --as custom-nameopenclaw skills install @owner/<slug> --forceopenclaw skills install @owner/<slug> --force-installopenclaw skills install @owner/<slug> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw skills update @owner/<slug> --force-installopenclaw skills update @owner/<slug> --acknowledge-clawhub-riskopenclaw skills update @owner/<slug> --globalopenclaw skills update --allopenclaw skills update --all --agent <id>openclaw skills update --all --globalopenclaw skills verify @owner/<slug>openclaw skills verify @owner/<slug> --version <version>openclaw skills verify @owner/<slug> --tag <tag>openclaw skills verify @owner/<slug> --cardopenclaw skills verify @owner/<slug> --globalopenclaw skills listopenclaw skills list --eligibleopenclaw skills list --jsonopenclaw skills list --verboseopenclaw skills list --agent <id>openclaw skills info <name>openclaw skills info <name> --jsonopenclaw skills info <name> --agent <id>openclaw skills checkopenclaw skills check --agent <id>openclaw skills check --jsonopenclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.mdopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Not reusable"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"تستخدم الأوامر search وupdate وverify منصة ClawHub مباشرةً. يثبّت install @owner/<slug> إحدى Skills من ClawHub، ويستنسخ install git:owner/repo[@ref] إحدى Skills من Git، وينسخ install ./path دليل Skill محليًا. تستهدف الأوامر install وupdate وverify افتراضيًا دليل skills/ في مساحة العمل النشطة؛ ومع --global، تستهدف دليل Skills المُدارة المشترك. تواصل الأوامر list وinfo وcheck فحص Skills المحلية المرئية لمساحة العمل والإعدادات الحالية. تحدد الأوامر المرتبطة بمساحة العمل مساحة العمل المستهدفة أولًا من --agent <id>، ثم من دليل العمل الحالي عندما يكون داخل مساحة عمل وكيل مُعدّة، ثم من الوكيل الافتراضي.
تتوقع عمليات التثبيت من Git والأدلة المحلية وجود SKILL.md في جذر المصدر. يأتي المعرّف المختصر للتثبيت من قيمة name في البيانات الوصفية الأمامية لملف SKILL.md عندما تكون صالحة، ثم من اسم دليل المصدر أو المستودع؛ استخدم --as <slug> لتجاوزه. يقتصر --version على ClawHub. لا تدعم عمليات تثبيت Skills مواصفات حزم npm أو مسارات ملفات zip/الأرشيفات، ولا يحدّث openclaw skills update سوى عمليات التثبيت التي يتتبعها ClawHub.
تستخدم عمليات تثبيت تبعيات Skills المدعومة من Gateway، والتي تُشغّل من الإعداد الأولي أو إعدادات Skills، مسار طلب skills.install المنفصل بدلًا من ذلك.
ملاحظات:
| الخيار/السلوك | الوصف |
|---|---|
search [query...] |
استعلام اختياري؛ احذفه لاستعراض موجز البحث الافتراضي في ClawHub. |
search --limit <n> |
يحدّ عدد النتائج المُعادة. |
install git:owner/repo[@ref] |
يثبّت Skill من Git. يمكن أن تحتوي مراجع الفروع على شرطات مائلة، مثل git:owner/repo@feature/foo. |
install ./path/to/skill |
يثبّت دليلًا محليًا يحتوي جذره على SKILL.md. |
install --as <slug> |
يتجاوز المعرّف المختصر المستنتج لعمليات التثبيت من Git والأدلة المحلية. |
install --version <version> |
ينطبق فقط على مراجع Skills في ClawHub. |
install --force |
يستبدل مجلد Skill موجودًا في مساحة العمل وله المعرّف المختصر نفسه. |
install/update --force-install |
يثبّت Skill معلّقة ومدعومة من GitHub قبل اكتمال فحص ClawHub. |
--global |
يستهدف دليل Skills المُدارة المشترك؛ ولا يمكن دمجه مع --agent <id>. |
--agent <id> |
يستهدف مساحة عمل وكيل مُعدّة واحدة؛ ويتجاوز الاستنتاج من دليل العمل الحالي. |
update @owner/<slug> |
يحدّث Skill واحدة متتبعة. أضف --global لاستهداف دليل Skills المُدارة المشترك بدلًا من مساحة العمل. |
update --all |
يحدّث عمليات تثبيت ClawHub المتتبعة في مساحة العمل المحددة، أو في دليل Skills المُدارة المشترك عند استخدام --global. |
verify @owner/<slug> |
يطبع افتراضيًا مغلف JSON clawhub.skill.verify.v1 الخاص بـ ClawHub. لا يوجد خيار --json لأن JSON هو الإعداد الافتراضي بالفعل. تُقبل المعرّفات المختصرة المجردة للتوافق عندما تكون Skill مثبتة بالفعل أو غير ملتبسة؛ وتتجنب المراجع المؤهلة باسم المالك التباس الناشر. |
مصدر verify |
عندما يعيد ClawHub مصدرًا حلّه الخادم، يتضمن JSON الخاص بالتحقق أيضًا openclaw.verifiedSourceUrl مثبّتًا على عملية إيداع. تظل عناوين URL غير المتاحة أو المعلنة ذاتيًا للمصدر داخل مغلف المصدر الخام فقط ولا تُرقّى. |
محدد إصدار verify |
يستخدم verify الملف .clawhub/origin.json مع Skills المثبتة من ClawHub، ولذلك يتحقق من الإصدار المثبت مقابل السجل الذي أتى منه. يتجاوز --version و--tag محدد الإصدار، لكنهما يحتفظان بذلك السجل المثبت عند وجود بيانات وصفية للمصدر. |
verify --card |
يطبع Markdown لبطاقة Skill المُنشأة بدلًا من JSON. ينتهي برمز غير صفري عندما يعيد ClawHub ok: false أو decision: "fail"؛ وتكون التوقيعات غير الموقعة معلوماتية ما لم تتغير سياسة ClawHub. |
| بصمة بطاقة Skill | يمكن أن تتضمن حزم ClawHub المثبتة ملف skill-card.md مُنشأ. يتعامل OpenClaw مع التحقق باعتباره قرارًا صادرًا عن خادم ClawHub، ولا يرفض Skill مثبتة لمجرد أن البطاقة المُنشأة تغيّر بصمة الحزمة. |
check --agent <id> |
يفحص مساحة عمل الوكيل المحدد ويبلغ عن Skills الجاهزة المرئية فعليًا لموجّه ذلك الوكيل أو لواجهة أوامره. |
list |
الإجراء الافتراضي عند عدم تقديم أمر فرعي. |
مخرجات list/info/check |
تُرسل المخرجات المنسقة إلى stdout. ومع --json، تظل الحمولة القابلة للقراءة آليًا على stdout لاستخدامها مع الأنابيب والبرامج النصية. |
تتحقق عمليات تثبيت وتحديث Skills المجتمعية في ClawHub من مستوى الثقة قبل التنزيل. تستخدم إصدارات الأرشيف المجتمعية ذات الإصدارات بيانات وصفية للثقة خاصة بالإصدار المحدد. تعتمد Skills المستضافة على GitHub والمدعومة بأداة الحل على أداة حل التثبيت في ClawHub لفرض سياسة الفحص والتثبيت الإجباري قبل أن تعيد عملية إيداع مثبّتة؛ استخدم --force-install لتثبيت Skill معلّقة ومدعومة من GitHub قبل اكتمال ذلك الفحص. تُرفض الإصدارات المجتمعية الضارة أو المحظورة. تتطلب الإصدارات المجتمعية الخطرة مراجعةً واستخدام --acknowledge-clawhub-risk عندما ينبغي لأمر غير تفاعلي المتابعة بعد تلك المراجعة. يتجاوز ناشرو Skills الرسميون في ClawHub ومصادر Skills المضمّنة في OpenClaw مطالبة الثقة بالإصدار هذه.
ورشة عمل Skills
يدير openclaw skills workshop مقترحات Skills المعلّقة في مساحة العمل المحددة. لا تصبح المقترحات Skills نشطة حتى تُطبّق. لمعرفة تفاصيل تخزين المقترحات، وضمانات ملفات الدعم، وأساليب Gateway، وسياسة الموافقة، راجع ورشة عمل Skills.
openclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal-dir ./qa-check-proposalopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Duplicate"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"تقبل الأوامر propose-create وpropose-update وrevise أيضًا الخيار --goal <text>
والخيار --evidence <text> لتسجيل دوافع المقترح والملاحظات الداعمة
إلى جانب محتوى --proposal/--proposal-dir.
