> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ClawHub

# ClawHub

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

الموقع: [clawhub.ai](https://clawhub.ai)

## ما هو ClawHub

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

## كيف يعمل

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

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

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

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

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

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

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

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

## تثبيت CLI

اختر أحد الخيارين:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm i -g clawhub
```

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm add -g clawhub
```

## كيف يندمج مع OpenClaw

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

لمزيد من التفاصيل حول كيفية تحميل Skills ومشاركتها وتقييدها، راجع
[Skills](/tools/skills).

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

الـ Skill هي حزمة ملفات مُدارة بالإصدارات تُعلّم OpenClaw كيفية تنفيذ
مهمة محددة. كل عملية نشر تُنشئ إصدارًا جديدًا، ويحتفظ السجل بتاريخ
الإصدارات لكي يتمكن المستخدمون من تدقيق التغييرات.

تتضمن الـ Skill النموذجية ما يلي:

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

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

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

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

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

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

الإبلاغ والإشراف:

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

هل ترغب في أن تصبح مشرفاً؟ هل ترغب في أن تصبح مشرفاً؟ هل أنت مهتم بأن تصبح مشرفًا؟ اسأل في Discord الخاص بـ OpenClaw وتواصل مع
مشرف أو أحد القائمين على الصيانة.

## أوامر 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`

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

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

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

### البحث عن Skills

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub search "postgres backups"
```

### تنزيل Skills جديدة

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub install my-skill-pack
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub update --all
```

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

لمجلد Skill واحد:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
```

لفحص ونسخ احتياطي لعدة Skills دفعة واحدة:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub sync --all
```

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

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

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

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

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

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

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

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

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export CLAWHUB_DISABLE_TELEMETRY=1
```

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

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