Pluginها

Pluginهای Gateway، بسته‌های هوک و باندل‌های سازگار را مدیریت کنید.

فرمان‌ها

openclaw plugins list [--enabled] [--verbose] [--json]openclaw plugins search <query> [--limit <n>] [--json]openclaw plugins install <path-or-spec> [--link] [--force] [--pin] [--marketplace <source>]openclaw plugins inspect <id> [--runtime] [--json]openclaw plugins inspect --all [--runtime] [--json]openclaw plugins info <id>                    # نام مستعار inspectopenclaw plugins enable <id>openclaw plugins disable <id>openclaw plugins uninstall <id> [--dry-run] [--keep-files] [--force]openclaw plugins update <id-or-npm-spec> | --all [--dry-run]openclaw plugins registry [--refresh] [--json]openclaw plugins doctoropenclaw plugins init <id> [--name <name>] [--type tool|provider] [--directory <path>]openclaw plugins build [--entry <path>] [--check]openclaw plugins validate [--entry <path>]openclaw plugins marketplace entries [--offline] [--feed-profile <name>] [--json]openclaw plugins marketplace list <source> [--json]openclaw plugins marketplace refresh [--feed-profile <name>] [--expected-sha256 <sha256>] [--json]

برای بررسی کندی نصب، بازرسی، حذف نصب یا تازه‌سازی رجیستری، فرمان را با OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1 اجرا کنید. ردیابی، زمان‌بندی مرحله‌ها را در stderr می‌نویسد و خروجی JSON را قابل تجزیه نگه می‌دارد. به عیب‌یابی مراجعه کنید.

توسعه

openclaw plugins init stock-quotes --name "Stock Quotes"cd stock-quotesnpm run plugin:buildnpm run plugin:validate

plugins init به‌طور پیش‌فرض یک Plugin ابزار حداقلی TypeScript ایجاد می‌کند. آرگومان نخست، شناسه Plugin است؛ --name نام نمایشی را تعیین می‌کند. OpenClaw از شناسه برای پوشه خروجی پیش‌فرض و نام‌گذاری بسته استفاده می‌کند. داربست‌های ابزار از defineToolPlugin استفاده می‌کنند و اسکریپت‌های package.json یعنی plugin:build و plugin:validate را تولید می‌کنند که ابتدا ساخت را انجام می‌دهند و سپس openclaw plugins build/validate را فراخوانی می‌کنند.

plugins build ورودی ساخته‌شده را وارد می‌کند، فراداده ایستای ابزار آن را می‌خواند، openclaw.plugin.json را می‌نویسد و openclaw.extensions متعلق به package.json را همگام نگه می‌دارد. plugins validate بررسی می‌کند که مانیفست تولیدشده، فراداده بسته و خروجی فعلی ورودی همچنان با یکدیگر منطبق باشند. برای گردش‌کار کامل توسعه، به Pluginهای ابزار مراجعه کنید.

داربست، کد منبع TypeScript را می‌نویسد اما فراداده را از ورودی ساخته‌شده ./dist/index.js تولید می‌کند؛ بنابراین این گردش‌کار با CLI منتشرشده نیز کار می‌کند. وقتی ورودی، ورودی پیش‌فرض بسته نیست، از --entry <path> استفاده کنید. در CI از plugins build --check استفاده کنید تا در صورت منسوخ‌بودن فراداده تولیدشده، بدون بازنویسی فایل‌ها با شکست مواجه شود.

داربست ارائه‌دهنده

openclaw plugins init acme-models --name "Acme Models" --type providercd acme-modelsnpm installnpm run buildnpm testnpm run validate

داربست‌های ارائه‌دهنده، یک Plugin عمومی ارائه‌دهنده مدل سازگار با OpenAI با زیرساخت احراز هویت کلید API، یک اسکریپت npm run validate که clawhub package validate را اجرا می‌کند، فراداده بسته ClawHub و یک گردش‌کار GitHub Actions با اجرای دستی برای انتشار قابل‌اعتماد آینده از طریق GitHub OIDC ایجاد می‌کنند. داربست‌های ارائه‌دهنده Skills تولید نمی‌کنند و از openclaw plugins build/validate استفاده نمی‌کنند؛ آن فرمان‌ها برای مسیر فراداده تولیدشده داربست ابزار هستند.

