CLI commands

Skills

openclaw skills

افحص Skills المحلية، وابحث في ClawHub، وثبّت Skills من ClawHub/Git/الأدلة المحلية، وتحقق من Skills في ClawHub، وحدّث التثبيتات المتتبعة عبر ClawHub.

ذات صلة:

الأوامر

bash
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 --card Markdown بطاقة المهارة المولدة بدلًا من 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، وسياسة الموافقة، راجع ورشة المهارات.

bash
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"

ذات صلة

Was this useful?
On this page

On this page