Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Selalu perbarui OpenClaw.

​
Direkomendasikan: openclaw update

Cara tercepat untuk memperbarui. Ini mendeteksi jenis instalasi Anda (npm atau git), mengambil versi terbaru, menjalankan openclaw doctor, dan memulai ulang Gateway. 
openclaw update
Untuk beralih kanal atau menargetkan versi tertentu: 
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag main
openclaw update --dry-run   # preview without applying
openclaw update tidak menerima --verbose. Untuk diagnostik pembaruan, gunakan --dry-run untuk mempratinjau tindakan yang direncanakan, --json untuk hasil terstruktur, atau openclaw update status --json untuk memeriksa status kanal dan ketersediaan. Installer memiliki flag --verbose sendiri, tetapi flag tersebut bukan bagian dari openclaw update. --channel beta memprioritaskan beta, tetapi runtime kembali ke stable/latest ketika tag beta tidak ada atau lebih lama daripada rilis stabil terbaru. Gunakan --tag beta jika Anda menginginkan dist-tag beta npm mentah untuk pembaruan paket sekali jalan. Untuk Plugin terkelola, fallback kanal beta adalah peringatan: pembaruan inti masih dapat berhasil sementara sebuah Plugin menggunakan rilis default/latest yang tercatat karena tidak ada beta Plugin yang tersedia. Lihat Kanal pengembangan untuk semantik kanal.

​
Beralih antara instalasi npm dan git

Gunakan kanal saat Anda ingin mengubah jenis instalasi. Updater mempertahankan status, konfigurasi, kredensial, dan workspace Anda di ~/.openclaw; ia hanya mengubah instalasi kode OpenClaw yang digunakan CLI dan Gateway. 
# npm package install -> editable git checkout
openclaw update --channel dev

# git checkout -> npm package install
openclaw update --channel stable
Jalankan dengan --dry-run terlebih dahulu untuk mempratinjau pengalihan mode instalasi yang tepat: 
openclaw update --channel dev --dry-run
openclaw update --channel stable --dry-run
Kanal dev memastikan checkout git, membangunnya, dan menginstal CLI global dari checkout tersebut. Kanal stable dan beta menggunakan instalasi paket. Jika Gateway sudah terinstal, openclaw update menyegarkan metadata layanan dan memulai ulangnya kecuali Anda meneruskan --no-restart.

​
Alternatif: jalankan ulang installer

curl -fsSL https://openclaw.ai/install.sh | bash
Tambahkan --no-onboard untuk melewati onboarding. Untuk memaksa jenis instalasi tertentu melalui installer, teruskan --install-method git --no-onboard atau --install-method npm --no-onboard. Jika openclaw update gagal setelah fase instalasi paket npm, jalankan ulang installer. Installer tidak memanggil updater lama; ia menjalankan instalasi paket global secara langsung dan dapat memulihkan instalasi npm yang diperbarui sebagian. 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm
Untuk mengunci pemulihan ke versi atau dist-tag tertentu, tambahkan --version: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

​
Alternatif: npm, pnpm, atau bun manual

npm i -g openclaw@latest
Utamakan openclaw update untuk instalasi yang diawasi karena ia dapat mengoordinasikan pertukaran paket dengan layanan Gateway yang sedang berjalan. Jika Anda memperbarui secara manual saat Gateway terkelola sedang berjalan, segera mulai ulang Gateway setelah package manager selesai agar proses lama tidak terus melayani dari file paket yang sudah diganti. Saat openclaw update mengelola instalasi npm global, ia menginstal target ke prefix npm sementara terlebih dahulu, memverifikasi inventaris dist yang dipaketkan, lalu menukar pohon paket bersih ke prefix global sebenarnya. Ini menghindari npm menumpuk paket baru di atas file usang dari paket lama. Jika perintah instalasi gagal, OpenClaw mencoba sekali lagi dengan --omit=optional. Percobaan ulang itu membantu host tempat dependensi opsional native tidak dapat dikompilasi, sambil tetap menampilkan kegagalan asli jika fallback juga gagal. 
pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
Topik lanjutan instalasi npm

OpenClaw memperlakukan instalasi global yang dipaketkan sebagai hanya-baca saat runtime, bahkan ketika direktori paket global dapat ditulis oleh pengguna saat ini. Instalasi paket Plugin berada di root npm/git milik OpenClaw di bawah direktori konfigurasi pengguna, dan startup Gateway tidak memutasi pohon paket OpenClaw.Beberapa pengaturan npm Linux menginstal paket global di bawah direktori milik root seperti /usr/lib/node_modules/openclaw. OpenClaw mendukung tata letak itu karena perintah instalasi/pembaruan Plugin menulis di luar direktori paket global tersebut.
Beri OpenClaw akses tulis ke root konfigurasi/statusnya agar instalasi Plugin eksplisit, pembaruan Plugin, dan pembersihan doctor dapat mempertahankan perubahannya:
ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp
Sebelum pembaruan paket dan instalasi Plugin eksplisit, OpenClaw mencoba pemeriksaan ruang disk upaya terbaik untuk volume target. Ruang rendah menghasilkan peringatan dengan path yang diperiksa, tetapi tidak memblokir pembaruan karena kuota sistem file, snapshot, dan volume jaringan dapat berubah setelah pemeriksaan. Instalasi package-manager aktual dan verifikasi pascainstalasi tetap otoritatif.

​
Auto-updater

Auto-updater nonaktif secara default. Aktifkan di ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
KanalPerilaku
stableMenunggu stableDelayHours, lalu menerapkan dengan jitter deterministik di seluruh stableJitterHours (rollout tersebar).
betaMemeriksa setiap betaCheckIntervalHours (default: setiap 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). Untuk downgrade atau pemulihan insiden, tetapkan OPENCLAW_NO_AUTO_UPDATE=1 di environment Gateway untuk memblokir penerapan otomatis bahkan ketika update.auto.enabled dikonfigurasi. Petunjuk pembaruan startup masih dapat berjalan kecuali update.checkOnStart juga dinonaktifkan. Pembaruan package-manager yang diminta melalui handler control-plane Gateway langsung memaksa restart pembaruan tanpa penundaan dan tanpa cooldown setelah pertukaran paket. Ini menghindari proses lama di memori tetap ada cukup lama untuk lazy-load chunk dari pohon paket yang sudah diganti. Shell openclaw update tetap menjadi jalur yang disarankan untuk instalasi yang diawasi karena dapat menghentikan dan memulai ulang layanan di sekitar pembaruan.

​
Setelah memperbarui

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

​
Rollback

​
Kunci versi (npm)

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

​
Kunci commit (sumber)

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 terbaru: git checkout main && git pull.

​
Jika Anda buntu

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

​
Terkait