Skip to main content

​
Persyaratan sistem

  • Node 22.22.3+, 24.15+, atau 25.9+ - Node 24 adalah target default; skrip penginstal menanganinya secara otomatis.
  • macOS, Linux, atau Windows - Pengguna Windows dapat memulai dengan aplikasi Windows Hub native, penginstal CLI PowerShell, atau Gateway WSL2. Lihat Windows.
  • pnpm hanya diperlukan jika Anda membangun dari sumber.

​
Direkomendasikan: skrip penginstal

Cara tercepat untuk menginstal. Skrip ini mendeteksi OS Anda, menginstal Node jika diperlukan, menginstal OpenClaw, dan menjalankan orientasi awal.
Pengguna desktop Windows juga dapat menginstal aplikasi pendamping Windows Hub native, yang mencakup penyiapan, status baki sistem, obrolan, mode node, dan mode MCP lokal.
Untuk menginstal tanpa menjalankan orientasi awal:
Untuk semua flag dan opsi CI/otomatisasi, lihat Cara kerja internal penginstal.

​
Metode instalasi alternatif

​
Penginstal prefiks lokal (install-cli.sh)

Gunakan ini jika Anda ingin menyimpan OpenClaw dan Node di bawah prefiks lokal seperti ~/.openclaw, tanpa bergantung pada instalasi Node di seluruh sistem:
Secara default, penginstal ini mendukung instalasi npm, serta instalasi checkout git dalam alur prefiks yang sama. Referensi lengkap: Cara kerja internal penginstal. Sudah terinstal? Beralihlah antara instalasi paket dan git dengan openclaw update --channel dev dan openclaw update --channel stable. Lihat Pembaruan.

​
npm, pnpm, atau bun

Jika Anda sudah mengelola Node sendiri:
Penginstal yang dihosting menghapus filter kebaruan npm seperti min-release-age untuk instalasi paket OpenClaw. Jika Anda menginstal secara manual dengan npm, kebijakan npm Anda sendiri tetap berlaku.

​
Dari sumber

Untuk kontributor atau siapa pun yang ingin menjalankan dari checkout lokal:
Atau lewati penautan dan gunakan pnpm openclaw ... dari dalam repo. Lihat Penyiapan untuk alur kerja pengembangan lengkap.

​
Instal dari checkout main GitHub

​
Kontainer dan pengelola paket

Docker

Deployment dalam kontainer atau tanpa antarmuka grafis.

Podman

Alternatif kontainer tanpa root untuk Docker.

Nix

Instalasi deklaratif melalui flake Nix.

Ansible

Penyediaan armada otomatis.

Bun

Penginstal dependensi dan pelaksana skrip paket opsional.

​
Verifikasi instalasi

Jika Anda menginginkan proses mulai terkelola setelah instalasi:
  • macOS: LaunchAgent melalui openclaw onboard --install-daemon atau openclaw gateway install
  • Linux/WSL2: layanan pengguna systemd melalui perintah yang sama
  • Windows native: Scheduled Task sebagai pilihan pertama, dengan item masuk folder Startup per pengguna sebagai cadangan jika pembuatan tugas ditolak

​
Hosting dan deployment

Deploy OpenClaw pada server cloud atau VPS. Lihat Server Linux untuk pemilih penyedia lengkap (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi, dan lainnya), atau lakukan deployment secara deklaratif di Render.

VPS

Pilih penyedia.

VM Docker

Langkah-langkah Docker bersama.

Kubernetes

Deployment K8s.

​
Perbarui, migrasikan, atau hapus instalasi

Pembaruan

Pastikan OpenClaw selalu terbaru.

Migrasi

Pindahkan ke mesin baru.

Hapus Instalasi

Hapus OpenClaw sepenuhnya.

​
Pemecahan masalah: openclaw tidak ditemukan

Hampir selalu merupakan masalah PATH: direktori bin global npm tidak ada di PATH shell Anda. Lihat Pemecahan masalah Node.js untuk perbaikan lengkap, termasuk jalur Windows.