Skills
ClawHub
ClawHub رجیستری عمومی برای Skills و Pluginهای OpenClaw است.
- از فرمانهای بومی
openclawبرای جستوجو، نصب، و بهروزرسانی Skills و نصب Pluginها از ClawHub استفاده کنید. - از CLI جداگانه
clawhubبرای جریانهای کاری احراز هویت رجیستری، انتشار، حذف/بازگردانی حذف، و همگامسازی استفاده کنید.
سایت: clawhub.ai
شروع سریع
جستوجو
openclaw skills search "calendar"
نصب
openclaw skills install <skill-slug>
استفاده
یک نشست جدید OpenClaw را شروع کنید - Skill جدید را شناسایی میکند.
انتشار (اختیاری)
برای جریانهای کاری احراز هویتشده در رجیستری (انتشار، همگامسازی، مدیریت)،
CLI جداگانه clawhub را نصب کنید:
npm i -g clawhub
# or
pnpm add -g clawhub
جریانهای بومی OpenClaw
Skills
openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all
فرمانهای بومی openclaw در فضای کاری فعال شما نصب میکنند و
فراداده منبع را نگه میدارند تا فراخوانیهای بعدی update بتوانند روی ClawHub بمانند.
Pluginها
openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all
plugins search کاتالوگ Pluginهای ClawHub را پرسوجو میکند و نامهای
بسته آماده نصب را چاپ میکند. وقتی وضوحدهی ClawHub را میخواهید از
clawhub:<package> استفاده کنید. مشخصههای Plugin سازگار با npm بدون
پیشوند در زمان گذار راهاندازی از npm نصب میشوند:
openclaw plugins install openclaw-codex-app-server
npm:<package> نیز فقط مخصوص npm است و زمانی مفید است که یک مشخصه در غیر این صورت
میتواند مبهم باشد:
openclaw plugins install npm:openclaw-codex-app-server
نصبهای Plugin سازگاری pluginApi و minGatewayVersion اعلامشده را
پیش از اجرای نصب آرشیو اعتبارسنجی میکنند، بنابراین میزبانهای ناسازگار
بهجای نصب ناقص بسته، زودتر بهصورت بسته شکست میخورند. وقتی یک نسخه بسته
آرتیفکت ClawPack منتشر میکند، OpenClaw بسته npm بارگذاریشده دقیق .tgz
را ترجیح میدهد، سرآیند digest در ClawHub و بایتهای دانلودشده را
راستیآزمایی میکند، و نوع آرتیفکت، integrity در npm، shasum در npm،
نام tarball، و فراداده digest در ClawPack را برای بهروزرسانیهای بعدی
ثبت میکند. نسخههای قدیمیتر بسته بدون فراداده ClawPack همچنان از مسیر
قدیمی راستیآزمایی آرشیو بسته استفاده میکنند.
ClawHub چیست
- یک رجیستری عمومی برای Skills و Pluginهای OpenClaw.
- یک مخزن نسخهبندیشده برای بستههای Skill و فراداده.
- یک سطح کشف برای جستوجو، برچسبها، و سیگنالهای استفاده.
یک Skill معمولی یک بسته نسخهبندیشده از فایلها است که شامل موارد زیر است:
- یک فایل
SKILL.mdبا توضیح اصلی و نحوه استفاده. - پیکربندیها، اسکریپتها، یا فایلهای پشتیبان اختیاری که Skill از آنها استفاده میکند.
- فرادادهای مانند برچسبها، خلاصه، و نیازمندیهای نصب.
ClawHub از فراداده برای تقویت کشف و نمایش امن قابلیتهای Skill استفاده میکند. رجیستری سیگنالهای استفاده (ستارهها، دانلودها) را دنبال میکند تا رتبهبندی و دیدهشدن را بهبود دهد. هر انتشار یک نسخه semver جدید ایجاد میکند، و رجیستری تاریخچه نسخهها را نگه میدارد تا کاربران بتوانند تغییرات را ممیزی کنند.
فضای کاری و بارگذاری Skill
CLI جداگانه clawhub نیز Skills را در ./skills زیر دایرکتوری کاری فعلی
شما نصب میکند. اگر یک فضای کاری OpenClaw پیکربندی شده باشد، clawhub
به آن فضای کاری برمیگردد مگر اینکه --workdir (یا CLAWHUB_WORKDIR) را
بازنویسی کنید. OpenClaw، Skills فضای کاری را از <workspace>/skills بارگذاری
میکند و آنها را در نشست بعدی شناسایی میکند.
اگر از قبل از ~/.openclaw/skills یا Skills همراه استفاده میکنید، Skills
فضای کاری اولویت دارند. برای جزئیات بیشتر درباره اینکه Skills چگونه بارگذاری،
همرسانی، و کنترل میشوند، Skills را ببینید.
ویژگیهای سرویس
| ویژگی | یادداشتها |
|---|---|
| مرور عمومی | Skills و محتوای SKILL.md آنها بهصورت عمومی قابل مشاهده هستند. |
| جستوجو | مبتنی بر embedding (جستوجوی برداری)، نه فقط کلیدواژهها. |
| نسخهبندی | Semver، changelogها، و برچسبها (از جمله latest). |
| دانلودها | Zip برای هر نسخه. |
| ستارهها و دیدگاهها | بازخورد جامعه. |
| خلاصههای اسکن امنیتی | صفحههای جزئیات آخرین وضعیت اسکن را پیش از نصب یا دانلود نشان میدهند. |
| صفحههای جزئیات اسکنر | نتایج VirusTotal، ClawScan، و تحلیل ایستا پیوندهای عمیق دارند. |
| داشبورد بازیابی مالک | ناشران میتوانند محتوای متعلق به خود را که بهخاطر اسکن نگه داشته شده از /dashboard ببینند. |
| اسکنهای مجدد درخواستی مالک | مالکان میتوانند برای بازیابی موارد مثبت کاذب، اسکن مجدد محدود درخواست کنند. |
| نظارت | تأییدها و ممیزیها. |
| API مناسب CLI | مناسب برای خودکارسازی و اسکریپتنویسی. |
امنیت و نظارت
ClawHub بهصورت پیشفرض باز است - هر کسی میتواند Skills بارگذاری کند، اما برای انتشار، حساب GitHub باید حداقل یک هفته عمر داشته باشد. این کار بدون مسدودکردن مشارکتکنندگان معتبر، سوءاستفاده را کند میکند.
اسکنهای امنیتی
ClawHub بررسیهای امنیتی خودکار را روی Skills و انتشارهای Plugin منتشرشده اجرا میکند. صفحههای جزئیات عمومی نتیجه فعلی را خلاصه میکنند، و ردیفهای اسکنر به صفحههای جزئیات اختصاصی برای VirusTotal، ClawScan، و تحلیل ایستا پیوند میدهند.
انتشارهایی که بهخاطر اسکن نگه داشته شده یا مسدود شدهاند ممکن است روی کاتالوگ عمومی
و سطحهای نصب در دسترس نباشند، در حالی که همچنان برای مالکشان در /dashboard
قابل مشاهدهاند.
گزارشدهی
- هر کاربر واردشده میتواند یک Skill را گزارش کند.
- دلیلهای گزارش الزامی و ثبت میشوند.
- هر کاربر میتواند همزمان تا 20 گزارش فعال داشته باشد.
- Skills با بیش از 3 گزارش یکتای پیشفرض بهصورت خودکار پنهان میشوند.
نظارت
- ناظران میتوانند Skills پنهان را ببینند، آنها را از حالت پنهان خارج کنند، حذف کنند، یا کاربران را مسدود کنند.
- سوءاستفاده از قابلیت گزارش میتواند به مسدودشدن حساب منجر شود.
- علاقهمند به ناظر شدن هستید؟ در Discord مربوط به OpenClaw بپرسید و با یک ناظر یا نگهدارنده تماس بگیرید.
CLI ClawHub
فقط برای جریانهای کاری احراز هویتشده در رجیستری مانند انتشار/همگامسازی به این نیاز دارید.
گزینههای سراسری
"--workdir"--dir"--site"--registry--no-inputbooleanاعلانها را غیرفعال میکند (غیرتعاملی).
-V, --cli-versionbooleanنسخه CLI را چاپ میکند.
فرمانها
احراز هویت (ورود / خروج / whoami)
clawhub login # browser flow
clawhub login --token <token>
clawhub logout
clawhub whoami
گزینههای ورود:
--token <token>- یک توکن API را جایگذاری کنید.--label <label>- برچسب ذخیرهشده برای توکنهای ورود از مرورگر (پیشفرض:CLI token).--no-browser- مرورگر باز نکنید (به--tokenنیاز دارد).
جستوجو
clawhub search "query"
Skills را جستوجو میکند. برای کشف Plugin/بسته، از clawhub package explore استفاده کنید.
--limit <n>- بیشینه نتایج.
مرور / بازرسی Pluginها
clawhub package explore --family code-plugin
clawhub package explore "episodic-claw" --family code-plugin
clawhub package inspect episodic-claw
package explore و package inspect سطحهای CLI ClawHub برای کشف Plugin/بسته و بازرسی فراداده هستند. نصبهای بومی OpenClaw همچنان از openclaw plugins install clawhub:<package> استفاده میکنند.
گزینهها:
--family skill|code-plugin|bundle-plugin- خانواده بسته را فیلتر میکند.--official- فقط بستههای رسمی را نشان میدهد.--executes-code- فقط بستههایی را نشان میدهد که کد اجرا میکنند.--version <version>/--tag <tag>- یک نسخه مشخص بسته را بازرسی میکند.--versions،--files،--file <path>- تاریخچه و فایلهای بسته را بازرسی میکند.--json- خروجی قابل خواندن برای ماشین.
نصب / بهروزرسانی / فهرست
clawhub install <slug>
clawhub update <slug>
clawhub update --all
clawhub list
گزینهها:
--version <version>- نصب یا بهروزرسانی به یک نسخه مشخص (درupdateفقط برای یک slug).--force- اگر پوشه از قبل وجود دارد، یا وقتی فایلهای محلی با هیچ نسخه منتشرشدهای مطابقت ندارند، بازنویسی میکند.clawhub listفایل.clawhub/lock.jsonرا میخواند.
انتشار Skills
clawhub skill publish <path>
گزینهها:
--slug <slug>- slug مربوط به Skill.--name <name>- نام نمایشی.--version <version>- نسخه semver.--changelog <text>- متن changelog (میتواند خالی باشد).--tags <tags>- برچسبهای جداشده با ویرگول (پیشفرض:latest).
انتشار Pluginها
clawhub package publish <source>
<source> میتواند یک پوشه محلی، owner/repo، owner/repo@ref، یا یک
URL مربوط به GitHub باشد.
گزینهها:
--dry-run- برنامه انتشار دقیق را بدون بارگذاری چیزی میسازد.--json- خروجی قابل خواندن برای ماشین را برای CI منتشر میکند.--source-repo،--source-commit،--source-ref- بازنویسیهای اختیاری وقتی تشخیص خودکار کافی نیست.
درخواست اسکن مجدد
clawhub skill rescan <slug>
clawhub skill rescan <slug> --yes --json
clawhub package rescan <name>
clawhub package rescan <name> --yes --json
فرمانهای اسکن مجدد به توکن مالک واردشده نیاز دارند و آخرین نسخه
Skill منتشرشده یا انتشار Plugin را هدف میگیرند. در اجراهای غیرتعاملی،
--yes را ارسال کنید.
پاسخهای JSON شامل نوع هدف، نام، نسخه، وضعیت اسکن مجدد، و شمار درخواستهای باقیمانده/بیشینه برای آن نسخه یا انتشار هستند.
حذف / بازگردانی حذف (مالک یا مدیر)
clawhub delete <slug> --yes
clawhub undelete <slug> --yes
همگامسازی (اسکن محلی + انتشار جدید یا بهروزشده)
clawhub sync
گزینهها:
--root <dir...>- ریشههای اسکن اضافی.--all- همه چیز را بدون اعلان بارگذاری میکند.--dry-run- نشان میدهد چه چیزی بارگذاری خواهد شد.--bump <type>-patch|minor|majorبرای بهروزرسانیها (پیشفرض:patch).--changelog <text>- changelog برای بهروزرسانیهای غیرتعاملی.--tags <tags>- برچسبهای جداشده با ویرگول (پیشفرض:latest).--concurrency <n>- بررسیهای رجیستری (پیشفرض:4).
جریانهای کاری رایج
جستوجو
clawhub search "postgres backups"
یافتن یک plugin
clawhub package explore --family code-plugin
clawhub package explore "memory" --family code-plugin
clawhub package inspect episodic-claw
نصب
clawhub install my-skill-pack
بهروزرسانی همه
clawhub update --all
انتشار یک skill
clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
همگامسازی تعداد زیادی skill
clawhub sync --all
انتشار یک plugin از GitHub
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]
clawhub package publish https://github.com/your-org/your-plugin
فراداده بسته Plugin
Pluginهای کد باید فراداده الزامی OpenClaw را در
package.json داشته باشند:
{
"name": "@myorg/openclaw-my-plugin",
"version": "1.0.0",
"type": "module",
"openclaw": {
"extensions": ["./src/index.ts"],
"runtimeExtensions": ["./dist/index.js"],
"compat": {
"pluginApi": ">=2026.3.24-beta.2",
"minGatewayVersion": "2026.3.24-beta.2"
},
"build": {
"openclawVersion": "2026.3.24-beta.2",
"pluginSdkVersion": "2026.3.24-beta.2"
}
}
}
بستههای منتشرشده باید JavaScript ساختهشده را همراه داشته باشند و
runtimeExtensions را به آن خروجی اشاره دهند. نصبهای checkout از Git همچنان میتوانند
در صورت نبود فایلهای ساختهشده به منبع TypeScript برگردند، اما ورودیهای runtime ساختهشده
از کامپایل TypeScript در زمان اجرا در مسیرهای startup، doctor و
بارگذاری plugin جلوگیری میکنند.
نسخهبندی، lockfile و تلهمتری
نسخهبندی و برچسبها
- هر انتشار یک
SkillVersionجدید با semver ایجاد میکند. - برچسبها (مانند
latest) به یک نسخه اشاره میکنند؛ جابهجایی برچسبها امکان بازگشت به نسخه قبل را میدهد. - changelogها برای هر نسخه پیوست میشوند و هنگام همگامسازی یا انتشار بهروزرسانیها میتوانند خالی باشند.
تغییرات محلی در برابر نسخههای registry
بهروزرسانیها محتوای skill محلی را با نسخههای registry با استفاده از
hash محتوا مقایسه میکنند. اگر فایلهای محلی با هیچ نسخه منتشرشدهای مطابقت نداشته باشند،
CLI پیش از بازنویسی سؤال میکند (یا در اجراهای
غیرتعاملی به --force نیاز دارد).
پویش همگامسازی و ریشههای جایگزین
clawhub sync ابتدا workdir فعلی شما را پویش میکند. اگر هیچ skillای
پیدا نشود، به مکانهای قدیمی شناختهشده (برای مثال
~/openclaw/skills و ~/.openclaw/skills) برمیگردد. این برای
یافتن نصبهای قدیمیتر skill بدون flagهای اضافی طراحی شده است.
ذخیرهسازی و lockfile
- skillهای نصبشده در
.clawhub/lock.jsonزیر workdir شما ثبت میشوند. - tokenهای احراز هویت در فایل پیکربندی ClawHub CLI ذخیره میشوند (قابل بازنویسی با
CLAWHUB_CONFIG_PATH).
تلهمتری (شمار نصبها)
وقتی در حالت ورودشده clawhub sync را اجرا میکنید، CLI یک snapshot حداقلی
برای محاسبه شمار نصبها ارسال میکند. میتوانید این را کاملاً غیرفعال کنید:
export CLAWHUB_DISABLE_TELEMETRY=1
متغیرهای محیطی
| متغیر | اثر |
|---|---|
CLAWHUB_SITE |
URL سایت را بازنویسی میکند. |
CLAWHUB_REGISTRY |
URL API registry را بازنویسی میکند. |
CLAWHUB_CONFIG_PATH |
محل ذخیره token/پیکربندی توسط CLI را بازنویسی میکند. |
CLAWHUB_WORKDIR |
workdir پیشفرض را بازنویسی میکند. |
CLAWHUB_DISABLE_TELEMETRY=1 |
تلهمتری را در sync غیرفعال میکند. |