المهارات

ClawHub

ClawHub هو سجل المهارات العامة لـ OpenClaw. إنها خدمة مجانية: جميع المهارات عامة ومفتوحة ومرئية للجميع للمشاركة وإعادة الاستخدام. المهارة هي مجرد مجلد يحتوي على ملف SKILL.md (بالإضافة إلى ملفات نصية داعمة). يمكنك تصفح المهارات في تطبيق الويب أو استخدام CLI للبحث عن المهارات وتثبيتها وتحديثها ونشرها. الموقع: clawhub.ai

ما هو ClawHub

  • سجل عام لمهارات OpenClaw.
  • مخزن مُرَقْمَن لحزم المهارات والبيانات الوصفية.
  • واجهة اكتشاف للبحث والعلامات وإشارات الاستخدام.

كيف يعمل

  1. ينشر المستخدم حزمة مهارات (ملفات + بيانات وصفية).
  2. يخزن ClawHub الحزمة، ويحلل البيانات الوصفية، ويعين إصدارًا.
  3. يقوم السجل بفهرسة المهارة للبحث والاكتشاف.
  4. يتصفح المستخدمون المهارات ويقومون بتنزيلها وتثبيتها في OpenClaw.

ما يمكنك فعله

  • نشر مهارات جديدة وإصدارات جديدة من المهارات الحالية.
  • اكتشاف المهارات بالاسم أو العلامات أو البحث.
  • تنزيل حزم المهارات وفحص ملفاتها.
  • الإبلاغ عن المهارات المسيئة أو غير الآمنة.
  • إذا كنت مشرفًا، يمكنك إخفاء المهارات أو إظهارها أو حذفها أو حظر المستخدمين.

لمن هذا (ملائم للمبتدئين)

إذا كنت ترغب في إضافة قدرات جديدة إلى وكيل OpenClaw الخاص بك، فإن ClawHub هو أسهل طريقة للعثور على المهارات وتثبيتها. لا تحتاج إلى معرفة كيفية عمل الواجهة الخلفية. يمكنك:

  • البحث عن المهارات باستخدام لغة عادية.
  • تثبيت مهارة في مساحة العمل الخاصة بك.
  • تحديث المهارات لاحقًا بأمر واحد.
  • إنشاء نسخة احتياطية من مهاراتك الخاصة عن طريق نشرها.

البدء السريع (غير تقني)

  1. قم بتثبيت CLI (انظر القسم التالي).
  2. ابحث عن شيء تحتاجه:
    • clawhub search "calendar"
  3. قم بتثبيت مهارة:
    • clawhub install <skill-slug>
  4. ابدأ جلسة OpenClaw جديدة حتى تلتقط المهارة الجديدة.

تثبيت CLI

اختر واحدة:

npm i -g clawhub

pnpm add -g clawhub

كيف يتناسب مع OpenClaw

بشكل افتراضي، يقوم CLI بتثبيت المهارات في ./skills ضمن دليل العمل الحالي. إذا تم تكوين مساحة عمل OpenClaw، فإن clawhub يتراجع إلى مساحة العمل تلك ما لم تتجاوز --workdir (أو CLAWHUB_WORKDIR). يقوم OpenClaw بتحميل مهارات مساحة العمل من <workspace>/skills وسيلتقطها في الجلسة التالية. إذا كنت تستخدم بالفعل ~/.openclaw/skills أو مهارات مجمعة، فإن مهارات مساحة العمل لها الأولوية. لمزيد من التفاصيل حول كيفية تحميل المهارات ومشاركتها وتقييدها، راجع المهارات.

نظرة عامة على نظام المهارات

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

  • ملف SKILL.md يحتوي على الوصف الأساسي وطريقة الاستخدام.
  • ملفات تكوين أو نصوص برمجية أو ملفات داعمة اختيارية تستخدمها المهارة.
  • بيانات وصفية مثل العلامات والملخص ومتطلبات التثبيت.

يستخدم ClawHub البيانات الوصفية لتمكين الاكتشاف والتعرض الآمن لقدرات المهارات. كما يتتبع السجل إشارات الاستخدام (مثل النجوم والتنزيلات) لتحسين الترتيب والرؤية.

ما توفره الخدمة (الميزات)

  • التصفح العام للمهارات ومحتوى ملف SKILL.md الخاص بها.
  • بحث مدعوم بالتضمينات (بحث متجهي)، وليس مجرد كلمات رئيسية.
  • الترقيم باستخدام semver، وسجلات التغيير، والعلامات (بما في ذلك latest).
  • التنزيلات كملف مضغوط لكل إصدار.
  • النجوم والتعليقات للتعليقات المجتمعية.
  • خطافات الإشراف للموافقات والمراجعات.
  • واجهة برمجة تطبيقات ملائمة لـ CLI للأتمتة والبرمجة النصية.

الأمان والإشراف

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

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

مهتم بأن تصبح مشرفًا؟ اسأل في خادم OpenClaw Discord وتواصل مع مشرف أو مسؤول.

أوامر CLI والمعلمات

الخيارات العامة (تنطبق على جميع الأوامر):

  • --workdir <dir>: دليل العمل (الافتراضي: الدليل الحالي؛ يتراجع إلى مساحة عمل OpenClaw).
  • --dir <dir>: دليل المهارات، بالنسبة إلى workdir (الافتراضي: skills).
  • --site <url>: عنوان URL الأساسي للموقع (تسجيل الدخول عبر المتصفح).
  • --registry <url>: عنوان URL الأساسي لواجهة برمجة تطبيقات السجل.
  • --no-input: تعطيل المطالبات (غير تفاعلي).
  • -V, --cli-version: طباعة إصدار CLI.

