Langsung ke konten utama

​
Memperbarui

Pastikan OpenClaw selalu terbaru.

​
Direkomendasikan: openclaw update

Cara tercepat untuk memperbarui. Perintah ini mendeteksi jenis instalasi Anda (npm atau git), mengambil versi terbaru, menjalankan openclaw doctor, dan memulai ulang gateway. 
openclaw update
Untuk beralih channel atau menargetkan versi tertentu: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # pratinjau tanpa menerapkan
--channel beta memprioritaskan beta, tetapi runtime akan fallback ke stable/latest saat tag beta tidak ada atau lebih lama daripada rilis stable terbaru. Gunakan --tag beta jika Anda ingin npm beta dist-tag mentah untuk pembaruan paket satu kali. Lihat Development channels untuk semantik channel.

​
Alternatif: jalankan ulang installer

curl -fsSL https://openclaw.ai/install.sh | bash
Tambahkan --no-onboard untuk melewati onboarding. Untuk instalasi source, berikan --install-method git --no-onboard.

​
Alternatif: npm, pnpm, atau bun secara manual

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
Auto-updater

Auto-updater nonaktif secara default. Aktifkan di ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
ChannelPerilaku
stableMenunggu stableDelayHours, lalu menerapkan dengan jitter deterministik di sepanjang stableJitterHours (rollout tersebar).
betaMemeriksa setiap betaCheckIntervalHours (default: tiap jam) dan langsung menerapkan.
devTidak ada penerapan otomatis. Gunakan openclaw update secara manual.
Gateway juga mencatat petunjuk pembaruan saat startup (nonaktifkan dengan update.checkOnStart: false).

​
Setelah memperbarui

1
Jalankan doctor
2
openclaw doctor
3
Memigrasikan config, mengaudit kebijakan DM, dan memeriksa kesehatan gateway. Detail: Doctor
4
Mulai ulang gateway
5
openclaw gateway restart
6
Verifikasi
7
openclaw health

​
Rollback

​
Pin versi (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
Tip: npm view openclaw version menampilkan versi yang saat ini dipublikasikan.

​
Pin commit (source)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
Untuk kembali ke versi terbaru: git checkout main && git pull.

​
Jika Anda buntu

  • Jalankan openclaw doctor lagi dan baca output-nya dengan saksama.
  • Untuk openclaw update --channel dev pada checkout source, updater otomatis melakukan bootstrap pnpm bila diperlukan. Jika Anda melihat error bootstrap pnpm/corepack, instal pnpm secara manual (atau aktifkan kembali corepack) lalu jalankan ulang pembaruan.
  • Periksa: Pemecahan masalah
  • Tanyakan di Discord: https://discord.gg/clawd

​
Terkait