ClawHub

ClawHub رجیستری عمومی Skills و Pluginهای OpenClaw است.

• از فرمان‌های بومی openclaw برای جست‌وجو، نصب و به‌روزرسانی Skills و نصب Pluginها از ClawHub استفاده کنید.
• برای احراز هویت رجیستری، انتشار و جریان‌های کاری حذف/بازیابی، از CLI جداگانهٔ clawhub استفاده کنید.

سایت: clawhub.ai

شروع سریع

Skills را با OpenClaw جست‌وجو و نصب کنید:

openclaw skills search "calendar"openclaw skills install @openclaw/demoopenclaw skills update --all

Pluginها را با OpenClaw جست‌وجو و نصب کنید:

openclaw plugins search "calendar"openclaw plugins install clawhub:<package>openclaw plugins update --all

هنگامی که به جریان‌های کاری دارای احراز هویت رجیستری، مانند انتشار یا حذف/بازیابی، نیاز دارید، CLI مربوط به ClawHub را نصب کنید:

npm i -g clawhub# یاpnpm add -g clawhub

موارد میزبانی‌شده در ClawHub

ClawHub نسخه‌های semver، برچسب‌هایی مانند latest، گزارش‌های تغییرات، فایل‌ها، دانلودها، ستاره‌ها و خلاصه‌های اسکن امنیتی را ردیابی می‌کند. صفحه‌های عمومی وضعیت فعلی رجیستری را نمایش می‌دهند تا کاربران بتوانند پیش از نصب، یک Skill یا Plugin را بررسی کنند.

جریان‌های بومی OpenClaw

فرمان‌های بومی OpenClaw در فضای کاری فعال OpenClaw نصب می‌کنند و فرادادهٔ منبع را ماندگار می‌سازند تا فرمان‌های به‌روزرسانی بعدی بتوانند همچنان از ClawHub استفاده کنند.

هنگامی که نصب یک Plugin باید از طریق ClawHub رفع شود، از clawhub:<package> استفاده کنید. مشخصات سادهٔ Plugin که برای npm ایمن هستند، ممکن است هنگام انتقال‌های انتشار از طریق npm رفع شوند و هنگامی که منبع باید صریح باشد، npm:<package> فقط مختص npm باقی می‌ماند.

نصب Pluginها پیش از اجرای نصب بایگانی، سازگاری اعلام‌شدهٔ pluginApi و minGatewayVersion را اعتبارسنجی می‌کند. هنگامی که یک نسخهٔ بسته، مصنوع ClawPack را منتشر می‌کند، OpenClaw فایل npm-pack دقیقِ بارگذاری‌شدهٔ .tgz را ترجیح می‌دهد، سرآیند چکیدهٔ ClawHub و بایت‌های دانلودشده را تأیید می‌کند و فرادادهٔ مصنوع را برای به‌روزرسانی‌های بعدی ثبت می‌کند.

CLI مربوط به ClawHub

CLI مربوط به ClawHub برای کارهای دارای احراز هویت رجیستری است:

clawhub loginclawhub whoamiclawhub search "postgres backups"clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0clawhub package explore --family code-pluginclawhub package inspect episodic-clawclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-plugin

این CLI همچنین برای جریان‌های کاری مستقیم رجیستری، فرمان‌های نصب/به‌روزرسانی Skill را دارد:

clawhub install @openclaw/democlawhub update @openclaw/democlawhub update --allclawhub list

این فرمان‌ها Skills را در ./skills زیر شاخهٔ کاری فعلی نصب و نسخه‌های نصب‌شده را در .clawhub/lock.json ثبت می‌کنند.

انتشار

Skills را از یک پوشهٔ محلی حاوی SKILL.md منتشر کنید:

clawhub skill publish <path>

گزینه‌های متداول انتشار:

• --slug <slug>: نام URL مهارت منتشرشده.
• --name <name>: نام نمایشی.
• --version <version>: نسخهٔ semver.
• --changelog <text>: متن گزارش تغییرات.
• --tags <tags>: برچسب‌های جداشده با ویرگول، با مقدار پیش‌فرض latest.

Pluginها را از یک پوشهٔ محلی، owner/repo، owner/repo@ref یا یک URL در GitHub منتشر کنید:

clawhub package publish <source>

برای ساخت طرح دقیق انتشار بدون بارگذاری، از --dry-run و برای خروجی مناسب CI از --json استفاده کنید.

Pluginهای کد باید فرادادهٔ الزامی سازگاری OpenClaw را در package.json، از جمله openclaw.compat.pluginApi و openclaw.build.openclawVersion، داشته باشند. برای مرجع کامل فرمان‌ها، به CLI و برای فرادادهٔ Skill به قالب Skill مراجعه کنید.

امنیت و مدیریت محتوا

ClawHub به‌طور پیش‌فرض باز است: همه می‌توانند بارگذاری کنند، اما انتشار به حساب GitHub با قدمت کافی برای عبور از دروازهٔ بارگذاری نیاز دارد. صفحه‌های عمومی جزئیات، پیش از نصب یا دانلود، آخرین وضعیت اسکن را خلاصه می‌کنند.

ClawHub بررسی‌های خودکار را روی Skills و نسخه‌های Plugin منتشرشده اجرا می‌کند. نسخه‌های نگه‌داشته‌شده برای اسکن یا مسدودشده ممکن است از کاتالوگ عمومی و سطوح نصب ناپدید شوند، درحالی‌که برای مالکشان در /dashboard قابل مشاهده باقی می‌مانند.

کاربران واردشده می‌توانند Skills و بسته‌ها را گزارش کنند. مدیران محتوا می‌توانند گزارش‌ها را بررسی کنند، محتوا را پنهان یا بازیابی کنند و حساب‌های سوءاستفاده‌گر را مسدود کنند. برای جزئیات سیاست‌ها و اعمال آن‌ها، به امنیت، ممیزی‌های امنیتی، مدیریت محتوا و ایمنی حساب و استفادهٔ قابل‌قبول مراجعه کنید.

تله‌متری و محیط

هنگامی که در حالت واردشده clawhub install را اجرا می‌کنید، CLI ممکن است یک رویداد نصب به‌صورت best-effort ارسال کند تا ClawHub بتواند تعداد کل نصب‌ها را محاسبه کند. با دستور زیر آن را غیرفعال کنید:

export CLAWHUB_DISABLE_TELEMETRY=1

بازنویسی‌های محیطی مفید:

برای مطالب مرجع عمیق‌تر، به تله‌متری، HTTP API و عیب‌یابی مراجعه کنید.