پیش از انتشار، نشانی پایه API جای‌نگهدار، کاتالوگ مدل، مسیر مستندات، متن اطلاعات ورود و متن README را با جزئیات واقعی ارائه‌دهنده جایگزین کنید. برای نخستین انتشار در ClawHub و راه‌اندازی ناشر قابل‌اعتماد، از README تولیدشده استفاده کنید.

نصب

openclaw plugins search "calendar"                      # جست‌وجوی Pluginهای ClawHubopenclaw plugins install @openclaw/<package>            # کاتالوگ رسمی قابل‌اعتمادopenclaw plugins install <package>                       # بسته دلخواه npmopenclaw plugins install clawhub:<package>                # فقط ClawHubopenclaw plugins install npm:<package>                    # فقط npmopenclaw plugins install npm-pack:<path.tgz>               # تاربال محلی npm-packopenclaw plugins install git:github.com/<owner>/<repo>     # مخزن gitopenclaw plugins install git:github.com/<owner>/<repo>@<ref>openclaw plugins install <path>                            # مسیر یا بایگانی محلیopenclaw plugins install -l <path>                         # پیوند به‌جای کپیopenclaw plugins install <plugin>@<marketplace>             # صورت کوتاه بازارopenclaw plugins install <plugin> --marketplace <name>      # بازار (صریح)openclaw plugins install <package> --force                  # تأیید منبع / بازنویسی مورد موجودopenclaw plugins install <package> --pin                    # سنجاق‌کردن نسخه حل‌شده npmopenclaw plugins install clawhub:<package> --acknowledge-clawhub-riskopenclaw plugins install <package> --dangerously-force-unsafe-install

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

plugins search برای بسته‌های قابل‌نصب code-plugin و bundle-plugin از ClawHub پرس‌وجو می‌کند (نه Skills؛ برای آن‌ها از openclaw skills search استفاده کنید). مقدار پیش‌فرض --limit برابر 20 و سقف آن 100 است. این فرمان فقط کاتالوگ راه‌دور را می‌خواند: هیچ بازرسی وضعیت محلی، تغییر پیکربندی، نصب بسته یا بارگذاری زمان اجرای Plugin انجام نمی‌شود. نتایج شامل نام بسته ClawHub، خانواده، کانال، نسخه، خلاصه و راهنمای نصب مانند openclaw plugins install clawhub:<package> هستند.

نصب‌های ClawHub از مکان‌یاب صریح clawhub:<package> استفاده می‌کنند:

openclaw plugins install clawhub:openclaw-codex-app-serveropenclaw plugins install clawhub:openclaw-codex-app-server@1.2.3

مشخصات ساده و ایمن برای npm در جریان گذار راه‌اندازی، به‌طور پیش‌فرض از npm نصب می‌شوند، مگر اینکه با شناسهٔ یک Plugin رسمی مطابقت داشته باشند:

openclaw plugins install openclaw-codex-app-server

برای صریح‌کردن تفکیک صرفاً از npm از npm: استفاده کنید:

openclaw plugins install npm:openclaw-codex-app-serveropenclaw plugins install npm:@openclaw/discord@2026.5.20openclaw plugins install npm:@scope/plugin-name@1.0.1

