Plugin reference
بازنویسیهای نصب Plugin
لغوهای نصب Plugin به نگهدارندگان اجازه میدهند نصب Plugin در زمان راهاندازی را بهجای کاتالوگ، بستهٔ همراه، یا منبع پیشفرض npm، به یک بستهٔ مشخص npm یا فایل tarball محلی ساختهشده با npm pack هدایت کنند. این لغوها فقط برای E2E و اعتبارسنجی بستهها وجود دارند؛ کاربران عادی Pluginها را با openclaw plugins install نصب میکنند.
محیط
لغوها غیرفعال هستند، مگر اینکه هر دو متغیر تنظیم شده باشند:
export OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1export OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{ "codex": "npm-pack:/tmp/openclaw-codex-2026.5.8.tgz", "openclaw-web-search": "npm:@openclaw/web-search@2026.5.8"}'نگاشت لغوها یک JSON با کلید شناسهٔ Plugin است. مقادیر از موارد زیر پشتیبانی میکنند:
| پیشوند | منبع |
|---|---|
npm:<registry-spec> |
بستههای رجیستری، نسخههای دقیق، یا برچسبها |
npm-pack:<path.tgz> |
فایلهای tarball محلی تولیدشده توسط npm pack؛ مسیرهای نسبی از دایرکتوری کاری فعلی تفکیک میشوند |
رفتار
هنگامی که یک جریان زمان راهاندازی Pluginی را نصب میکند که شناسهاش در نگاشت وجود دارد، OpenClaw بهجای کاتالوگ، بستهٔ همراه، یا منبع پیشفرض npm از منبع لغو استفاده میکند. این رفتار برای پذیرش اولیه و هر جریان دیگری که از نصبکنندهٔ مشترک Plugin در زمان راهاندازی استفاده میکند، اعمال میشود.
- لغوها همچنان شناسهٔ مورد انتظار Plugin را اعمال میکنند: فایل tarball نگاشتشده به
codexباید Pluginی را نصب کند که شناسهٔ مانیفست آنcodexاست. - لغوها وضعیت رسمی منبع مورد اعتماد را به ارث نمیبرند. حتی وقتی ورودی کاتالوگ معمولاً نمایانگر بستهای متعلق به OpenClaw است، لغو بهعنوان ورودی آزمایشی ارائهشده توسط اپراتور در نظر گرفته میشود.
- فایلهای
.envفضای کاری نمیتوانند لغوهای نصب را فعال کنند؛ هر دو متغیر محیطی در فهرست مسدودشدهٔ dotenv فضای کاری قرار دارند. آنها را در پوستهٔ مورد اعتماد، کار CI، یا فرمان آزمایش راهدوری که OpenClaw را اجرا میکند، تنظیم کنید.
E2E بسته
از یک دایرکتوری وضعیت ایزوله استفاده کنید تا نصب بستهها و رکوردهای نصب به وضعیت عادی OpenClaw شما دست نزنند:
npm pack extensions/codex --pack-destination /tmp OPENCLAW_STATE_DIR="$(mktemp -d)" \OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1 \OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{"codex":"npm-pack:/tmp/openclaw-codex-2026.5.8.tgz"}' \pnpm openclaw onboard --mode localبستهٔ نصبشده را در دایرکتوری وضعیت تأیید کنید:
find "$OPENCLAW_STATE_DIR/npm/projects" -path '*/node_modules/@openclaw/codex/package.json' -printgrep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.jsonبرای E2E زندهٔ ارائهدهنده، کلید واقعی API را پیش از اجرای فرمان آزمایش از یک پوستهٔ مورد اعتماد یا راز CI بارگذاری کنید. کلیدها را چاپ نکنید؛ فقط منبع و موجود بودن کلید را گزارش دهید.
