Kanal rilis

OpenClaw menyediakan empat saluran pembaruan:

• stable: dist-tag npm latest. Direkomendasikan untuk sebagian besar pengguna.
• extended-stable: dist-tag npm extended-stable. Saluran paket baru dengan bulan dukungan sebelumnya yang masih didukung. Saluran ini hanya untuk paket, dan instalasi hanya dapat dilakukan di latar depan. Pilihan yang tersimpan menerima petunjuk pembaruan hanya-baca saat update.checkOnStart diaktifkan, tetapi tidak pernah menerapkannya secara otomatis.
• beta: dist-tag npm beta. Beralih ke latest sebagai fallback saat beta tidak tersedia atau lebih lama daripada rilis stabil saat ini.
• dev: ujung bergerak dari main (git). dist-tag npm dev saat dipublikasikan. main ditujukan untuk eksperimen dan pengembangan aktif; saluran ini mungkin berisi fitur yang belum lengkap atau perubahan yang merusak kompatibilitas. Jangan menjalankannya untuk Gateway produksi.

Build stabil biasanya dirilis ke beta terlebih dahulu, diperiksa di sana, lalu dipromosikan ke latest tanpa menaikkan versi. Pengelola juga dapat mempublikasikan langsung ke latest. Dist-tag merupakan sumber kebenaran untuk instalasi npm.

Beralih saluran

openclaw update --channel stableopenclaw update --channel extended-stableopenclaw update --channel betaopenclaw update --channel dev

--channel menyimpan pilihan ke update.channel dalam konfigurasi dan mengendalikan kedua jalur instalasi:

Untuk instalasi git dev, checkout default adalah ~/openclaw (atau $OPENCLAW_HOME/openclaw saat OPENCLAW_HOME ditetapkan); timpa dengan OPENCLAW_GIT_DIR.

Menargetkan versi atau tag satu kali

Gunakan --tag untuk menargetkan dist-tag, versi, atau spesifikasi paket tertentu untuk satu pembaruan tanpa mengubah saluran yang tersimpan:

# Instal versi tertentuopenclaw update --tag 2026.4.1-beta.1 # Instal dari dist-tag beta (satu kali, tidak disimpan)openclaw update --tag beta # Beralih ke checkout utama GitHub yang bergerak (persisten)openclaw update --channel dev # Instal spesifikasi paket npm tertentuopenclaw update --tag openclaw@2026.4.1-beta.1 # Instal dari GitHub main sekali tanpa menyimpan saluranopenclaw update --tag main

Catatan:

• --tag hanya berlaku untuk instalasi paket (npm); instalasi git mengabaikannya.
• Tag tidak disimpan; openclaw update berikutnya menggunakan saluran yang dikonfigurasi.
• --tag main dipetakan ke spesifikasi yang kompatibel dengan npm github:openclaw/openclaw#main untuk satu eksekusi tersebut. Untuk instalasi main bergerak yang persisten, gunakan openclaw update --channel dev (instalasi paket beralih ke checkout git) atau instal ulang dengan metode git penginstal: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --version main. Jalur instalasi npm menolak target sumber GitHub/git sepenuhnya dan sebagai gantinya mengarahkan Anda ke metode git.
• Perlindungan penurunan versi: jika versi target lebih lama daripada versi saat ini, OpenClaw meminta konfirmasi (lewati dengan --yes).
• Extended-stable selalu menggunakan target paket persis yang telah diverifikasi. Saluran ini bukan alias satu kali untuk --tag extended-stable, dan --tag tidak dapat digabungkan dengan saluran extended-stable yang efektif.
• --channel beta berbeda dari --tag beta: alur saluran dapat beralih ke stable/latest sebagai fallback saat beta tidak tersedia atau lebih lama, sedangkan --tag beta selalu menargetkan dist-tag beta mentah untuk satu eksekusi tersebut.

Simulasi

Pratinjau tindakan yang akan dilakukan openclaw update tanpa membuat perubahan:

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

Simulasi melaporkan saluran efektif, versi target, tindakan yang direncanakan, dan apakah konfirmasi penurunan versi diperlukan.

Plugin dan saluran

Beralih saluran dengan openclaw update juga menyinkronkan sumber Plugin:

• dev mengalihkan Plugin terinstal yang memiliki padanan bawaan kembali ke sumber bawaannya (checkout git).
• stable dan beta memulihkan paket Plugin yang diinstal melalui npm atau ClawHub.
• extended-stable menyelesaikan Plugin npm resmi yang memenuhi syarat dengan maksud kosong/default atau latest ke versi inti terinstal yang persis. Saluran ini tidak meminta tag Plugin @extended-stable pada waktu proses.
• Plugin yang diinstal melalui npm diperbarui setelah pembaruan inti selesai.

Memeriksa status saat ini

openclaw update status

Menampilkan saluran aktif (beserta sumber yang menentukannya: konfigurasi, tag git, cabang git, versi terinstal, atau default), jenis instalasi (git atau paket), versi saat ini, dan ketersediaan pembaruan.

Praktik terbaik pemberian tag

• Beri tag pada rilis yang ingin Anda jadikan tujuan checkout git: vYYYY.M.PATCH untuk stabil, vYYYY.M.PATCH-beta.N untuk beta. Sufiks prarilis bernama seperti -alpha.N, -rc.N, dan -next.N bukan target stabil atau beta.
• Tag stabil numerik lama seperti vYYYY.M.PATCH-1 dan v1.0.1-1 masih dikenali sebagai tag git stabil demi kompatibilitas.
• vYYYY.M.PATCH.beta.N (dipisahkan titik) juga dikenali demi kompatibilitas; utamakan -beta.N.
• Pertahankan tag agar tidak berubah: jangan pernah memindahkan atau menggunakan ulang tag.
• Dist-tag npm tetap menjadi sumber kebenaran untuk instalasi npm:
  • latest -> stabil
  • extended-stable -> rilis paket bulan dukungan sebelumnya yang masih didukung
  • beta -> build kandidat atau build stabil yang dirilis ke beta terlebih dahulu
  • dev -> snapshot main (opsional)

Ketersediaan aplikasi macOS

Build beta dan dev mungkin tidak menyertakan rilis aplikasi macOS. Hal tersebut tidak masalah:

• Tag git dan dist-tag npm tetap dapat dipublikasikan secara terpisah.
• Nyatakan "tidak ada build macOS untuk beta ini" dalam catatan rilis atau log perubahan.

Terkait

• Memperbarui
• Internal penginstal