OpenClaw پیش از نصب، سازگاری اعلام‌شدهٔ API ‏Plugin / حداقل Gateway را بررسی می‌کند. وقتی نسخهٔ انتخاب‌شدهٔ ClawHub یک مصنوع ClawPack منتشر کرده باشد، OpenClaw فایل نسخه‌دار npm-pack ‏.tgz را دانلود می‌کند، سرآیند digest ‏ClawHub و digest مصنوع را تأیید می‌کند و سپس آن را از طریق مسیر معمول بایگانی نصب می‌کند. نسخه‌های قدیمی‌تر ClawHub بدون فرادادهٔ ClawPack همچنان از طریق مسیر قدیمی تأیید بایگانی بسته نصب می‌شوند. نصب‌های ثبت‌شده فرادادهٔ منبع ClawHub، نوع مصنوع، یکپارچگی npm، shasum ‏npm، نام tarball و داده‌های digest ‏ClawPack را برای به‌روزرسانی‌های بعدی حفظ می‌کنند. نصب‌های بدون نسخهٔ ClawHub یک مشخصهٔ ثبت‌شدهٔ بدون نسخه را نگه می‌دارند تا openclaw plugins update بتواند نسخه‌های جدیدتر ClawHub را دنبال کند؛ گزینش‌گرهای صریح نسخه یا برچسب مانند clawhub:pkg@1.2.3 و clawhub:pkg@beta به همان گزینش‌گر پین می‌مانند.

شکل کوتاه marketplace

وقتی نام marketplace در کش رجیستری محلی Claude در ~/.claude/plugins/known_marketplaces.json وجود دارد، از شکل کوتاه plugin@marketplace استفاده کنید:

openclaw plugins marketplace list <marketplace-name>openclaw plugins install <plugin-name>@<marketplace-name>

برای ارسال صریح منبع marketplace از --marketplace استفاده کنید:

openclaw plugins install <plugin-name> --marketplace <marketplace-name>openclaw plugins install <plugin-name> --marketplace <owner/repo>openclaw plugins install <plugin-name> --marketplace https://github.com/<owner>/<repo>openclaw plugins install <plugin-name> --marketplace ./my-marketplace

برای مسیرها و بایگانی‌های محلی، OpenClaw به‌طور خودکار این موارد را تشخیص می‌دهد:

• Pluginهای بومی OpenClaw ‏(openclaw.plugin.json)
• بسته‌های سازگار با Codex ‏(.codex-plugin/plugin.json)
• بسته‌های سازگار با Claude ‏(.claude-plugin/plugin.json، یا چیدمان پیش‌فرض مؤلفه‌های Claude وقتی آن فایل manifest وجود ندارد)
• بسته‌های سازگار با Cursor ‏(.cursor-plugin/plugin.json)

نصب‌های محلی مدیریت‌شده باید پوشه یا بایگانی Plugin باشند. فایل‌های مستقل Plugin با پسوندهای .js، .mjs، .cjs و .ts توسط plugins install در ریشهٔ مدیریت‌شدهٔ Plugin کپی نمی‌شوند و با قراردادن مستقیم آن‌ها در ~/.openclaw/extensions یا <workspace>/.openclaw/extensions نیز بارگذاری نمی‌شوند؛ این ریشه‌های با کشف خودکار، پوشه‌های بسته یا بستهٔ Plugin را بارگذاری می‌کنند و فایل‌های اسکریپت سطح بالا را به‌عنوان ابزارهای کمکی محلی نادیده می‌گیرند. در عوض فایل‌های مستقل را صراحتاً در plugins.load.paths فهرست کنید.

برای اشاره به یک پوشهٔ محلی Plugin بدون کپی‌کردن آن از -l/--link استفاده کنید (آن را به plugins.load.paths اضافه می‌کند):

openclaw plugins install -l ./my-plugin

--link با نصب‌های --marketplace یا git: پشتیبانی نمی‌شود و به یک مسیر محلی ازپیش‌موجود نیاز دارد. برای پیوند محلی غیرتعاملی، پس از بررسی منبع، --force را ارسال کنید؛ این گزینه منشأ را تأیید می‌کند، اما پوشهٔ پیوندشده را کپی یا بازنویسی نمی‌کند.

فهرست

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --json

