English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

کانال‌های انتشار

Edit source

OpenClaw سه کانال به‌روزرسانی ارائه می‌کند:

  • stable: npm dist-tag latest. برای بیشتر کاربران توصیه می‌شود.
  • beta: npm dist-tag beta وقتی به‌روز باشد؛ اگر beta وجود نداشته باشد یا از آخرین انتشار stable قدیمی‌تر باشد، جریان به‌روزرسانی به latest برمی‌گردد.
  • dev: سرِ در حال حرکت main (git). npm dist-tag: dev (وقتی منتشر شده باشد). شاخه main برای آزمایش و توسعه فعال است. ممکن است شامل قابلیت‌های ناتمام یا تغییرات ناسازگار باشد. از آن برای Gatewayهای تولیدی استفاده نکنید.

ما معمولا ساخت‌های stable را ابتدا به beta منتشر می‌کنیم، آن‌ها را آنجا آزمایش می‌کنیم، سپس یک گام ارتقای صریح اجرا می‌کنیم که ساخت بررسی‌شده را بدون تغییر شماره نسخه به latest منتقل می‌کند. نگهدارندگان همچنین می‌توانند در صورت نیاز یک انتشار stable را مستقیما به latest منتشر کنند. Dist-tagها منبع حقیقت برای نصب‌های npm هستند.

تغییر کانال‌ها

bash
openclaw update --channel stableopenclaw update --channel betaopenclaw update --channel dev

--channel انتخاب شما را در پیکربندی (update.channel) ذخیره می‌کند و روش نصب را هم‌راستا می‌کند:

  • stable (نصب‌های بسته): از طریق npm dist-tag latest به‌روزرسانی می‌شود.
  • beta (نصب‌های بسته): npm dist-tag beta را ترجیح می‌دهد، اما وقتی beta وجود ندارد یا از برچسب stable فعلی قدیمی‌تر است، به latest برمی‌گردد.
  • stable (نصب‌های git): آخرین برچسب git مربوط به stable را checkout می‌کند.
  • beta (نصب‌های git): آخرین برچسب git مربوط به beta را ترجیح می‌دهد، اما وقتی beta وجود ندارد یا قدیمی‌تر است، به آخرین برچسب git مربوط به stable برمی‌گردد.
  • dev: یک checkout از git را تضمین می‌کند (پیش‌فرض ~/openclaw، قابل بازنویسی با OPENCLAW_GIT_DIR)، به main تغییر می‌دهد، روی upstream rebase می‌کند، می‌سازد، و CLI سراسری را از همان checkout نصب می‌کند.

هدف‌گذاری نسخه یا برچسب یک‌باره

از --tag برای هدف‌گذاری یک dist-tag، نسخه، یا مشخصات بسته خاص در یک به‌روزرسانی بدون تغییر کانال ذخیره‌شده خود استفاده کنید:

bash
# Install a specific versionopenclaw update --tag 2026.4.1-beta.1 # Install from the beta dist-tag (one-off, does not persist)openclaw update --tag beta # Install from GitHub main branch (npm tarball)openclaw update --tag main # Install a specific npm package specopenclaw update --tag openclaw@2026.4.1-beta.1

نکته‌ها:

  • --tag فقط برای نصب‌های بسته (npm) اعمال می‌شود. نصب‌های Git آن را نادیده می‌گیرند.
  • برچسب ذخیره نمی‌شود. اجرای بعدی openclaw update طبق معمول از کانال پیکربندی‌شده شما استفاده می‌کند.
  • محافظت در برابر downgrade: اگر نسخه هدف از نسخه فعلی شما قدیمی‌تر باشد، OpenClaw برای تایید از شما می‌پرسد (با --yes رد کنید).
  • --channel beta با --tag beta متفاوت است: جریان کانال می‌تواند وقتی beta وجود ندارد یا قدیمی‌تر است به stable/latest برگردد، در حالی که --tag beta برای همان یک اجرا dist-tag خام beta را هدف می‌گیرد.

Dry run

پیش‌نمایش کنید که openclaw update بدون اعمال تغییرات چه کاری انجام می‌دهد:

bash
openclaw update --dry-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw update --dry-run --json

dry run کانال موثر، نسخه هدف، اقدام‌های برنامه‌ریزی‌شده، و اینکه آیا تایید downgrade لازم است یا نه را نشان می‌دهد.

Pluginها و کانال‌ها

وقتی با openclaw update کانال را تغییر می‌دهید، OpenClaw منبع‌های Plugin را هم همگام‌سازی می‌کند:

  • dev، Pluginهای همراه از checkout git را ترجیح می‌دهد.
  • stable و beta بسته‌های Plugin نصب‌شده با npm را بازیابی می‌کنند.
  • Pluginهای نصب‌شده با npm پس از تکمیل به‌روزرسانی core به‌روزرسانی می‌شوند.

بررسی وضعیت فعلی

bash
openclaw update status

کانال فعال، نوع نصب (git یا بسته)، نسخه فعلی، و منبع (پیکربندی، برچسب git، شاخه git، یا پیش‌فرض) را نشان می‌دهد.

بهترین روش‌های برچسب‌گذاری

  • انتشارهایی را که می‌خواهید checkoutهای git روی آن‌ها قرار بگیرند برچسب بزنید (vYYYY.M.D برای stable، vYYYY.M.D-beta.N برای beta).
  • vYYYY.M.D.beta.N نیز برای سازگاری تشخیص داده می‌شود، اما -beta.N را ترجیح دهید.
  • برچسب‌های قدیمی vYYYY.M.D-<patch> همچنان به‌عنوان stable (غیر beta) تشخیص داده می‌شوند.
  • برچسب‌ها را تغییرناپذیر نگه دارید: هرگز برچسبی را جابه‌جا یا دوباره استفاده نکنید.
  • npm dist-tagها همچنان منبع حقیقت برای نصب‌های npm هستند:
    • latest -> stable
    • beta -> ساخت کاندید یا ساخت stable با انتشار اولیه در beta
    • dev -> snapshot شاخه main (اختیاری)

در دسترس بودن برنامه macOS

ساخت‌های beta و dev ممکن است شامل انتشار برنامه macOS نباشند. این مشکلی ندارد:

  • برچسب git و npm dist-tag همچنان می‌توانند منتشر شوند.
  • در یادداشت‌های انتشار یا changelog ذکر کنید «برای این beta ساخت macOS وجود ندارد».

مرتبط

Was this useful?