شروع سریع

ClawHub یک رجیستری برای Skills و Pluginهای OpenClaw است.

هنگام نصب موارد در OpenClaw، از OpenClaw استفاده کنید. هنگامی که وارد حساب می‌شوید، محتوا منتشر می‌کنید، فهرست‌های خود را مدیریت می‌کنید یا از گردش‌کارهای ویژهٔ رجیستری استفاده می‌کنید، از CLI ‏clawhub استفاده کنید.

یافتن و نصب یک Skill

از طریق OpenClaw جست‌وجو کنید:

openclaw skills search "calendar"

یک Skill نصب کنید:

openclaw skills install @openclaw/demo

Skills نصب‌شده را به‌روزرسانی کنید:

openclaw skills update --all

OpenClaw مبدأ Skill را ثبت می‌کند تا به‌روزرسانی‌های بعدی همچنان بتوانند از طریق ClawHub آن را پیدا کنند.

یافتن و نصب یک Plugin

از طریق OpenClaw جست‌وجو کنید:

openclaw plugins search "calendar"

یک Plugin میزبانی‌شده در ClawHub را با مبدأ صریح ClawHub نصب کنید:

openclaw plugins install clawhub:<package>

Pluginهای نصب‌شده را به‌روزرسانی کنید:

openclaw plugins update --all

هنگامی که می‌خواهید OpenClaw بسته را به‌جای npm یا مبدأیی دیگر از طریق ClawHub پیدا کند، از پیشوند clawhub: استفاده کنید.

ورود به حساب برای انتشار

CLI ‏ClawHub را نصب کنید:

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

با GitHub وارد حساب شوید:

clawhub loginclawhub whoami

محیط‌های بدون رابط گرافیکی می‌توانند از یک توکن API متعلق به رابط وب ClawHub استفاده کنند:

clawhub login --token clh_...

انتشار یک Skill

یک Skill پوشه‌ای با فایل الزامی SKILL.md و فایل‌های پشتیبان اختیاری است.

clawhub skill publish ./my-skill \  --slug my-skill \  --name "My Skill" \  --changelog "Initial release"

این فرمان از محتوای بدون تغییر صرف‌نظر می‌کند. Skills جدید از 1.0.0 آغاز می‌شوند؛ تغییرات بعدی به‌طور خودکار نسخهٔ وصله‌ای بعدی را منتشر می‌کنند. برای پیش‌نمایش از --dry-run یا برای انتخاب یک نسخهٔ صریح از --version استفاده کنید.

پیش از انتشار، فرادادهٔ موجود در SKILL.md را بررسی کنید. متغیرهای محیطی، ابزارها و مجوزهای لازم را اعلام کنید تا کاربران پیش از نصب Skill بدانند به چه مواردی نیاز دارد. به قالب Skill مراجعه کنید.

برای مخزن‌هایی که چند Skill دارند، گردش‌کار قابل‌استفادهٔ مجدد GitHub برای هر پوشهٔ مستقیم Skill در skills/، ‏skill publish را فراخوانی می‌کند:

jobs:  preview:    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@main    with:      dry_run: true

انتشار یک Plugin

یک Plugin را از پوشه‌ای محلی، مخزن GitHub، ارجاع GitHub یا یک بایگانی موجود منتشر کنید:

clawhub package publish <source> --family code-plugin --dry-runclawhub package publish <source> --family code-plugin

ابتدا از --dry-run استفاده کنید تا بدون انتشار، پیش‌نمایشی از فرادادهٔ بستهٔ پیداشده، فیلدهای سازگاری، انتساب مبدأ و برنامهٔ بارگذاری مشاهده کنید.

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

بررسی پیش از نصب

پیش از نصب، با استفاده از صفحهٔ وب ClawHub یا فرمان‌های جزئیات CLI، فراداده، پیوندهای مبدأ، نسخه‌ها، گزارش‌های تغییرات و وضعیت اسکن را بررسی کنید:

clawhub inspect @openclaw/democlawhub package inspect <package>

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