CLI commands
Skills
openclaw skills
افحص Skills المحلية، وابحث في ClawHub، وثبّت Skills من ClawHub/Git/الأدلة المحلية، وتحقق من Skills في ClawHub، وحدّث التثبيتات المتتبعة عبر ClawHub.
ذات صلة:
- نظام 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> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw 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> مهارة من ClawHub، وينسخ install git:owner/repo[@ref] مهارة Git، وينسخ install ./path دليل مهارة محلي. افتراضيًا، تستهدف install وupdate وverify دليل skills/ في مساحة العمل النشطة؛ ومع --global، تستهدف دليل Skills المدار المشترك. لا تزال list/info/check تفحص Skills المحلية المرئية لمساحة العمل والإعدادات الحالية. تحل الأوامر المدعومة بمساحة العمل مساحة العمل الهدف من --agent <id>، ثم دليل العمل الحالي عندما يكون داخل مساحة عمل وكيل مهيأة، ثم الوكيل الافتراضي.
تتوقع تثبيتات Git والأدلة المحلية وجود SKILL.md في جذر المصدر. يأتي اسم التثبيت المختصر من name في frontmatter داخل 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]مهارة Git. قد تحتوي مراجع الفروع على شرطات مائلة، مثلgit:owner/repo@feature/foo. - يثبّت
install ./path/to/skillدليلًا محليًا يحتوي جذره علىSKILL.md. - يتجاوز
install --as <slug>الاسم المختصر المستنتج لتثبيتات Git والأدلة المحلية. - ينطبق
install --version <version>على مراجع Skills في ClawHub فقط. - يستبدل
install --forceمجلد مهارة مساحة عمل موجودًا للاسم المختصر نفسه. - تتحقق تثبيتات وتحديثات Skills المجتمعية في ClawHub من الثقة قبل التنزيل. تستخدم إصدارات الأرشيف المجتمعية ذات الإصدارات بيانات وصفية للثقة مطابقة للإصدار المحدد. تعتمد Skills في GitHub المدعومة بالمحلّل على محلّل التثبيت في ClawHub لفرض سياسة الفحص والتثبيت القسري قبل أن يعيد تثبيتًا مثبتًا على commit محدد. تُرفض الإصدارات المجتمعية الخبيثة أو المحظورة. تتطلب الإصدارات المجتمعية عالية المخاطر مراجعة و
--acknowledge-clawhub-riskعندما ينبغي لأمر غير تفاعلي أن يتابع بعد تلك المراجعة. يتجاوز ناشرو Skills الرسميون في ClawHub ومصادر Skills المضمّنة في OpenClaw مطالبة ثقة الإصدار هذه. - يستهدف
--globalدليل Skills المدار المشترك ولا يمكن جمعه مع--agent <id>. - يستهدف
--agent <id>مساحة عمل وكيل واحدة مهيأة ويتجاوز استنتاج دليل العمل الحالي. - يحدّث
update @owner/<slug>مهارة متتبعة واحدة. أضف--globalلاستهداف دليل Skills المدار المشترك بدلًا من مساحة العمل. - يحدّث
update --allتثبيتات ClawHub المتتبعة في مساحة العمل المحددة، أو في دليل Skills المدار المشترك عند جمعه مع--global. - يطبع
verify @owner/<slug>غلاف JSON الخاص بـclawhub.skill.verify.v1من ClawHub افتراضيًا. لا توجد راية--jsonلأن JSON هو الافتراضي بالفعل. تظل الأسماء المختصرة المجردة مقبولة للتوافق عندما تكون المهارة مثبتة بالفعل أو غير ملتبسة، لكن المراجع المؤهلة بالمالك تتجنب غموض الناشر. - عندما يعيد ClawHub مصدرًا محلولًا من الخادم، يتضمن JSON الخاص بالتحقق أيضًا
openclaw.verifiedSourceUrlمثبتًا على commit محدد. تبقى عناوين URL المصدر غير المتاحة أو المصرح بها ذاتيًا داخل غلاف المصدر الخام فقط ولا تُرقّى. - يستخدم
verifyملف.clawhub/origin.jsonلـ Skills المثبتة من ClawHub، لذلك يتحقق من الإصدار المثبت مقابل السجل الذي جاء منه. يتجاوز--versionو--tagمحدد الإصدار مع الاحتفاظ بذلك السجل المثبت عندما تكون بيانات الأصل الوصفية موجودة. - يطبع
verify --cardMarkdown بطاقة المهارة المولدة بدلًا من JSON. يخرج الأمر برمز غير صفري عندما يعيد ClawHub القيمةok: falseأوdecision: "fail"؛ تكون التوقيعات غير الموقعة معلوماتية ما لم تتغير سياسة ClawHub. - يمكن أن تتضمن حزم ClawHub المثبتة ملف
skill-card.mdمولدًا. يتعامل OpenClaw مع التحقق كقرار خادم من ClawHub ولا يرفض مهارة مثبتة لمجرد أن تلك البطاقة المولدة تغيّر بصمة الحزمة. - يتحقق
check --agent <id>من مساحة عمل الوكيل المحدد ويبلّغ عن Skills الجاهزة المرئية فعليًا لمطالبة ذلك الوكيل أو سطح أوامره. listهو الإجراء الافتراضي عند عدم تقديم أمر فرعي.- تكتب
listوinfoوcheckمخرجاتها المعروضة إلى stdout. مع--json، يعني ذلك أن الحمولة القابلة للقراءة آليًا تبقى على stdout للأنابيب والسكربتات.
ورشة المهارات
يدير openclaw skills workshop مقترحات المهارات المعلقة في مساحة العمل المحددة. لا تكون المقترحات Skills نشطة حتى تُطبّق. للتعرف على تخزين المقترحات، وضمانات ملفات الدعم، وطرق Gateway، وسياسة الموافقة، راجع ورشة المهارات.
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"