اگر هنگام راه‌اندازی، plugins.allow is empty; discovered non-bundled plugins may auto-load: ... در گزارش‌ها ثبت شد، openclaw plugins list --enabled --verbose یا openclaw plugins inspect <id> را با یکی از شناسه‌های فهرست‌شدهٔ Plugin اجرا کنید تا شناسه‌های Plugin را تأیید کنید و شناسه‌های مورد اعتماد را در plugins.allow در openclaw.json کپی کنید. وقتی هشدار بتواند همهٔ Pluginهای کشف‌شده را فهرست کند، یک قطعهٔ plugins.allow آمادهٔ جای‌گذاری چاپ می‌کند که از قبل آن شناسه‌ها را در بر دارد. اگر Plugin بدون منشأ نصب/مسیر بارگذاری بارگذاری می‌شود، آن شناسهٔ Plugin را بررسی کنید، سپس یا شناسهٔ مورد اعتماد را در plugins.allow سنجاق کنید یا Plugin را از منبعی مورد اعتماد دوباره نصب کنید تا OpenClaw منشأ نصب را ثبت کند.

برای کار روی Plugin همراه‌شده درون یک تصویر بسته‌بندی‌شدهٔ Docker، دایرکتوری منبع Plugin را به‌صورت bind mount روی مسیر منبع بسته‌بندی‌شدهٔ متناظر سوار کنید، مانند /app/extensions/synology-chat. OpenClaw آن پوشش منبع سوارشده را پیش از /app/dist/extensions/synology-chat کشف می‌کند؛ یک دایرکتوری منبع که صرفاً کپی شده باشد غیرفعال می‌ماند، بنابراین نصب‌های بسته‌بندی‌شدهٔ عادی همچنان از dist کامپایل‌شده استفاده می‌کنند.

برای اشکال‌زدایی هوک‌های زمان اجرا:

• openclaw plugins inspect <id> --runtime --json هوک‌های ثبت‌شده و عیب‌یابی‌های حاصل از یک گذر بررسی با ماژول بارگذاری‌شده را نشان می‌دهد. بررسی زمان اجرا هرگز وابستگی‌ها را نصب نمی‌کند؛ برای پاک‌سازی وضعیت قدیمی وابستگی یا بازیابی Pluginهای قابل‌دریافت ازدست‌رفته‌ای که پیکربندی به آن‌ها ارجاع می‌دهد، از openclaw doctor --fix استفاده کنید.
• openclaw gateway status --deep --require-rpc نشانی اینترنتی/پروفایل قابل‌دسترسی Gateway، راهنمایی‌های سرویس/فرایند، مسیر پیکربندی و سلامت RPC را تأیید می‌کند.
• هوک‌های مکالمهٔ همراه‌نشده (llm_input، llm_output، before_model_resolve، before_agent_reply، before_agent_run، before_agent_finalize، agent_end) به plugins.entries.<id>.hooks.allowConversationAccess=true نیاز دارند.

نمایهٔ Plugin

فرادادهٔ نصب Plugin، وضعیتی مدیریت‌شده توسط ماشین است، نه پیکربندی کاربر. نصب‌ها و به‌روزرسانی‌ها آن را در پایگاه دادهٔ مشترک SQLite زیر دایرکتوری وضعیت فعال OpenClaw می‌نویسند. ردیف installed_plugin_index فرادادهٔ ماندگار installRecords را ذخیره می‌کند؛ از جمله رکوردهای مانیفست‌های خراب یا ازدست‌رفتهٔ Plugin و یک حافظهٔ نهان رجیستری سرد مشتق‌شده از مانیفست که توسط openclaw plugins update، حذف نصب، عیب‌یابی‌ها و رجیستری سرد Plugin استفاده می‌شود.

وقتی OpenClaw رکوردهای قدیمی و منتشرشدهٔ plugins.installs را در پیکربندی می‌بیند، خواندن‌های زمان اجرا بدون بازنویسی openclaw.json با آن‌ها به‌عنوان ورودی سازگاری رفتار می‌کنند. نوشتن‌های صریح Plugin و openclaw doctor --fix آن رکوردها را به نمایهٔ Plugin منتقل می‌کنند و در صورت مجاز بودن نوشتن پیکربندی، کلید پیکربندی را حذف می‌کنند؛ اگر هرکدام از این نوشتن‌ها ناموفق باشد، رکوردهای پیکربندی حفظ می‌شوند تا فرادادهٔ نصب از بین نرود.

