عن المشروع

ClawHub هو سجل وتوزيع عام مصمم خصيصًا لـ OpenClaw، وهو إطار عمل وكيل مفتوح المصدر. يخدم كتالوجين رئيسيين: مهارات الوكيل النصية (ملف SKILL.md بالإضافة إلى ملفات داعمة) وحزم OpenClaw الأصلية (إضافات برمجية، حزم مجمعة، وحزم Claw كاملة للوكيل). القدرات الرئيسية: - دورة حياة المهارة: تصفح المهارات وعرض توثيق SKILL.md الخاص بها؛ نشر إصدارات جديدة من المهارات مع سجل التغييرات والوسوم (بما في ذلك وسم `latest` المتحرك)؛ إعادة تسمية المهارات المملوكة دون كسر الروابط أو التثبيتات القديمة؛ دمج المهارات المكررة المملوكة في معرف موحد واحد. - البحث: بحث دلالي مدعوم بتضمينات OpenAI (text-embedding-3-small) بدلاً من مطابقة الكلمات المفتاحية الهشة، مما يجعل المهارات قابلة للاكتشاف بالتشابه الدلالي. - الاجتماعية والحوكمة: إضافة نجوم وتعليقات على المهارات؛ يمكن للمشرفين والمسؤولين تنظيم وإدارة القوائم. تسمح عمليات الحذف الناعم والاستعادة للمالكين وأصحاب الناشرين والمسؤولين والمشرفين بإزالة أو استرداد المهارات دون فقدان دائم للبيانات. الحذف الصلب مقصور على المسؤولين. - إدارة التثبيت المحلي: تثبيت وفحص وسرد وتحديث وإلغاء تثبيت المهارات من سطر الأوامر. تثبيت محلي مثبت بحيث لا يمكن للتحديثات أو إعادة التثبيت القسرية الكتابة فوق النسخ المجمدة. - كتالوج الحزم: تصفح حزم OpenClaw مع بيانات العائلة والثقة والقدرات. نشر إضافات برمجية أصلية وحزم مجمعة عبر واجهات برمجة تطبيقات /packages المخصصة وتدفقات سطر الأوامر. يجب أن تعلن بيانات الإضافات البرمجية عن openclaw.compat.pluginApi و openclaw.build.openclawVersion. - دعم إضافات Nix: يمكن للمهارات الإعلان عن مؤشر إضافة nix-clawdbot في مقدمة SKILL حتى يعرف السجل أي حزمة Nix يجب تثبيتها، بما في ذلك متطلبات التكوين وأدلة الحالة ونص مساعدة سطر الأوامر. - البيانات الوصفية والأمان: تعلن المهارات عن متطلبات التشغيل (متغيرات البيئة، الملفات الثنائية، مواصفات التثبيت) في المقدمة. يتحقق تحليل الأمان في ClawHub من هذه التصريحات مقابل سلوك المهارة الفعلي؛ تبقى نتائج المراجعة المتوسطة مرئية، بينما يُحجز مرشح المشبوه للمخاوف عالية التأثير أو الخبيثة. - تتبع ضئيل: يتم تتبع تتبع التثبيت فقط لحساب أعداد التثبيت ويمكن تعطيله عبر CLAWHUB_DISABLE_TELEMETRY. البنية: تم بناء تطبيق الويب باستخدام TanStack Start (React، Vite/Nitro). يعمل الخلفية على Convex (قاعدة البيانات، تخزين الملفات، وإجراءات HTTP) مع Convex Auth لمصادقة GitHub OAuth. المخطط المشترك ومسارات API موجودة في packages/schema (clawhub-schema) ويتم استهلاكها من قبل كل من سطر الأوامر وتطبيق الويب. تخطيط المستودع: يحتوي src/ على تطبيق TanStack Start؛ يحتوي convex/ على المخطط والاستعلامات والطفرات والإجراءات ومسارات HTTP API؛ يحتوي packages/schema/ على أنواع API المشتركة؛ ينشر docs/ توثيق المستخدم والناشر وعميل API والمشغل؛ يحتوي specs/ على مواصفات المنتج والخطط وتاريخ التصميم.