ClawHub: الدليل الشامل لسجل المهارات العام لوكلاء الذكاء الاصطناعي
أدى صعود وكلاء الذكاء الاصطناعي المستقلين إلى تحدٍّ جديد: كيف يمكنك مشاركة واكتشاف وإدارة القدرات التي يمكن لهذه الوكلاء استخدامها؟ كما أحدث npm ثورة في إدارة حزم JavaScript وكما وحّد Docker Hub توزيع الحاويات، يبرز ClawHub كسجل المهارات الأساسي لمنظومة وكلاء الذكاء الاصطناعي.
تم بناؤه كسوق رسمي لـ OpenClaw — منصة وكلاء الذكاء الاصطناعي مفتوحة المصدر والمستضافة ذاتياً — يتيح ClawHub للمطورين نشر وتنسيق إصدارات والبحث عن وتثبيت مهارات الوكلاء النصية من خلال واجهة ويب أنيقة وأداة سطر أوامر (CLI) قوية. مع أكثر من 5,200 نجمة على GitHub و832 فورك و72 مساهماً، أصبح بسرعة أكبر سجل مهارات مدفوع من المجتمع في عالم الوكلاء.
في هذا الدليل الشامل، سنستكشف كل ما تحتاج لمعرفته حول ClawHub: بنيته المعمارية، وسير عمل CLI، واعتبارات الأمان، وتنسيق SKILL.md، وكيف يقارن بالسجلات البديلة.
ما هو ClawHub؟
ClawHub هو دليل المهارات العام لـ Clawdbot (وكيل الذكاء الاصطناعي في قلب OpenClaw). "المهارة" في هذا السياق هي ملف SKILL.md مع ملفات نصية داعمة اختيارية تحدد ما يمكن للوكيل فعله — من البحث على الويب وإدارة مستودعات Git إلى أتمتة البريد الإلكتروني والتحكم في أجهزة إنترنت الأشياء.
فكر في الأمر بهذه الطريقة:
| التشبيه | مدير الحزم | السجل |
|---|---|---|
| JavaScript | npm CLI | npmjs.com |
| Python | pip | PyPI |
| الحاويات | docker CLI | Docker Hub |
| مهارات IA | clawhub CLI | clawhub.ai |
السجل متاح على clawhub.ai ويوفر:
- تصفح وعرض ملفات SKILL.md مع دعم كامل لـ Markdown
- بحث دلالي متجهي مدعوم بتضمينات OpenAI (
text-embedding-3-small)، للبحث بلغة طبيعية بدلاً من الكلمات المفتاحية الدقيقة - تنسيق الإصدارات مع سجلات التغيير، semver، والعلامات (بما في ذلك
latest) - النجوم والتعليقات للتنسيق المجتمعي
- أدوات الإشراف للمسؤولين والمشرفين للموافقة على المهارات أو إخفائها أو حظرها
- سجل SOUL.md عبر onlycrabs.ai — سجل شقيق لـ "لور النظام" الذي يحدد كيف يتصرف الوكيل
إحصائيات المشروع الرئيسية
| المقياس | القيمة |
|---|---|
| نجوم GitHub | +5,200 |
| الفوركات | 832 |
| المساهمون | 72 |
| اللغة | TypeScript |
| الترخيص | MIT |
| تاريخ الإنشاء | يناير 2026 |
| آخر تحديث | مارس 2026 |
البنية المعمارية والتقنيات المستخدمة
يعتمد ClawHub على بنية TypeScript متكاملة حديثة:
تطبيق الويب
- الإطار: TanStack Start (React + Vite/Nitro)
- العرض: SSR مع Vite للتطوير وNitro للإنتاج
الخادم الخلفي
- قاعدة البيانات والتخزين: Convex — خادم خلفي تفاعلي يدير قاعدة البيانات وتخزين الملفات وأعمال HTTP
- المصادقة: Convex Auth مع GitHub OAuth
- البحث: تضمينات OpenAI (
text-embedding-3-small) + بحث متجهي من Convex
هيكل المستودع
src/ → تطبيق TanStack Start (المسارات، المكونات، الأنماط)
convex/ → المخطط، الاستعلامات، التحولات، الأعمال، مسارات API
packages/schema/ → أنواع API مشتركة لـ CLI والتطبيق
docs/ → توثيق المشروع
تنسيق SKILL.md
في قلب ClawHub يوجد ملف SKILL.md — مستند Markdown مع بيانات YAML الأمامية:
---
name: مهارتي
description: تفعل شيئاً ما باستخدام API.
metadata:
openclaw:
requires:
env:
- MY_API_KEY
bins:
- curl
primaryEnv: MY_API_KEY
---
# مهارتي
التعليمات للوكيل هنا...
حقول البيانات الأمامية
| الحقل | الغرض |
|---|---|
name | اسم المهارة القابل للقراءة |
description | ملخص موجز للوظائف |
metadata.openclaw.requires.env | متغيرات البيئة المطلوبة |
metadata.openclaw.requires.bins | الملفات التنفيذية المطلوبة |
metadata.openclaw.primaryEnv | مفتاح API الرئيسي |
يحتوي جسم SKILL.md على تعليمات بلغة طبيعية يمكن لأي وكيل مدعوم بنموذج لغوي كبير تفسيرها. المهارات هي في الأساس مستندات هندسة الأوامر.
دعم إضافات Nix
للمهارات المعقدة التي تجمع ثنائيات CLI مع تعليماتها، يدعم ClawHub مؤشرات إضافات Nix:
---
name: peekaboo
description: التقاط وأتمتة واجهة macOS مع CLI Peekaboo.
metadata:
clawdbot:
nix:
plugin: "github:clawdbot/nix-steipete-tools?dir=tools/peekaboo"
systems: ["aarch64-darwin"]
---
تحليل الأمان
يقوم الخادم الخلفي لـ ClawHub بـ تحليل أمني للبيانات الوصفية للمهارات، للتحقق من تطابق متطلبات التشغيل المعلنة مع السلوك الفعلي للمهارة.
CLI: المرجع الكامل للأوامر
المصادقة
# تسجيل الدخول عبر المتصفح
clawhub login
# تسجيل دخول بدون واجهة مع رمز
clawhub login --token clh_...
# التحقق من هويتك
clawhub whoami
الاكتشاف
# بحث دلالي بلغة طبيعية
clawhub search "إدارة التقويم"
# تصفح أحدث المهارات
clawhub explore
clawhub explore --sort trending --limit 50
# فحص مهارة بدون تثبيتها
clawhub inspect مهارتي
clawhub inspect مهارتي --versions
clawhub inspect مهارتي --files
يدعم أمر explore أوضاع فرز متعددة: newest، downloads، rating، installs، installsAllTime، وtrending.
التثبيت والإدارة
# تثبيت أحدث إصدار
clawhub install مهارتي
# التثبيت في مجلد مخصص
clawhub install مهارتي --workdir /tmp/demo --dir skills
# قائمة المهارات المثبتة
clawhub list
# تحديث جميع المهارات
clawhub update --all
# إلغاء التثبيت (حذف محلي فقط)
clawhub uninstall مهارتي
النشر
# نشر إصدار جديد من مهارة
clawhub publish ./مهارتي \
--slug مهارتي-الفريدة \
--name "مهارتي" \
--version 1.0.0 \
--tags latest \
--changelog "الإصدار الأول"
مهم: نشر مهارة يعني توزيعها تحت ترخيص MIT-0 على ClawHub. المهارات المنشورة مجانية للاستخدام والتعديل وإعادة التوزيع بدون نسب.
المزامنة (نشر دفعي)
# مسح ونشر المهارات الجديدة/المعدلة
clawhub sync
# معاينة فقط
clawhub sync --all --dry-run --no-input
# التحكم في التزامن والإصدارات
clawhub sync --bump minor --concurrency 8
الإشراف
# حذف ناعم لمهارة
clawhub delete مهارتي
# استعادة مهارة محذوفة
clawhub undelete مهارتي
# نقل الملكية
clawhub transfer request مهارتي المستخدم-الهدف
# حظر مستخدم (مسؤول فقط)
clawhub ban-user مستخدم-خبيث --reason "توزيع برمجيات ضارة"
البدء السريع: إعداد التطوير المحلي
يتطلب إعداد بيئة تطوير محلية لـ ClawHub Bun:
الخطوة 1: الاستنساخ والتثبيت
git clone https://github.com/openclaw/clawhub.git
cd clawhub
bun install
الخطوة 2: تكوين البيئة
cp .env.local.example .env.local
المتغيرات المطلوبة:
| المتغير | الغرض |
|---|---|
VITE_CONVEX_URL | رابط نشر Convex |
AUTH_GITHUB_ID | معرف تطبيق OAuth GitHub |
AUTH_GITHUB_SECRET | سر تطبيق OAuth GitHub |
OPENAI_API_KEY | للتضمينات والبحث |
الخطوة 3: بدء الخوادم
# الطرفية أ: خادم Convex المحلي
bunx convex dev
# الطرفية ب: تطبيق الويب (المنفذ 3000)
bun run dev
للتعليمات المفصلة، راجع CONTRIBUTING.md.
الأمان: فهم المخاطر والتخفيفات
الأمان هو الموضوع الأكثر نقاشاً في منظومة ClawHub. لأن المهارات هي تعليمات قابلة للتنفيذ تعمل بصلاحيات الوكيل، يمكن لمهارة خبيثة الوصول إلى ملفات حساسة وموارد النظام.
المخاطر المعروفة
- هجمات سلسلة التوريد: تم الإبلاغ عن مهارات خبيثة تحتوي أوامر مشفرة بـ base64 أو تعليمات تحميل برمجيات ضارة
- الاختراق المفوض: المهارات تعمل بنفس صلاحيات الوكيل
- الهندسة الاجتماعية: عدد التحميلات المرتفع لا يضمن الأمان
التخفيفات
- تكامل VirusTotal: جميع المهارات المنشورة تُحلَّل بمنصة استخبارات التهديدات من VirusTotal
- التحقق من البيانات الوصفية: تحليل الأمان يتحقق من اتساق إعلانات التشغيل
- الإشراف: يمكن للمسؤولين إخفاء أو حذف المهارات المشكوك فيها بسرعة
- التحكم في القياسات: قابل للتعطيل عبر
CLAWHUB_DISABLE_TELEMETRY=1
أفضل الممارسات
| الممارسة | التفاصيل |
|---|---|
| قراءة SKILL.md | فحص ملف المهارة دائماً قبل التثبيت |
| البحث عن العلامات الحمراء | محتوى base64، تحميلات خارجية مفرطة |
| بيئات معزولة | تشغيل المهارات غير الموثوقة في بيئات sandbox |
| تثبيت الإصدارات | استخدام --version بدلاً من جلب latest دائماً |
حالات الاستخدام الواقعية
سير عمل التطوير
مهارات لإدارة المستودعات وطلبات السحب والمشاكل وأنابيب CI/CD — تحويل الوكيل إلى مساعد برمجة كامل.
الإنتاجية والتواصل
مهارات لإنشاء صناديق بريد للوكلاء ومولدات إحاطات يومية وقدرات بحث في الذاكرة.
البحث على الويب
مهارات بحث ويب مدمجة مع قدرة الوكيل على التوليف للتحليل التنافسي وأبحاث السوق.
إنترنت الأشياء والأتمتة
إضافات Nix مثل "peekaboo" (أتمتة واجهة macOS) و"padel" (إدارة حجز الملاعب).
ClawHub مقابل البدائل
هذه مقارنة تركز على سجلات المهارات لوكلاء الذكاء الاصطناعي:
| الميزة | ClawHub | awesome-agent-skills | Agent Skills Directory | Agent Skills Open Standard |
|---|---|---|---|---|
| نجوم GitHub | +5,200 | +2,850 | 7 | غير متاح (مواصفة) |
| النوع | سجل كامل + CLI | قائمة awesome منسقة | أداة اكتشاف | مواصفة مفتوحة |
| بحث دلالي | ✅ تضمينات متجهية | ❌ Markdown ثابت | ✅ توصيات ذكية | ❌ غير متاح |
| CLI | ✅ تثبيت/نشر كامل | ❌ لا يوجد | ❌ لا يوجد | غير متاح |
| إصدارات | ✅ Semver + علامات | ❌ عمليات Git فقط | ❌ لا يوجد | ❌ غير متاح |
| فحص أمني | ✅ VirusTotal | ❌ مراجعة يدوية | ✅ فحص مدمج | ❌ غير متاح |
| دعم متعدد الوكلاء | OpenClaw/Clawdbot | Claude, Codex, Copilot | 41 مستودع مزود | جميع الوكلاء المتوافقين |
متى تختار كل خيار
- ClawHub: الأفضل لمستخدمي OpenClaw/Clawdbot الراغبين في تجربة إدارة حزم كاملة
- awesome-agent-skills: الأفضل لـ الاكتشاف عبر المنصات (Claude Code, Codex, Copilot)
- Agent Skills Directory: الأفضل لـ الاكتشاف الموجه للجودة مع فحص أمني مدمج
- Agent Skills Open Standard: الأفضل لـ قابلية التشغيل البيني بين المنصات
الأسئلة الشائعة
هل يمنح تثبيت مهارة حق الوصول إلى نظامي بالكامل؟
نعم — المهارات تعمل بنفس صلاحيات الوكيل. افحص دائماً SKILL.md قبل التثبيت واستخدم بيئات sandbox للمهارات غير الموثوقة.
هل يمكنني استخدام مهارات ClawHub بدون OpenClaw؟
ClawHub مصمم كسجل لمنظومة OpenClaw/Clawdbot. بينما تنسيق SKILL.md قابل للتفسير من أي وكيل، البنية التحتية لـ CLI والسجل مدمجة بإحكام مع OpenClaw.
كيف يعمل البحث الدلالي؟
يستخدم ClawHub نموذج text-embedding-3-small من OpenAI لتوليد تضمينات متجهية. استعلامك يُحوَّل أيضاً إلى تضمين، ويجد البحث المتجهي من Convex أقرب التطابقات — يمكنك البحث بلغة طبيعية مثل "إدارة تقويمي".
ماذا يحدث عندما أحذف مهارة؟
clawhub delete يقوم بـ حذف ناعم — المهارة تُخفى لكن لا تُحذف نهائياً. يمكن للمالكين والمشرفين والمسؤولين استعادتها بـ clawhub undelete.
ما الفرق بين Skills وSouls؟
المهارات (Skills) تحدد ما يمكن للوكيل فعله. الأرواح (Souls) تحدد كيف يتصرف الوكيل (الشخصية، أسلوب التواصل، الحواجز). المهارات على ClawHub؛ الأرواح على onlycrabs.ai.
هل يمكنني تشغيل ClawHub محلياً؟
نعم! المشروع مفتوح المصدر بالكامل. تحتاج إلى Bun ونشر Convex وتطبيق OAuth GitHub ومفتاح API OpenAI. راجع دليل البدء السريع.
الخلاصة
يمثل ClawHub قطعة بنية تحتية حيوية لمنظومة وكلاء الذكاء الاصطناعي. مع بحثه المتجهي الدلالي وCLI الشامل وأنظمة الإصدارات والإشراف ومجتمعه المتنامي من أكثر من 5,200 متابع، رسّخ ClawHub مكانته كسجل المهارات الرائد في هذا المجال.
سواء كنت تبني مهارات لوكيلك الخاص، أو تنشر أدوات للمجتمع، أو تستكشف ببساطة ما هو ممكن مع قدرات وكلاء الذكاء الاصطناعي، يوفر ClawHub البنية التحتية اللازمة.