حذف نصب

openclaw plugins uninstall <id>openclaw plugins uninstall <id> --dry-runopenclaw plugins uninstall <id> --keep-filesopenclaw plugins uninstall <id> --force

uninstall رکوردهای Plugin را از plugins.entries، نمایهٔ ماندگار Plugin، مدخل‌های فهرست مجاز/غیرمجاز Plugin و در صورت کاربرد، مدخل‌های پیوندشدهٔ plugins.load.paths حذف می‌کند. مگر اینکه --keep-files تنظیم شده باشد، حذف نصب دایرکتوری نصب مدیریت‌شدهٔ ردیابی‌شده را نیز حذف می‌کند، اما فقط وقتی مسیر نهایی آن درون ریشهٔ افزونه‌های Plugin در OpenClaw باشد. اگر Plugin در حال حاضر مالک جایگاه memory یا contextEngine باشد، آن جایگاه به مقدار پیش‌فرض خود بازنشانی می‌شود (memory-core برای حافظه و legacy برای موتور زمینه).

uninstall پیش‌نمایشی از مواردی که حذف خواهند شد چاپ می‌کند، سپس پیش از اعمال تغییرات، Uninstall plugin "<id>"? را درخواست می‌کند. برای رد کردن درخواست تأیید، --force را ارسال کنید (برای اسکریپت‌ها و اجراهای غیرتعاملی مفید است)؛ بدون آن، حذف نصب به یک TTY تعاملی نیاز دارد. --dry-run همان پیش‌نمایش را چاپ می‌کند و بدون درخواست تأیید یا ایجاد هیچ تغییری خارج می‌شود.

به‌روزرسانی

openclaw plugins update <id-or-npm-spec>openclaw plugins update --allopenclaw plugins update <id-or-npm-spec> --dry-runopenclaw plugins update @openclaw/voice-callopenclaw plugins update @acme/demoopenclaw plugins update openclaw-codex-app-server --acknowledge-clawhub-riskopenclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install

به‌روزرسانی‌ها روی نصب‌های ردیابی‌شدهٔ Plugin در نمایهٔ مدیریت‌شدهٔ Plugin و نصب‌های ردیابی‌شدهٔ بستهٔ هوک در hooks.internal.installs اعمال می‌شوند. آن‌ها از همان منبعی که کاربر هنگام نصب Plugin انتخاب کرده است دوباره استفاده می‌کنند، بنابراین به تأیید دوبارهٔ منبع نیاز ندارند.

بررسی

openclaw plugins inspect <id>openclaw plugins inspect <id> --runtimeopenclaw plugins inspect <id> --jsonopenclaw plugins inspect --all

بررسی، هویت، وضعیت بارگذاری، منبع، قابلیت‌های مانیفست، پرچم‌های سیاست، عیب‌یابی‌ها، فرادادهٔ نصب، قابلیت‌های بسته و هرگونه پشتیبانی شناسایی‌شده از سرور MCP یا LSP را بدون وارد کردن پیش‌فرض زمان اجرای Plugin نشان می‌دهد. خروجی JSON قراردادهای مانیفست Plugin، مانند contracts.agentToolResultMiddleware و contracts.trustedToolPolicies را در بر می‌گیرد تا اپراتورها بتوانند پیش از فعال‌سازی یا راه‌اندازی مجدد یک Plugin، اعلان‌های سطح مورد اعتماد را ممیزی کنند. برای بارگذاری ماژول Plugin و گنجاندن هوک‌ها، ابزارها، فرمان‌ها، سرویس‌ها، روش‌های Gateway و مسیرهای HTTP ثبت‌شده، --runtime را اضافه کنید. بررسی زمان اجرا وابستگی‌های ازدست‌رفتهٔ Plugin را مستقیماً گزارش می‌کند؛ نصب‌ها و تعمیرات در openclaw plugins install، openclaw plugins update و openclaw doctor --fix باقی می‌مانند.

