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.

​
Persyaratan sistem

  • Node 24 (direkomendasikan) atau Node 22.16+ - skrip penginstal menanganinya secara otomatis
  • macOS, Linux, atau Windows - Windows native dan WSL2 didukung; WSL2 lebih stabil. 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. 
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 tingkat sistem: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Penginstal ini mendukung instalasi npm secara default, ditambah instalasi git-checkout di bawah 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
Jika sharp gagal karena libvips yang terinstal secara global:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
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 GitHub main

npm install -g github:openclaw/openclaw#main

​
Container dan manajer paket

Docker

Deployment ter-container atau headless.

Podman

Alternatif container rootless untuk Docker.

Nix

Instalasi deklaratif melalui Nix flake.

Ansible

Penyediaan fleet otomatis.

Bun

Penggunaan hanya CLI melalui runtime Bun.

​
Verifikasi instalasi

openclaw --version      # konfirmasi CLI tersedia
openclaw doctor         # periksa masalah konfigurasi
openclaw gateway status # verifikasi Gateway berjalan
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

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Perbarui, migrasikan, atau hapus instalasi

Memperbarui

Jaga OpenClaw tetap terbaru.

Bermigrasi

Pindah ke mesin baru.

Hapus instalasi

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 Anda (~/.zshrc atau ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Lalu buka terminal baru. Lihat Penyiapan Node untuk detail lebih lanjut.