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>                    # alias for 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 استفاده می‌کنند و اسکریپت‌های plugin:build و plugin:validate را در package.json ایجاد می‌کنند که ابتدا می‌سازند و سپس 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"                      # search ClawHub pluginsopenclaw plugins install <package>                       # source auto-detectionopenclaw plugins install clawhub:<package>                # ClawHub onlyopenclaw plugins install npm:<package>                    # npm onlyopenclaw plugins install npm-pack:<path.tgz>               # local npm-pack tarballopenclaw plugins install git:github.com/<owner>/<repo>     # git repoopenclaw plugins install git:github.com/<owner>/<repo>@<ref>openclaw plugins install <path>                            # local path or archiveopenclaw plugins install -l <path>                         # link instead of copyopenclaw plugins install <plugin>@<marketplace>             # marketplace shorthandopenclaw plugins install <plugin> --marketplace <name>      # marketplace (explicit)openclaw plugins install <package> --force                  # overwrite existing installopenclaw plugins install <package> --pin                    # pin resolved npm versionopenclaw 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 برابر ۲۰ است و حداکثر به ۱۰۰ محدود می‌شود. این فرمان فقط کاتالوگ راه‌دور را می‌خواند: هیچ بازرسی وضعیت محلی، تغییر پیکربندی، نصب بسته یا بارگذاری زمان اجرای 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 مربوط به Plugin، هنگام گذار راه‌اندازی به‌طور پیش‌فرض از 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 فایل .tgz نسخه‌دارِ npm-pack را بارگیری می‌کند، سرآیند چکیدهٔ ClawHub و چکیدهٔ مصنوع را تأیید می‌کند و سپس آن را از طریق مسیر عادی بایگانی نصب می‌کند. نسخه‌های قدیمی‌تر ClawHub که فاقد فرادادهٔ ClawPack هستند همچنان از مسیر قدیمی تأیید بایگانی بسته نصب می‌شوند. نصب‌های ثبت‌شده، فرادادهٔ مبدأ ClawHub، نوع مصنوع، یکپارچگی npm،‏ shasum مربوط به npm، نام tarball و اطلاعات چکیدهٔ ClawPack را برای به‌روزرسانی‌های بعدی نگه می‌دارند. نصب‌های بدون نسخهٔ ClawHub مشخصات ثبت‌شدهٔ بدون نسخه را حفظ می‌کنند تا openclaw plugins update بتواند انتشارهای جدیدتر ClawHub را دنبال کند؛ انتخابگرهای نسخه یا برچسب صریح مانند clawhub:pkg@1.2.3 و clawhub:pkg@beta به همان انتخابگر تثبیت‌شده باقی می‌مانند.

شکل کوتاه بازار

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

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

برای ارسال صریح مبدأ بازار، از --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 وقتی آن فایل مانیفست وجود ندارد)
• بسته‌های سازگار با 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 با --force پشتیبانی نمی‌شود (Pluginهای پیوندی مستقیماً به مسیر مبدأ اشاره می‌کنند، بنابراین چیزی برای بازنویسی در محل وجود ندارد)، همچنین با --marketplace یا نصب‌های git: پشتیبانی نمی‌شود و به یک مسیر محلی ازپیش‌موجود نیاز دارد.

فهرست

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 کامپایل‌شده استفاده می‌کنند.

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

• دستور 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 پیش‌نمایشی از مواردی که حذف خواهند شد چاپ می‌کند و سپس پیش از اعمال تغییرات، پرسش 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 openclaw-codex-app-server --acknowledge-clawhub-riskopenclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install

به‌روزرسانی‌ها روی نصب‌های ردیابی‌شدهٔ Plugin در نمایهٔ مدیریت‌شدهٔ Plugin و نصب‌های ردیابی‌شدهٔ بستهٔ قلاب در hooks.internal.installs اعمال می‌شوند.

بازرسی

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 پاک باشند، پیام هیچ مشکلی در Plugin شناسایی نشد. را چاپ می‌کند. اگر پیکربندی کهنه باقی مانده باشد اما درخت نصب در غیر این صورت سالم باشد، خلاصه همین موضوع را بیان می‌کند و به‌اشتباه سلامت کامل Plugin را القا نمی‌کند.

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

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

رجیستری

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

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

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

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

بازارگاه

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 را فهرست می‌کند. به‌طور پیش‌فرض، ابتدا فید میزبانی‌شده را امتحان می‌کند و در صورت عدم موفقیت، از جدیدترین اسنپ‌شات پذیرفته‌شده یا داده‌های همراه استفاده می‌کند. برای خواندن یک پروفایل پیکربندی‌شدهٔ مشخص از --feed-profile <name>، برای خواندن URL صریح یک فید میزبانی‌شده از --feed-url <url> و برای خواندن جدیدترین اسنپ‌شات پذیرفته‌شده بدون دریافت فید از --offline استفاده کنید.

plugins marketplace refresh اسنپ‌شات فید میزبانی‌شدهٔ پیکربندی‌شده را تازه‌سازی می‌کند و گزارش می‌دهد که آیا OpenClaw داده‌های میزبانی‌شده، یک اسنپ‌شات میزبانی‌شده یا داده‌های همراهِ جایگزین را پذیرفته است. هنگامی که فراخواننده لازم دارد فرمان شکست بخورد مگر اینکه یک محتوای تازهٔ میزبانی‌شده با جمع کنترلی ثابت‌شده مطابقت داشته باشد، از --expected-sha256 استفاده کنید.

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

تازه‌سازی بازار، یک فید میزبانی‌شدهٔ بازار OpenClaw را بارگذاری می‌کند و پاسخ اعتبارسنجی‌شده را به‌عنوان اسنپ‌شات محلی فید میزبانی‌شده ذخیره می‌کند. بدون گزینه‌ها، از پروفایل پیش‌فرض پیکربندی‌شدهٔ فید استفاده می‌کند. برای تازه‌سازی یک پروفایل پیکربندی‌شدهٔ مشخص از --feed-profile <name>، برای تازه‌سازی URL صریح یک فید میزبانی‌شده از --feed-url <url>، برای الزام به مطابقت جمع کنترلی محتوا از --expected-sha256 <sha256> (sha256:<hex> یا یک چکیدهٔ هگزادسیمال ۶۴ نویسه‌ای بدون پیشوند) و برای خروجی قابل‌خواندن توسط ماشین از --json استفاده کنید. URLهای صریح فید میزبانی‌شده نباید شامل اطلاعات احراز هویت، رشته‌های پرس‌وجو یا قطعه‌ها باشند. تازه‌سازی‌های بدون مقدار ثابت می‌توانند بدون شکست فرمان، نتیجهٔ اسنپ‌شات میزبانی‌شده یا داده‌های همراهِ جایگزین را گزارش کنند. تازه‌سازی‌های دارای مقدار ثابت شکست می‌خورند، مگر اینکه یک محتوای تازهٔ میزبانی‌شده را بپذیرند؛ همچنین تازه‌سازی‌های موفق میزبانی‌شده در صورتی شکست می‌خورند که OpenClaw نتواند اسنپ‌شات اعتبارسنجی‌شده را ذخیره کند.

مرتبط

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