فرمان‌های CLI متعلق به Plugin معمولاً به‌عنوان گروه‌های فرمان ریشهٔ openclaw نصب می‌شوند، اما Pluginها می‌توانند فرمان‌های تو‌در‌تو را نیز زیر یک والد هسته‌ای مانند openclaw nodes ثبت کنند. پس از اینکه inspect --runtime یک فرمان را زیر cliCommands نشان داد، آن را در مسیر فهرست‌شده اجرا کنید؛ برای مثال، Pluginی که demo-git را ثبت می‌کند، با openclaw demo-git ping قابل تأیید است.

هر Plugin بر اساس آنچه واقعاً در زمان اجرا ثبت می‌کند طبقه‌بندی می‌شود:

برای اطلاعات بیشتر دربارهٔ مدل قابلیت، به شکل‌های Plugin مراجعه کنید.

Doctor

openclaw plugins doctor

doctor خطاهای بارگذاری Plugin، عیب‌یابی‌های مانیفست/کشف، اعلان‌های سازگاری و ارجاع‌های منسوخ پیکربندی Plugin، مانند جایگاه‌های مفقود Plugin، را گزارش می‌کند. هنگامی که درخت نصب و پیکربندی Plugin پاک باشند، No plugin issues detected. را چاپ می‌کند. اگر پیکربندی منسوخ باقی مانده باشد اما درخت نصب از سایر جهات سالم باشد، خلاصه به‌جای القای سلامت کامل Plugin، این موضوع را بیان می‌کند.

اگر یک Plugin پیکربندی‌شده روی دیسک موجود باشد اما بررسی‌های ایمنی مسیر بارگذار آن را مسدود کنند، اعتبارسنجی پیکربندی ورودی Plugin را نگه می‌دارد و آن را به‌صورت present but blocked گزارش می‌کند. به‌جای حذف پیکربندی plugins.entries.<id> یا plugins.allow، عیب‌یابی پیشینِ Plugin مسدودشده، مانند مالکیت مسیر یا مجوزهای قابل‌نوشتن برای همه، را برطرف کنید.

برای خرابی‌های ساختار ماژول، مانند نبود exportهای register/activate، فرمان را دوباره با OPENCLAW_PLUGIN_LOAD_DEBUG=1 اجرا کنید تا خلاصه‌ای فشرده از ساختار export در خروجی عیب‌یابی گنجانده شود.

رجیستری

openclaw plugins registryopenclaw plugins registry --refreshopenclaw plugins registry --json

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

از plugins registry برای بررسی موجود، به‌روز یا منسوخ بودن رجیستری پایدار استفاده کنید. از --refresh برای بازسازی آن بر اساس نمایه پایدار Plugin، خط‌مشی پیکربندی و فراداده مانیفست/بسته استفاده کنید. این مسیری برای تعمیر است، نه مسیری برای فعال‌سازی زمان اجرا.

