Langsung ke konten utama

​
Instal

​
Direkomendasikan: skrip installer

Cara tercepat untuk menginstal. Skrip ini mendeteksi OS Anda, menginstal Node jika diperlukan, menginstal OpenClaw, dan meluncurkan onboarding. 
curl -fsSL https://openclaw.ai/install.sh | bash
Untuk menginstal tanpa menjalankan onboarding: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Untuk semua flag dan opsi CI/otomasi, lihat Installer internals.

​
Persyaratan sistem

  • Node 24 (direkomendasikan) atau Node 22.14+ — skrip installer menangani ini secara otomatis
  • macOS, Linux, atau Windows — baik Windows native maupun WSL2 didukung; WSL2 lebih stabil. Lihat Windows.
  • pnpm hanya diperlukan jika Anda build dari source

​
Metode instalasi alternatif

​
Installer prefix lokal (install-cli.sh)

Gunakan ini jika Anda ingin OpenClaw dan Node tetap berada di bawah prefix lokal seperti ~/.openclaw, tanpa bergantung pada instalasi Node tingkat sistem: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Installer ini mendukung instalasi npm secara default, ditambah instalasi checkout git dalam alur prefix yang sama. Referensi lengkap: Installer internals.

​
npm, pnpm, atau bun

Jika Anda sudah mengelola Node sendiri: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Jika sharp gagal karena libvips yang terinstal secara global:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Dari source

Untuk kontributor atau siapa pun yang ingin menjalankan dari checkout lokal: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
Atau lewati link dan gunakan pnpm openclaw ... dari dalam repo. Lihat Setup untuk alur kerja pengembangan lengkap.

​
Instal dari GitHub main

npm install -g github:openclaw/openclaw#main

​
Container dan package manager

Docker

Deployment terkontainerisasi atau headless.

Podman

Alternatif container rootless untuk Docker.

Nix

Instalasi deklaratif melalui Nix flake.

Ansible

Provisioning armada otomatis.

Bun

Penggunaan khusus CLI melalui runtime Bun.

​
Verifikasi instalasi

openclaw --version      # konfirmasi CLI tersedia
openclaw doctor         # periksa masalah konfigurasi
openclaw gateway status # verifikasi Gateway sedang berjalan
Jika Anda menginginkan startup 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 terlebih dahulu, dengan fallback item login folder Startup per pengguna jika pembuatan task ditolak

​
Hosting dan deployment

Deploy OpenClaw di server cloud atau VPS:

VPS

Linux VPS apa pun

Docker VM

Langkah Docker bersama

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Perbarui, migrasikan, atau hapus instalasi

Updating

Jaga OpenClaw tetap terbaru.

Migrating

Pindah ke mesin baru.

Uninstall

Hapus OpenClaw sepenuhnya.

​
Pemecahan masalah: openclaw tidak ditemukan

Jika instalasi berhasil tetapi openclaw tidak ditemukan di terminal Anda: 
node -v           # Node terinstal?
npm prefix -g     # Di mana paket global berada?
echo "$PATH"      # Apakah direktori bin global ada di PATH?
Jika $(npm prefix -g)/bin tidak ada di $PATH Anda, tambahkan ke file startup shell (~/.zshrc atau ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Lalu buka terminal baru. Lihat Node setup untuk detail lebih lanjut.