CLI commands
Plugins
مدیریت Pluginهای Gateway، بستههای hook، و bundleهای سازگار.
راهنمای کاربر نهایی برای نصب، فعالسازی، و عیبیابی pluginها.
نمونههای سریع برای نصب، فهرستکردن، بهروزرسانی، حذف نصب، و انتشار.
مدل سازگاری bundle.
فیلدهای manifest و schema پیکربندی.
سختسازی امنیتی برای نصب pluginها.
فرمانها
OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --jsonOmeniaClaw plugins search <query>OmeniaClaw plugins search <query> --limit 20OmeniaClaw plugins search <query> --jsonOmeniaClaw plugins install <path-or-spec>OmeniaClaw plugins inspect <id>OmeniaClaw plugins inspect <id> --runtimeOmeniaClaw plugins inspect <id> --jsonOmeniaClaw plugins inspect --allOmeniaClaw plugins info <id>OmeniaClaw plugins enable <id>OmeniaClaw plugins disable <id>OmeniaClaw plugins registryOmeniaClaw plugins registry --refreshOmeniaClaw plugins uninstall <id>OmeniaClaw plugins doctorOmeniaClaw plugins update <id-or-npm-spec>OmeniaClaw plugins update --allOmeniaClaw plugins marketplace list <marketplace>OmeniaClaw plugins marketplace list <marketplace> --jsonبرای بررسی نصب، inspect، حذف نصب، یا تازهسازی registry که کند است، فرمان را با
OmeniaClaw_PLUGIN_LIFECYCLE_TRACE=1 اجرا کنید. trace زمانبندی فازها را در stderr مینویسد
و خروجی JSON را قابل parse نگه میدارد. اشکالزدایی را ببینید.
نصب
OmeniaClaw plugins search "calendar" # search ClawHub pluginsOmeniaClaw plugins install <package> # npm by defaultOmeniaClaw plugins install clawhub:<package> # ClawHub onlyOmeniaClaw plugins install npm:<package> # npm onlyOmeniaClaw plugins install npm-pack:<path.tgz> # local npm pack through npm install semanticsOmeniaClaw plugins install git:github.com/<owner>/<repo> # git repoOmeniaClaw plugins install git:github.com/<owner>/<repo>@<ref>OmeniaClaw plugins install <package> --force # overwrite existing installOmeniaClaw plugins install <package> --pin # pin versionOmeniaClaw plugins install <package> --dangerously-force-unsafe-installOmeniaClaw plugins install <path> # local pathOmeniaClaw plugins install <plugin>@<marketplace> # marketplaceOmeniaClaw plugins install <plugin> --marketplace <name> # marketplace (explicit)OmeniaClaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>نگهدارندگان هنگام آزمودن نصبهای زمان setup میتوانند منابع نصب خودکار plugin را با متغیرهای محیطی محافظتشده override کنند. Overrideهای نصب Plugin را ببینید.
plugins search در ClawHub برای بستههای plugin قابل نصب query میزند و نامهای بستهی آمادهی نصب را چاپ میکند. این فرمان بستههای code-plugin و bundle-plugin را جستوجو میکند، نه Skills را. برای Skills در ClawHub از OmeniaClaw skills search استفاده کنید.
Config includes and invalid-config repair
اگر بخش plugins شما با یک $include تکفایلی پشتیبانی میشود، plugins install/update/enable/disable/uninstall در همان فایل includeشده مینویسند و OmeniaClaw.json را دستنخورده میگذارند. Includeهای root، آرایههای include، و includeهایی با overrideهای همسطح بهجای flatten شدن، بسته و ناموفق میشوند. برای شکلهای پشتیبانیشده، includeهای پیکربندی را ببینید.
اگر پیکربندی هنگام نصب نامعتبر باشد، plugins install معمولاً بسته و ناموفق میشود و به شما میگوید ابتدا OmeniaClaw doctor --fix را اجرا کنید. هنگام راهاندازی Gateway و hot reload، پیکربندی نامعتبر plugin مثل هر پیکربندی نامعتبر دیگری بسته و ناموفق میشود؛ OmeniaClaw doctor --fix میتواند entry نامعتبر plugin را قرنطینه کند. تنها استثنای مستندشده در زمان نصب، مسیر بازیابی محدود برای plugin همراه است، برای pluginهایی که بهصراحت در OmeniaClaw.install.allowInvalidConfigRecovery opt in میکنند.
--force and reinstall vs update
--force هدف نصب موجود را دوباره استفاده میکند و plugin یا بستهی hook ازقبلنصبشده را در جای خودش بازنویسی میکند. وقتی آگاهانه همان id را از یک مسیر محلی، archive، بستهی ClawHub، یا artifact npm جدید دوباره نصب میکنید از آن استفاده کنید. برای ارتقاهای معمول یک plugin npm که از قبل track شده است، OmeniaClaw plugins update <id-or-npm-spec> را ترجیح دهید.
اگر plugins install را برای id مربوط به pluginی اجرا کنید که از قبل نصب شده است، OmeniaClaw متوقف میشود و برای ارتقای معمول شما را به plugins update <id-or-npm-spec> راهنمایی میکند، یا وقتی واقعاً میخواهید نصب فعلی را از منبع دیگری بازنویسی کنید به plugins install <package> --force.
--pin scope
--pin فقط روی نصبهای npm اعمال میشود. با نصبهای git: پشتیبانی نمیشود؛ وقتی منبع pinشده میخواهید، از یک git ref صریح مثل git:github.com/acme/[email protected] استفاده کنید. با --marketplace پشتیبانی نمیشود، چون نصبهای marketplace بهجای npm spec، metadata منبع marketplace را ماندگار میکنند.
--dangerously-force-unsafe-install
--dangerously-force-unsafe-install گزینهای اضطراری برای مثبتهای کاذب در اسکنر داخلی کد خطرناک است. این گزینه اجازه میدهد نصب حتی وقتی اسکنر داخلی یافتههای critical گزارش میکند ادامه پیدا کند، اما blockهای policy مربوط به hookهای before_install در plugin را دور نمیزند و failureهای scan را دور نمیزند.
این CLI flag روی جریانهای نصب/بهروزرسانی plugin اعمال میشود. نصبهای dependency مربوط به skill که با Gateway پشتیبانی میشوند از override درخواست متناظر dangerouslyForceUnsafeInstall استفاده میکنند، درحالیکه OmeniaClaw skills install همچنان جریان جداگانهی دانلود/نصب skill از ClawHub است.
اگر pluginی که در ClawHub منتشر کردهاید با scan در registry مسدود شده است، از مراحل ناشر در ClawHub استفاده کنید.
Hook packs and npm specs
plugins install همچنین سطح نصب برای بستههای hook است که OmeniaClaw.hooks را در package.json expose میکنند. برای visibility فیلترشدهی hook و فعالسازی هر hook، نه نصب package، از OmeniaClaw hooks استفاده کنید.
specهای npm فقط registry هستند (نام package + نسخهی دقیق اختیاری یا dist-tag). specهای Git/URL/file و بازههای semver رد میشوند. نصبهای dependency برای ایمنی بهصورت project-local با --ignore-scripts اجرا میشوند، حتی وقتی shell شما تنظیمات سراسری نصب npm دارد. ریشههای npm مدیریتشدهی plugin، overrides سطح package متعلق به OmeniaClaw را به ارث میبرند، بنابراین pinهای امنیتی host روی dependencyهای hoistشدهی plugin هم اعمال میشوند.
وقتی میخواهید resolution npm را صریح کنید، از npm:<package> استفاده کنید. specهای سادهی package هم در دورهی جابهجایی انتشار مستقیماً از npm نصب میشوند.
specهای ساده و @latest روی track پایدار میمانند. نسخههای اصلاحی تاریخدار OmeniaClaw مثل 2026.5.3-1 برای این check، releaseهای پایدار هستند. اگر npm هرکدام از آنها را به یک prerelease resolve کند، OmeniaClaw متوقف میشود و از شما میخواهد با یک tag prerelease مثل @beta/@rc یا یک نسخهی دقیق prerelease مثل @1.2.3-beta.4 صریحاً opt in کنید.
اگر یک install spec ساده با id رسمی plugin مطابقت داشته باشد (برای مثال diffs)، OmeniaClaw مستقیماً entry کاتالوگ را نصب میکند. برای نصب یک package npm با همان نام، از یک spec scoped صریح استفاده کنید (برای مثال @scope/diffs).
Git repositories
برای نصب مستقیم از یک repository در git، از git:<repo> استفاده کنید. شکلهای پشتیبانیشده شامل clone URLهای git:github.com/owner/repo، git:owner/repo، https:// کامل، ssh://، git://، file://، و git@host:owner/repo.git هستند. برای checkout کردن یک branch، tag، یا commit پیش از نصب، @<ref> یا #<ref> را اضافه کنید.
نصبهای Git در یک directory موقت clone میکنند، وقتی ref درخواستشده وجود داشته باشد آن را check out میکنند، سپس از installer عادی directory plugin استفاده میکنند. یعنی اعتبارسنجی manifest، اسکن کد خطرناک، کار نصب package-manager، و recordهای نصب مثل نصبهای npm رفتار میکنند. نصبهای git ثبتشده شامل URL/ref منبع بههمراه commit resolveشده هستند تا OmeniaClaw plugins update بتواند بعداً منبع را دوباره resolve کند.
بعد از نصب از git، از OmeniaClaw plugins inspect <id> --runtime --json برای تأیید registrationهای runtime مثل متدهای gateway و فرمانهای CLI استفاده کنید. اگر plugin با api.registerCli یک CLI root ثبت کرده است، آن فرمان را مستقیماً از طریق CLI root متعلق به OmeniaClaw اجرا کنید، برای مثال OmeniaClaw demo-plugin ping.
Archives
Archiveهای پشتیبانیشده: .zip، .tgz، .tar.gz، .tar. Archiveهای plugin بومی OmeniaClaw باید در root استخراجشدهی plugin یک OmeniaClaw.plugin.json معتبر داشته باشند؛ archiveهایی که فقط package.json دارند پیش از اینکه OmeniaClaw recordهای نصب را بنویسد رد میشوند.
وقتی فایل یک tarball از npm-pack است و میخواهید همان مسیر نصب npm-root مدیریتشده را که نصبهای registry استفاده میکنند تست کنید، از npm-pack:<path.tgz> استفاده کنید،
شامل تأیید package-lock.json، اسکن dependencyهای hoistشده، و
recordهای نصب npm. مسیرهای archive ساده همچنان بهعنوان archive محلی
زیر root مربوط به extensions plugin نصب میشوند.
نصبهای marketplace مربوط به Claude هم پشتیبانی میشوند.
نصبهای ClawHub از locator صریح clawhub:<package> استفاده میکنند:
OmeniaClaw plugins install clawhub:OmeniaClaw-codex-app-serverOmeniaClaw plugins install clawhub:[email protected]specهای plugin ساده و ایمن برای npm در دورهی جابهجایی انتشار بهصورت پیشفرض از npm نصب میشوند:
OmeniaClaw plugins install OmeniaClaw-codex-app-serverبرای صریحکردن resolution فقط-npm از npm: استفاده کنید:
OmeniaClaw plugins install npm:OmeniaClaw-codex-app-serverOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw پیش از نصب، سازگاری API تبلیغشدهٔ Plugin / حداقل سازگاری Gateway را بررسی میکند. وقتی نسخهٔ انتخابشدهٔ ClawHub یک آرتیفکت ClawPack منتشر میکند، OmeniaClaw بستهٔ npm-pack نسخهدار .tgz را دانلود میکند، سرآیند digest در ClawHub و digest آرتیفکت را تأیید میکند، سپس آن را از مسیر معمول آرشیو نصب میکند. نسخههای قدیمیتر ClawHub بدون فرادادهٔ ClawPack همچنان از مسیر قدیمی تأیید آرشیو بسته نصب میشوند. نصبهای ثبتشده، فرادادهٔ منبع ClawHub، نوع آرتیفکت، یکپارچگی npm، shasum در npm، نام tarball، و واقعیتهای digest در ClawPack را برای بهروزرسانیهای بعدی نگه میدارند.
نصبهای ClawHub بدون نسخه، یک مشخصهٔ ثبتشدهٔ بدون نسخه نگه میدارند تا OmeniaClaw plugins update بتواند انتشارهای جدیدتر ClawHub را دنبال کند؛ انتخابگرهای نسخه یا برچسب صریح مانند clawhub:[email protected] و clawhub:pkg@beta همچنان به همان انتخابگر سنجاق میمانند.
کوتاهنویسی بازار
وقتی نام بازار در کش رجیستری محلی Claude در ~/.claude/plugins/known_marketplaces.json وجود دارد، از کوتاهنویسی plugin@marketplace استفاده کنید:
OmeniaClaw plugins marketplace list <marketplace-name>OmeniaClaw plugins install <plugin-name>@<marketplace-name>وقتی میخواهید منبع بازار را صریحاً ارسال کنید، از --marketplace استفاده کنید:
OmeniaClaw plugins install <plugin-name> --marketplace <marketplace-name>OmeniaClaw plugins install <plugin-name> --marketplace <owner/repo>OmeniaClaw plugins install <plugin-name> --marketplace https://github.com/<owner>/<repo>OmeniaClaw plugins install <plugin-name> --marketplace ./my-marketplaceمنابع بازار
- یک نام بازار شناختهشدهٔ Claude از
~/.claude/plugins/known_marketplaces.json - ریشهٔ بازار محلی یا مسیر
marketplace.json - کوتاهنویسی مخزن GitHub مانند
owner/repo - URL مخزن GitHub مانند
https://github.com/owner/repo - یک URL مربوط به git
قواعد بازار راه دور
برای بازارهای راه دور که از GitHub یا git بارگذاری میشوند، ورودیهای Plugin باید داخل مخزن بازار cloneشده باقی بمانند. OmeniaClaw منابع مسیر نسبی را از همان مخزن میپذیرد و منابع Plugin از نوع HTTP(S)، مسیر مطلق، git، GitHub، و دیگر منابع غیرمسیر را از manifestهای راه دور رد میکند.
برای مسیرها و آرشیوهای محلی، OmeniaClaw بهصورت خودکار تشخیص میدهد:
- Pluginهای بومی OmeniaClaw (
OmeniaClaw.plugin.json) - بستههای سازگار با Codex (
.codex-plugin/plugin.json) - بستههای سازگار با Claude (
.claude-plugin/plugin.jsonیا چیدمان پیشفرض مؤلفهٔ Claude) - بستههای سازگار با Cursor (
.cursor-plugin/plugin.json)
فهرست
OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --jsonOmeniaClaw plugins search <query>OmeniaClaw plugins search <query> --limit 20OmeniaClaw plugins search <query> --json--enabledbooleanفقط Pluginهای فعال را نشان بده.
--verbosebooleanاز نمای جدولی به خطهای جزئیات هر Plugin با فرادادهٔ منبع/خاستگاه/نسخه/فعالسازی جابهجا شو.
--jsonbooleanموجودی قابلخواندن توسط ماشین بههمراه diagnostics رجیستری و وضعیت نصب وابستگیهای بسته.
plugins search یک جستوجوی کاتالوگ راه دور ClawHub است. وضعیت محلی را بررسی نمیکند،
config را تغییر نمیدهد، بسته نصب نمیکند، و کد زمان اجرای Plugin را بارگذاری نمیکند. نتایج جستوجو
شامل نام بستهٔ ClawHub، خانواده، کانال، نسخه، خلاصه، و
راهنمای نصبی مانند OmeniaClaw plugins install clawhub:<package> هستند.
برای کار روی Pluginهای همراه داخل یک image بستهبندیشدهٔ Docker، دایرکتوری منبع Plugin
را روی مسیر منبع بستهبندیشدهٔ متناظر bind-mount کنید، مانند
/app/extensions/synology-chat. OmeniaClaw آن overlay منبع mountشده را
پیش از /app/dist/extensions/synology-chat کشف میکند؛ یک دایرکتوری منبع صرفاً کپیشده
بیاثر میماند تا نصبهای بستهبندیشدهٔ معمول همچنان از dist کامپایلشده استفاده کنند.
برای اشکالزدایی hook زمان اجرا:
OmeniaClaw plugins inspect <id> --runtime --jsonhookهای ثبتشده و diagnostics را از یک گذر inspection با module-loaded نشان میدهد. inspection زمان اجرا هرگز وابستگیها را نصب نمیکند؛ ازOmeniaClaw doctor --fixبرای پاکسازی وضعیت وابستگی قدیمی یا بازیابی Pluginهای دانلودشدنی گمشده که در config ارجاع شدهاند استفاده کنید.OmeniaClaw gateway status --deep --require-rpcGateway قابلدسترسی، راهنماهای سرویس/فرایند، مسیر config، و سلامت RPC را تأیید میکند.- hookهای گفتوگوی غیرهمراه (
llm_input,llm_output,before_model_resolve,before_agent_reply,before_agent_run,before_agent_finalize,agent_end) بهplugins.entries.<id>.hooks.allowConversationAccess=trueنیاز دارند.
برای جلوگیری از کپیکردن یک دایرکتوری محلی از --link استفاده کنید (به plugins.load.paths اضافه میکند):
OmeniaClaw plugins install -l ./my-pluginindex مربوط به Plugin
فرادادهٔ نصب Plugin وضعیتی مدیریتشده توسط ماشین است، نه config کاربر. نصبها و بهروزرسانیها آن را در plugins/installs.json زیر دایرکتوری وضعیت فعال OmeniaClaw مینویسند. map سطح بالای installRecords منبع پایدار فرادادهٔ نصب است، از جمله رکوردهای manifestهای خراب یا گمشدهٔ Plugin. آرایهٔ plugins کش رجیستری سرد مشتقشده از manifest است. این فایل شامل هشدار ویرایشنکنید است و توسط OmeniaClaw plugins update، حذف نصب، diagnostics، و رجیستری سرد Plugin استفاده میشود.
وقتی OmeniaClaw رکوردهای قدیمی عرضهشدهٔ plugins.installs را در config میبیند، خواندنهای زمان اجرا با آنها بهعنوان ورودی سازگاری رفتار میکنند، بدون اینکه OmeniaClaw.json را بازنویسی کنند. نوشتنهای صریح Plugin و OmeniaClaw doctor --fix آن رکوردها را به index مربوط به Plugin منتقل میکنند و وقتی نوشتن config مجاز باشد کلید config را حذف میکنند؛ اگر هرکدام از نوشتنها شکست بخورد، رکوردهای config نگه داشته میشوند تا فرادادهٔ نصب از دست نرود.
حذف نصب
OmeniaClaw plugins uninstall <id>OmeniaClaw plugins uninstall <id> --dry-runOmeniaClaw plugins uninstall <id> --keep-filesuninstall رکوردهای Plugin را از plugins.entries، index پایدارشدهٔ Plugin، ورودیهای فهرست allow/deny مربوط به Plugin، و در صورت کاربرد ورودیهای پیوندی plugins.load.paths حذف میکند. مگر اینکه --keep-files تنظیم شده باشد، حذف نصب همچنین دایرکتوری نصب مدیریتشدهٔ ردیابیشده را وقتی داخل ریشهٔ extensions مربوط به Pluginهای OmeniaClaw باشد حذف میکند. برای Pluginهای active memory، slot حافظه به memory-core بازنشانی میشود.
بهروزرسانی
OmeniaClaw plugins update <id-or-npm-spec>OmeniaClaw plugins update --allOmeniaClaw plugins update <id-or-npm-spec> --dry-runOmeniaClaw plugins update @OmeniaClaw/voice-callOmeniaClaw plugins update OmeniaClaw-codex-app-server --dangerously-force-unsafe-installبهروزرسانیها روی نصبهای ردیابیشدهٔ Plugin در index مدیریتشدهٔ Plugin و نصبهای ردیابیشدهٔ hook-pack در hooks.internal.installs اعمال میشوند.
resolve کردن شناسهٔ Plugin در برابر مشخصهٔ npm
وقتی یک شناسهٔ Plugin ارسال میکنید، OmeniaClaw مشخصهٔ نصب ثبتشده برای آن Plugin را بازاستفاده میکند. یعنی dist-tagهای قبلاً ذخیرهشده مانند @beta و نسخههای دقیق pinشده در اجرای بعدی update <id> همچنان استفاده میشوند.
برای نصبهای npm، همچنین میتوانید یک مشخصهٔ صریح بستهٔ npm با dist-tag یا نسخهٔ دقیق ارسال کنید. OmeniaClaw آن نام بسته را به رکورد Plugin ردیابیشده resolve میکند، آن Plugin نصبشده را بهروزرسانی میکند، و مشخصهٔ جدید npm را برای بهروزرسانیهای آینده بر پایهٔ شناسه ثبت میکند.
ارسال نام بستهٔ npm بدون نسخه یا برچسب نیز به رکورد Plugin ردیابیشده resolve میشود. وقتی یک Plugin به نسخهای دقیق pin شده و میخواهید آن را به خط انتشار پیشفرض رجیستری برگردانید، از این استفاده کنید.
بهروزرسانیهای کانال beta
OmeniaClaw plugins update مشخصهٔ Plugin ردیابیشده را بازاستفاده میکند مگر اینکه مشخصهٔ جدیدی ارسال کنید. OmeniaClaw update علاوه بر آن کانال بهروزرسانی فعال OmeniaClaw را میشناسد: در کانال beta، رکوردهای Plugin مربوط به npm و ClawHub در خط پیشفرض ابتدا @beta را امتحان میکنند، سپس اگر انتشار beta برای Plugin وجود نداشته باشد به مشخصهٔ پیشفرض/آخرین ثبتشده fallback میکنند. این fallback بهعنوان هشدار گزارش میشود و باعث شکست بهروزرسانی هسته نمیشود. نسخههای دقیق و برچسبهای صریح به همان انتخابگر pin میمانند.
بررسیهای نسخه و drift یکپارچگی
پیش از یک بهروزرسانی زندهٔ npm، OmeniaClaw نسخهٔ بستهٔ نصبشده را با فرادادهٔ رجیستری npm بررسی میکند. اگر نسخهٔ نصبشده و هویت آرتیفکت ثبتشده از قبل با هدف resolveشده مطابقت داشته باشند، بهروزرسانی بدون دانلود، نصب دوباره، یا بازنویسی OmeniaClaw.json رد میشود.
وقتی hash یکپارچگی ذخیرهشده وجود داشته باشد و hash آرتیفکت fetchشده تغییر کند، OmeniaClaw با آن بهعنوان drift آرتیفکت npm رفتار میکند. دستور تعاملی OmeniaClaw plugins update hashهای مورد انتظار و واقعی را چاپ میکند و پیش از ادامه تأیید میخواهد. helperهای بهروزرسانی غیرتعاملی بهصورت fail-closed شکست میخورند مگر اینکه caller یک سیاست ادامهٔ صریح فراهم کند.
--dangerously-force-unsafe-install در بهروزرسانی
--dangerously-force-unsafe-install همچنین در plugins update بهعنوان override اضطراری برای false positiveهای scan کد خطرناک داخلی هنگام بهروزرسانی Pluginها در دسترس است. این گزینه همچنان blockهای سیاست before_install مربوط به Plugin یا block ناشی از شکست scan را دور نمیزند، و فقط برای بهروزرسانیهای Plugin اعمال میشود، نه بهروزرسانیهای hook-pack.
بازرسی
OmeniaClaw plugins inspect <id>OmeniaClaw plugins inspect <id> --runtimeOmeniaClaw plugins inspect <id> --jsonInspect هویت، وضعیت بارگذاری، منبع، قابلیتهای manifest، پرچمهای سیاست، diagnostics، فرادادهٔ نصب، قابلیتهای بسته، و هرگونه پشتیبانی شناساییشده از سرور MCP یا LSP را بهصورت پیشفرض بدون import کردن زمان اجرای Plugin نشان میدهد. --runtime را اضافه کنید تا ماژول Plugin بارگذاری شود و hookها، ابزارها، commandها، سرویسها، متدهای Gateway، و routeهای HTTP ثبتشده را شامل شود. inspection زمان اجرا وابستگیهای گمشدهٔ Plugin را مستقیماً گزارش میکند؛ نصبها و repairها در OmeniaClaw plugins install، OmeniaClaw plugins update، و OmeniaClaw doctor --fix باقی میمانند.
commandهای CLI تحت مالکیت Plugin معمولاً بهعنوان گروههای command ریشهٔ OmeniaClaw نصب میشوند، اما Pluginها ممکن است commandهای تودرتو را نیز زیر یک والد هسته مانند OmeniaClaw nodes ثبت کنند. پس از اینکه inspect --runtime یک command را زیر cliCommands نشان داد، آن را در مسیر فهرستشده اجرا کنید؛ برای مثال یک Plugin که demo-git را ثبت میکند میتواند با OmeniaClaw demo-git ping تأیید شود.
هر Plugin بر اساس آنچه واقعاً در زمان اجرا ثبت میکند طبقهبندی میشود:
- plain-capability — یک نوع قابلیت (مثلاً یک Plugin که فقط ارائهدهنده است)
- hybrid-capability — چند نوع قابلیت (مثلاً متن + گفتار + تصویر)
- hook-only — فقط هوکها، بدون قابلیت یا سطح
- non-capability — ابزارها/فرمانها/سرویسها اما بدون قابلیت
برای اطلاعات بیشتر درباره مدل قابلیت، شکلهای Plugin را ببینید.
Doctor
OmeniaClaw plugins doctordoctor خطاهای بارگذاری Plugin، عیبیابیهای manifest/discovery، و اعلانهای سازگاری را گزارش میکند. وقتی همهچیز پاک باشد، No plugin issues detected. را چاپ میکند.
اگر یک Plugin پیکربندیشده روی دیسک وجود داشته باشد اما توسط بررسیهای ایمنی مسیرِ بارگذار مسدود شده باشد، اعتبارسنجی پیکربندی ورودی Plugin را نگه میدارد و آن را بهصورت present but blocked گزارش میکند. بهجای حذف پیکربندی plugins.entries.<id> یا plugins.allow، عیبیابی قبلی مربوط به Plugin مسدودشده، مانند مالکیت مسیر یا مجوزهای قابلنوشتن برای همه، را رفع کنید.
برای شکستهای مربوط به شکل ماژول، مانند نبود exportهای register/activate، با OmeniaClaw_PLUGIN_LOAD_DEBUG=1 دوباره اجرا کنید تا خلاصهای فشرده از شکل exportها در خروجی عیبیابی گنجانده شود.
رجیستری
OmeniaClaw plugins registryOmeniaClaw plugins registry --refreshOmeniaClaw plugins registry --jsonرجیستری محلی Plugin، مدل خواندن سرد و پایدار OmeniaClaw برای هویت Plugin نصبشده، فعالبودن، فراداده منبع، و مالکیت مشارکتها است. راهاندازی عادی، جستوجوی مالک ارائهدهنده، طبقهبندی راهاندازی کانال، و موجودی Plugin میتوانند آن را بدون import کردن ماژولهای runtime Plugin بخوانند.
از plugins registry برای بررسی اینکه رجیستری پایدار وجود دارد، بهروز است، یا منسوخ شده استفاده کنید. از --refresh برای بازسازی آن از ایندکس پایدار Plugin، سیاست پیکربندی، و فراداده manifest/package استفاده کنید. این مسیر تعمیر است، نه مسیر فعالسازی runtime.
OmeniaClaw doctor --fix همچنین ناهماهنگی npm مدیریتشده در مجاورت رجیستری را تعمیر میکند: اگر یک بسته یتیم یا بازیابیشده @OmeniaClaw/* زیر ریشه npm مربوط به Plugin مدیریتشده، یک Plugin باندلشده را تحتالشعاع قرار دهد، doctor آن بسته منسوخ را حذف میکند و رجیستری را بازسازی میکند تا راهاندازی در برابر manifest باندلشده اعتبارسنجی شود. Doctor همچنین بسته میزبان OmeniaClaw را به Pluginهای npm مدیریتشدهای که peerDependencies.OmeniaClaw را اعلام میکنند، دوباره لینک میکند تا importهای runtime محلی بسته مانند OmeniaClaw/plugin-sdk/* پس از بهروزرسانیها یا تعمیرهای npm resolve شوند.
Marketplace
OmeniaClaw plugins marketplace list <source>OmeniaClaw plugins marketplace list <source> --jsonفهرست Marketplace یک مسیر محلی Marketplace، مسیر marketplace.json، shorthand گیتهاب مانند owner/repo، URL مخزن گیتهاب، یا URL گیت را میپذیرد. --json برچسب منبع resolveشده را همراه با manifest تجزیهشده Marketplace و ورودیهای Plugin چاپ میکند.
