Langsung ke konten utama

​
Persyaratan sistem

  • Node 24 (direkomendasikan) atau Node 22.19+ - 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 onboarding.
Pengguna desktop Windows juga dapat menginstal aplikasi pendamping native Windows Hub, yang mencakup penyiapan, status tray, chat, mode node, dan mode MCP lokal.
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 Internal penginstal.

​
Metode instalasi alternatif

​
Penginstal prefiks lokal (install-cli.sh)

Gunakan ini saat Anda ingin OpenClaw dan Node disimpan di bawah prefiks lokal seperti ~/.openclaw, tanpa bergantung pada instalasi Node di seluruh sistem: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Ini mendukung instalasi npm secara default, ditambah instalasi git-checkout dalam alur prefiks yang sama. Referensi lengkap: Internal penginstal. Sudah terinstal? Beralih antara instalasi paket dan git dengan openclaw update --channel dev dan openclaw update --channel stable. Lihat Memperbarui.

​
npm, pnpm, atau bun

Jika Anda sudah mengelola Node sendiri: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Penginstal hosted menghapus filter kesegaran 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: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Atau lewati link dan gunakan pnpm openclaw ... dari dalam repo. Lihat Penyiapan untuk alur kerja pengembangan lengkap.

​
Instal dari checkout utama GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

​
Container dan manajer paket

Docker

Deployment berbasis container atau tanpa antarmuka grafis.

Podman

Alternatif container rootless untuk Docker.

Nix

Instalasi deklaratif melalui Nix flake.

Ansible

Provisioning fleet otomatis.

Bun

Penggunaan khusus CLI melalui runtime Bun.

​
Verifikasi instalasi

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
Jika Anda ingin 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 tugas ditolak

​
Hosting dan deployment

Deploy OpenClaw di server cloud atau VPS:

VPS

VPS Linux apa pun.

Docker VM

Langkah Docker bersama.

Kubernetes

Deployment K8s.

Fly.io

Deploy di Fly.io.

Hetzner

Deployment Hetzner.

GCP

Deployment Google Cloud.

Azure

Deployment Azure.

Railway

Deployment Railway.

Render

Deployment Render.

Northflank

Deployment Northflank.

​
Perbarui, migrasikan, atau hapus instalasi

Updating

Selalu perbarui OpenClaw.

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 installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
Jika $(npm prefix -g)/bin tidak ada di $PATH Anda, tambahkan ke file startup shell Anda (~/.zshrc atau ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Lalu buka terminal baru. Lihat Penyiapan Node untuk detail selengkapnya.