> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Saluran rilis

OpenClaw mengirimkan tiga saluran pembaruan:

* **stable**: npm dist-tag `latest`. Direkomendasikan untuk sebagian besar pengguna.
* **beta**: npm dist-tag `beta` saat masih mutakhir; jika beta tidak ada atau lebih lama daripada
  rilis stable terbaru, alur pembaruan kembali menggunakan `latest`.
* **dev**: head bergerak dari `main` (git). npm dist-tag: `dev` (saat dipublikasikan).
  Branch `main` ditujukan untuk eksperimen dan pengembangan aktif. Branch ini dapat berisi
  fitur yang belum lengkap atau perubahan yang merusak kompatibilitas. Jangan gunakan untuk Gateway produksi.

Kami biasanya mengirimkan build stable ke **beta** terlebih dahulu, mengujinya di sana, lalu menjalankan
langkah promosi eksplisit yang memindahkan build yang telah diverifikasi ke `latest` tanpa
mengubah nomor versi. Maintainer juga dapat menerbitkan rilis stable
langsung ke `latest` bila diperlukan. Dist-tag adalah sumber kebenaran untuk instalasi npm.

## Beralih saluran

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
```

`--channel` menyimpan pilihan Anda di config (`update.channel`) dan menyelaraskan
metode instalasi:

* **`stable`** (instalasi paket): diperbarui melalui npm dist-tag `latest`.
* **`beta`** (instalasi paket): mengutamakan npm dist-tag `beta`, tetapi kembali ke
  `latest` saat `beta` tidak ada atau lebih lama daripada tag stable saat ini.
* **`stable`** (instalasi git): checkout tag git stable terbaru, mengecualikan
  tag prarilis semver seperti `-alpha.N`, `-beta.N`, `-rc.N`, `-dev.N`,
  `-next.N`, `-preview.N`, `-canary.N`, `-nightly.N`, dan sufiks prarilis
  lainnya.
* **`beta`** (instalasi git): mengutamakan tag git beta terbaru, tetapi kembali ke
  tag git stable terbaru saat beta tidak ada atau lebih lama.
* **`dev`**: memastikan checkout git (default `~/openclaw`, atau
  `$OPENCLAW_HOME/openclaw` saat `OPENCLAW_HOME` disetel; timpa dengan
  `OPENCLAW_GIT_DIR`), beralih ke `main`, melakukan rebase pada upstream, build, dan
  menginstal CLI global dari checkout tersebut.

<Tip>
  Jika Anda ingin stable dan dev berjalan paralel, simpan dua clone dan arahkan Gateway Anda ke yang stable.
</Tip>

## Menargetkan versi atau tag satu kali

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Install a specific version
openclaw update --tag 2026.4.1-beta.1

# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta

# Switch to the moving GitHub main checkout
openclaw update --channel dev

# Install a specific npm package spec
openclaw update --tag openclaw@2026.4.1-beta.1

# Install from GitHub main once without persisting the channel
openclaw update --tag main
```

Catatan:

* `--tag` berlaku **hanya untuk instalasi paket (npm)**. Instalasi git mengabaikannya.
* Tag tidak disimpan. `openclaw update` Anda berikutnya menggunakan saluran yang dikonfigurasi
  seperti biasa.
* Untuk instalasi paket, OpenClaw melakukan pre-pack spesifikasi sumber GitHub/git ke dalam
  tarball sementara sebelum instalasi npm bertahap. Gunakan `--channel dev` atau
  `--install-method git --version main` saat Anda menginginkan checkout `main`
  bergerak sebagai instalasi persisten.
* Perlindungan downgrade: jika versi target lebih lama daripada versi Anda saat ini,
  OpenClaw meminta konfirmasi (lewati dengan `--yes`).
* `--channel beta` berbeda dari `--tag beta`: alur saluran dapat kembali
  ke stable/latest saat beta tidak ada atau lebih lama, sedangkan `--tag beta` menargetkan
  dist-tag `beta` mentah untuk satu proses tersebut.

## Dry run

Pratinjau apa yang akan dilakukan `openclaw update` tanpa membuat perubahan:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json
```

Dry run menampilkan saluran efektif, versi target, tindakan yang direncanakan, dan
apakah konfirmasi downgrade akan diperlukan.

## Plugin dan saluran

Saat Anda beralih saluran dengan `openclaw update`, OpenClaw juga menyinkronkan sumber
Plugin:

* `dev` mengutamakan Plugin bawaan dari checkout git.
* `stable` dan `beta` memulihkan paket Plugin yang diinstal npm.
* Plugin yang diinstal npm diperbarui setelah pembaruan inti selesai.

## Memeriksa status saat ini

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw update status
```

Menampilkan saluran aktif, jenis instalasi (git atau paket), versi saat ini, dan
sumber (config, tag git, branch git, atau default).

## Praktik terbaik penandaan

* Beri tag pada rilis yang Anda inginkan menjadi tujuan akhir checkout git (`vYYYY.M.PATCH` untuk stable,
  `vYYYY.M.PATCH-beta.N` untuk beta; sufiks prarilis semver bernama seperti
  `-alpha.N`, `-rc.N`, dan `-next.N` bukan target stable).
* Tag stable numerik lama seperti `vYYYY.M.PATCH-1` dan `v1.0.1-1` masih
  dikenali sebagai tag git stable untuk kompatibilitas.
* `vYYYY.M.PATCH.beta.N` juga dikenali untuk kompatibilitas, tetapi lebih baik gunakan `-beta.N`.
* Jaga agar tag tidak berubah: jangan pernah memindahkan atau menggunakan ulang tag.
* npm dist-tag tetap menjadi sumber kebenaran untuk instalasi npm:
  * `latest` -> stable
  * `beta` -> build kandidat atau build stable yang masuk beta terlebih dahulu
  * `dev` -> snapshot main (opsional)

## Ketersediaan aplikasi macOS

Build beta dan dev mungkin **tidak** menyertakan rilis aplikasi macOS. Itu tidak masalah:

* Tag git dan npm dist-tag tetap dapat dipublikasikan.
* Sebutkan "tidak ada build macOS untuk beta ini" di catatan rilis atau changelog.

## Terkait

* [Memperbarui](/id/install/updating)
* [Internal installer](/id/install/installer)