​

ClawHub

​

ما هو ClawHub

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

​

كيف يعمل

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

​

ما الذي يمكنك القيام به

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

​

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

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

​

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

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

​

تثبيت CLI

npm i -g clawhub

pnpm add -g clawhub

​

كيف يندمج مع OpenClaw

​

نظرة عامة على نظام Skills

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

​

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

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

​

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

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

​

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

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

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

• --token <token>: لصق رمز API.
• --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>: معرّف Skill (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).

​

تدفقات عمل شائعة للوكلاء

​

البحث عن Skills

clawhub search "postgres backups"

​

تنزيل Skills جديدة

clawhub install my-skill-pack

​

تحديث Skills المثبّتة

clawhub update --all

​

عمل نسخة احتياطية من Skills الخاصة بك (نشر أو مزامنة)

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

clawhub sync --all

​

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

​

الإصدارات والعلامات

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

​

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

​

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

​

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

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

​

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

export CLAWHUB_DISABLE_TELEMETRY=1

​

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

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