المصادقة:

  • clawhub login (تدفق المتصفح) أو clawhub login --token <token>
  • clawhub logout
  • clawhub whoami

الخيارات:

  • --token <token>: لصق رمز واجهة برمجة التطبيقات.
  • --label <label>: تسمية مخزنة لرموز تسجيل الدخول عبر المتصفح (الافتراضي: CLI token).
  • --no-browser: عدم فتح متصفح (يتطلب --token).

البحث:

  • clawhub search "query"
  • --limit <n>: الحد الأقصى للنتائج.

التثبيت:

  • clawhub install <slug>
  • --version <version>: تثبيت إصدار محدد.
  • --force: الكتابة فوق المجلد إذا كان موجودًا بالفعل.

التحديث:

  • clawhub update <slug>
  • clawhub update --all
  • --version <version>: التحديث إلى إصدار محدد (slug واحد فقط).
  • --force: الكتابة فوق الملفات المحلية عندما لا تتطابق مع أي إصدار منشور.

القائمة:

  • clawhub list (يقرأ .clawhub/lock.json)

النشر:

  • clawhub publish <path>
  • --slug <slug>: معرف المهارة (slug).
  • --name <name>: اسم العرض.
  • --version <version>: إصدار Semver.
  • --changelog <text>: نص سجل التغيير (يمكن أن يكون فارغًا).
  • --tags <tags>: علامات مفصولة بفواصل (الافتراضي: latest).

الحذف/الاسترجاع (للمالك/المسؤول فقط):

  • clawhub delete <slug> --yes
  • clawhub undelete <slug> --yes

المزامنة (فحص المهارات المحلية + نشر الجديد/المحدث):

  • clawhub sync
  • --root <dir...>: جذور فحص إضافية.
  • --all: تحميل كل شيء دون مطالبات.
  • --dry-run: عرض ما سيتم تحميله.
  • --bump <type>: patch|minor|major للتحديثات (الافتراضي: patch).
  • --changelog <text>: سجل التغيير للتحديثات غير التفاعلية.
  • --tags <tags>: علامات مفصولة بفواصل (الافتراضي: latest).
  • --concurrency <n>: فحوصات السجل (الافتراضي: 4).

سير العمل الشائعة للوكلاء

البحث عن المهارات

clawhub search "postgres backups"

تنزيل مهارات جديدة

clawhub install my-skill-pack

تحديث المهارات المثبتة

clawhub update --all

إنشاء نسخة احتياطية لمهاراتك (النشر أو المزامنة)

لمجلد مهارة واحد:

clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

لفحص وإنشاء نسخة احتياطية للعديد من المهارات مرة واحدة:

clawhub sync --all

تفاصيل متقدمة (تقنية)

الترقيم والعلامات

  • كل نشر ينشئ إصدار semver جديدًا SkillVersion.
  • تشير العلامات (مثل latest) إلى إصدار؛ تسمح لك العلامات المتحركة بالتراجع.
  • يتم إرفاق سجلات التغيير لكل إصدار ويمكن أن تكون فارغة عند المزامنة أو نشر التحديثات.

التغييرات المحلية مقابل إصدارات السجل

تقارن التحديثات محتويات المهارة المحلية بإصدارات السجل باستخدام تجزئة المحتوى. إذا كانت الملفات المحلية لا تتطابق مع أي إصدار منشور، يطلب CLI قبل الكتابة فوقها (أو يتطلب --force في عمليات التشغيل غير التفاعلية).

فحص المزامنة وجذور التراجع

clawhub sync يفحص دليل العمل الحالي أولاً. إذا لم يتم العثور على مهارات، فإنه يتراجع إلى المواقع القديمة المعروفة (على سبيل المثال ~/openclaw/skills و ~/.openclaw/skills). تم تصميم هذا للعثور على تثبيتات المهارات القديمة دون أعلام إضافية.

التخزين وملف القفل

  • يتم تسجيل المهارات المثبتة في .clawhub/lock.json ضمن دليل العمل الخاص بك.
  • يتم تخزين رموز المصادقة في ملف تكوين ClawHub CLI (يمكن تجاوزه عبر CLAWHUB_CONFIG_PATH).

القياس عن بعد (أعداد التثبيت)

عند تشغيل clawhub sync أثناء تسجيل الدخول، يرسل CLI لقطة مصغرة لحساب أعداد التثبيت. يمكنك تعطيل هذا تمامًا:

export CLAWHUB_DISABLE_TELEMETRY=1

متغيرات البيئة

  • CLAWHUB_SITE: تجاوز عنوان URL للموقع.
  • CLAWHUB_REGISTRY: تجاوز عنوان URL لواجهة برمجة تطبيقات السجل.
  • CLAWHUB_CONFIG_PATH: تجاوز مكان تخزين CLI للرمز/التكوين.
  • CLAWHUB_WORKDIR: تجاوز دليل العمل الافتراضي.
  • CLAWHUB_DISABLE_TELEMETRY=1: تعطيل القياس عن بعد عند sync.

تكوين المهاراتالإضافات