openclaw doctor --fix همچنین ناهماهنگی مدیریت‌شده npm در مجاورت رجیستری را تعمیر می‌کند: اگر یک بسته یتیم یا بازیابی‌شده @openclaw/* زیر یک پروژه مدیریت‌شده npm مربوط به Plugin یا ریشه مسطح و قدیمی npm مدیریت‌شده، یک Plugin همراه را تحت‌الشعاع قرار دهد، doctor آن بسته منسوخ را حذف و رجیستری را بازسازی می‌کند تا راه‌اندازی بر اساس مانیفست همراه اعتبارسنجی شود. doctor همچنین بسته میزبان openclaw را دوباره به Pluginهای مدیریت‌شده npm که peerDependencies.openclaw را اعلام می‌کنند پیوند می‌دهد تا importهای زمان اجرای محلی بسته، مانند openclaw/plugin-sdk/*، پس از به‌روزرسانی‌ها یا تعمیرات npm قابل resolve باشند.

بازارچه

openclaw plugins marketplace entriesopenclaw plugins marketplace entries --offlineopenclaw plugins marketplace entries --jsonopenclaw plugins marketplace entries --feed-profile <name>openclaw plugins marketplace entries --feed-url <url>openclaw plugins marketplace list <source>openclaw plugins marketplace list <source> --jsonopenclaw plugins marketplace refreshopenclaw plugins marketplace refresh --feed-profile <name>openclaw plugins marketplace refresh --feed-url <url>openclaw plugins marketplace refresh --expected-sha256 <sha256> --json

plugins marketplace entries ورودی‌های فید پیکربندی‌شده بازارچه OpenClaw را فهرست می‌کند. به‌طور پیش‌فرض، فید میزبانی‌شده را امتحان می‌کند و در صورت عدم موفقیت به جدیدترین snapshot پذیرفته‌شده یا داده‌های همراه بازمی‌گردد. از --feed-profile <name> برای خواندن یک پروفایل پیکربندی‌شده مشخص، از --feed-url <url> برای خواندن URL صریح یک فید میزبانی‌شده و از --offline برای خواندن جدیدترین snapshot پذیرفته‌شده بدون دریافت فید استفاده کنید.

plugins marketplace refresh snapshot فید میزبانی‌شده پیکربندی‌شده را تازه‌سازی می‌کند و گزارش می‌دهد که آیا OpenClaw داده‌های میزبانی‌شده، یک snapshot میزبانی‌شده یا داده‌های fallback همراه را پذیرفته است. هنگامی که فراخواننده نیاز دارد فرمان جز در صورت مطابقت یک payload تازه میزبانی‌شده با checksum ثابت‌شده ناموفق باشد، از --expected-sha256 استفاده کنید.

list بازارچه یک مسیر محلی بازارچه، یک مسیر marketplace.json، یک شکل کوتاه GitHub مانند owner/repo، یک URL مخزن GitHub یا یک URL مربوط به git را می‌پذیرد. --json برچسب منبع resolveشده را همراه با مانیفست تجزیه‌شده بازارچه و ورودی‌های Plugin چاپ می‌کند.

تازه‌سازی بازارچه یک فید میزبانی‌شده بازارچه OpenClaw را بارگذاری می‌کند و پاسخ اعتبارسنجی‌شده را به‌عنوان snapshot محلی فید میزبانی‌شده به‌صورت پایدار ذخیره می‌کند. بدون گزینه‌ها، از پروفایل پیش‌فرض پیکربندی‌شده فید استفاده می‌کند. از --feed-profile <name> برای تازه‌سازی یک پروفایل پیکربندی‌شده مشخص، از --feed-url <url> برای تازه‌سازی یک URL صریح فید میزبانی‌شده، از --expected-sha256 <sha256> برای الزام مطابقت checksum محتوای قابل‌انتقال (sha256:<hex> یا یک digest هگزادسیمال ساده 64 نویسه‌ای) و از --json برای خروجی ماشین‌خوان استفاده کنید. URLهای صریح فید میزبانی‌شده نباید شامل اعتبارنامه‌ها، رشته‌های query یا fragmentها باشند. تازه‌سازی‌های بدون مقدار ثابت می‌توانند نتیجه snapshot میزبانی‌شده یا fallback همراه را بدون ناموفق کردن فرمان گزارش کنند. تازه‌سازی‌های دارای مقدار ثابت، جز در صورت پذیرش یک payload تازه میزبانی‌شده، ناموفق می‌شوند و تازه‌سازی‌های موفق میزبانی‌شده در صورتی ناموفق می‌شوند که OpenClaw نتواند snapshot اعتبارسنجی‌شده را به‌صورت پایدار ذخیره کند.

مرتبط

• ساخت Pluginها
• مرجع CLI
• ClawHub