OpenClaw adalah alat lokal yang memungkinkan AI agent Anda terhubung ke aplikasi seperti Telegram atau WhatsApp dan melakukan tindakan, seperti mengirim pesan atau menangani tugas. Penyiapannya cukup mudah setelah Anda memahami prosesnya. Panduan ini mencakup instalasi di macOS, Linux, dan Windows.
Ringkasan singkat opsi penyiapan OpenClaw
Pilih penyiapan yang sesuai dengan kebutuhan Anda. Menjalankan OpenClaw secara lokal membuat semuanya tetap berada di mesin Anda sendiri dan memerlukan instalasi dependensi seperti npm atau penggunaan skrip otomatis. Jika ingin melewati penyiapan, platform yang dihosting sepenuhnya seperti Kimi Claw menangani lingkungannya untuk Anda, sehingga Anda bisa langsung mulai.
| macOS / Linux | Windows | |
|---|---|---|
| Jalankan secara lokal | Perintah Terminal satu baris | Perintah PowerShell satu baris |
| Melalui npm | Melalui npm | |
| Melalui Homebrew | Melalui WSL2 | |
| Jalankan online | Solusi berbasis cloud (mis., Kimi Claw) | Solusi berbasis cloud (mis., Kimi Claw) |
Cara menginstal OpenClaw di macOS dan Linux
macOS dan Linux menggunakan installer serta perintah yang sama. Petunjuk ini berlaku untuk kedua sistem kecuali dinyatakan lain.
Berikut panduan penyiapan singkat. Untuk panduan langkah demi langkah lengkap dengan tangkapan layar, lihat Cara menginstal OpenClaw di macOS.
Metode 1: Gunakan skrip installer satu baris
Langkah 1: Jalankan skrip instalasi di Terminal
Jalankan skrip installer resmi untuk menyiapkan OpenClaw. Skrip ini memeriksa apakah Node.js 22 atau yang lebih baru sudah terinstal. Jika belum ada atau sudah usang, Node.js 24 akan diinstal otomatis. Setelah itu, skrip menginstal OpenClaw CLI dan membuka wizard onboarding.
Langkah 2: Selesaikan wizard onboarding
Ikuti wizard onboarding untuk menyiapkan lingkungan agent Anda, termasuk memilih penyedia model (mis., Kimi API), memasukkan API key, memilih channel, dan mengonfigurasi pengaturan dasar.
Langkah 3: Periksa instalasi Anda
Jalankan perintah berikut untuk memastikan versi OpenClaw Anda.
Langkah 4: Verifikasi gateway dan selesaikan penyiapan
Jalankan perintah berikut untuk memeriksa bahwa gateway OpenClaw aktif.
Installer juga mendaftarkan LaunchAgent di macOS atau layanan systemd di Linux, sehingga OpenClaw terus berjalan di latar belakang. Setelah semuanya siap, agent Anda siap digunakan. Anda dapat mulai mengobrol, menghubungkan alat, atau mengonfigurasi workflow sesuai kebutuhan.
Metode 2: Instal dengan Homebrew
Langkah 1: Instal atau tingkatkan Node.js
Gunakan Homebrew untuk menginstal Node.js dengan menjalankan perintah berikut di Terminal. Jika Node.js sudah terinstal, jalankan perintah upgrade agar Anda menggunakan versi terbaru.
Langkah 2: Instal OpenClaw CLI
Jalankan perintah berikut untuk menginstal OpenClaw CLI secara global.
Langkah 3: Jalankan onboarding dan siapkan daemon
Jalankan perintah berikut untuk membuka wizard onboarding dan mendaftarkan daemon latar belakang. Ikuti wizard untuk mengonfigurasi lingkungan agent Anda, termasuk memilih penyedia model (mis., Kimi API), memasukkan API key, dan menghubungkan channel perpesanan. Setelah penyiapan selesai, agent Anda siap digunakan. Anda dapat mulai mengobrol, menghubungkan alat, atau mengonfigurasi workflow sesuai kebutuhan.
Metode 3: Instal dengan npm
Langkah 1: Verifikasi versi runtime
Jalankan perintah berikut untuk memastikan Node.js 22.14 atau yang lebih baru sudah terinstal di sistem Anda. Jika versi Anda sudah mutakhir, Anda dapat melanjutkan instalasi.
Langkah 2: Instal OpenClaw CLI
Jalankan perintah berikut untuk menginstal OpenClaw CLI secara global.
Langkah 3: Jalankan onboarding dan aktifkan persistensi
Jalankan perintah berikut untuk memulai wizard onboarding dan mendaftarkan daemon latar belakang. Ikuti wizard untuk mengonfigurasi lingkungan agent Anda, termasuk memilih penyedia model (mis., Kimi API), memasukkan API key, dan memilih channel perpesanan. Setelah penyiapan selesai, agent Anda siap. Anda dapat mulai berinteraksi dengannya, menghubungkan alat, atau membangun workflow sesuai kebutuhan.
Catatan platform: OpenClaw mendukung Mac Intel maupun Apple Silicon. Jika instalasi diblokir oleh Gatekeeper, Anda dapat mengizinkannya di System Settings pada bagian Privacy & Security.
Cara menginstal OpenClaw di Windows
Windows menyediakan tiga cara utama untuk menginstal OpenClaw: installer PowerShell untuk penyiapan native yang cepat, WSL2 untuk lingkungan Linux lengkap, dan npm untuk instalasi manual.
Berikut panduan penyiapan singkat. Untuk panduan langkah demi langkah lengkap dengan tangkapan layar, lihat Cara menginstal OpenClaw di Windows.
Metode 1: Gunakan installer PowerShell (Windows native)
Langkah 1: Jalankan skrip installer di PowerShell
Buka PowerShell sebagai administrator dan jalankan skrip resmi satu baris untuk menginstal OpenClaw.
Langkah 2: Selesaikan wizard onboarding
Ikuti langkah onboarding untuk mengonfigurasi lingkungan agent Anda, termasuk memilih penyedia model (mis., Kimi API), memasukkan API key, dan memilih channel perpesanan.
Langkah 3: Verifikasi instalasi
Jalankan perintah berikut untuk memastikan OpenClaw terinstal dengan benar dan gateway aktif.
Langkah 4: Mulai gunakan agent Anda
Setelah penyiapan selesai, agent Anda siap. Anda dapat mulai berinteraksi dengannya, menghubungkan alat, atau mengonfigurasi workflow sesuai kebutuhan.
Metode 2: Instal dengan WSL2
Langkah 1: Siapkan lingkungan Linux
Buka PowerShell sebagai administrator dan jalankan perintah berikut untuk mengaktifkan serta menginisialisasi WSL2.
Langkah 2: Jalankan installer di Linux
Buka terminal Linux Anda dan jalankan skrip instalasi standar untuk menginstal OpenClaw.
Langkah 3: Selesaikan wizard onboarding
Ikuti langkah onboarding untuk mengonfigurasi lingkungan agent Anda, termasuk memilih penyedia model (mis., Kimi API), memasukkan API key, dan memilih channel perpesanan.
Setelah penyiapan selesai, agent Anda siap. Anda dapat mulai berinteraksi dengannya, menghubungkan alat, atau mengonfigurasi workflow sesuai kebutuhan.
Metode 3: Instal dengan npm di Windows
Langkah 1: Periksa versi Node.js Anda
Jalankan perintah berikut untuk memverifikasi bahwa Node.js sudah terinstal dan mutakhir.
Langkah 2: Instal OpenClaw CLI
Jalankan perintah berikut untuk menginstal OpenClaw CLI secara global.
Langkah 3: Jalankan onboarding dan aktifkan persistensi
Jalankan perintah berikut untuk memulai wizard onboarding dan mendaftarkan daemon latar belakang.
Ikuti langkah onboarding untuk mengonfigurasi lingkungan agent Anda, termasuk memilih penyedia model (mis., Kimi API), memasukkan API key, dan memilih channel perpesanan.
Setelah penyiapan selesai, agent Anda siap. Anda dapat mulai berinteraksi dengannya, menghubungkan alat, atau mengonfigurasi workflow sesuai kebutuhan.
Cara menjalankan OpenClaw online dengan Kimi Claw
Metode di atas memerlukan terminal, versi Node.js yang didukung, dan mesin yang tetap menyala. Kimi Claw menyediakan opsi yang sepenuhnya di-hosting, sehingga Anda dapat menjalankan OpenClaw tanpa perlu menginstal atau memelihara lingkungan lokal.
Langkah 1: Buka Kimi Claw dan buat instance
Buka halaman Kimi Claw lalu klik Create untuk memulai.
Langkah 2: Konfirmasi deployment
Konfirmasi deployment di jendela pop-up. Kimi Claw akan otomatis menyiapkan lingkungan OpenClaw Anda, termasuk gateway dan workspace, tanpa memerlukan konfigurasi lokal apa pun.
Langkah 3: Mulai gunakan workspace Anda
Setelah deployment selesai, workspace Anda terbuka di dashboard. Anda dapat mulai berinteraksi dengan agent, menyiapkan skill, mengonfigurasi tugas terjadwal, dan mengelola file langsung dari browser.
Fitur utama Kimi Claw
Hosting cloud: Kimi Claw menjalankan gateway Anda di cloud, sehingga agent Anda tetap tersedia meski mesin lokal sedang offline.
Pemeliharaan otomatis: Pembaruan dan patch ditangani di latar belakang, tanpa perlu penyiapan manual atau restart.
Kapabilitas bawaan: Mencakup penjadwalan tugas, penyimpanan persisten, dan pemuatan skill dinamis berdasarkan prompt Anda, dengan akses mulus di berbagai perangkat.
Pemecahan masalah error instalasi OpenClaw yang umum
Sebagian besar masalah instalasi OpenClaw masuk ke beberapa kategori umum, seperti konfigurasi PATH, dependensi yang hilang, atau konflik port. Bagian berikut membantu Anda mengenali dan memperbaiki masalah yang paling sering terjadi di macOS, Windows, dan Linux dengan cepat.
"openclaw: command not found" setelah instalasi
OpenClaw tidak ada di PATH sistem Anda.
Perbaikan: Tambahkan direktori bin global npm ke PATH Anda.
Lalu muat ulang shell Anda (mis., source ~/.zshrc) atau restart terminal. Di Windows, tambahkan path ke variabel lingkungan Anda dan restart PowerShell.
Error build Sharp di macOS
Ini biasanya terjadi ketika libvips yang terinstal secara global berbenturan dengan pustaka Sharp.
Perbaikan: Jalankan perintah instal dengan variabel lingkungan ini.
Jika Anda melihat error node-gyp, instal Xcode Command Line Tools:
OpenClaw tidak berjalan setelah reboot
Daemon latar belakang tidak terinstal selama onboarding.
Perbaikan: Jalankan onboarding lagi dengan flag daemon.
Lalu verifikasi layanan:
Gateway tidak merespons atau menampilkan "0 tokens used"
Proses gateway mungkin berhenti, atau autentikasi API mungkin gagal.
Perbaikan: Restart gateway.
Jalankan health check:
Untuk log debugging:
Selain itu, pastikan API key Anda valid.
Port 18789 sudah digunakan
Proses lain sedang menggunakan port gateway OpenClaw.
Perbaikan: Temukan dan hentikan proses yang konflik
Lalu restart gateway:
Error izin EACCES
Ini biasanya berarti direktori global npm tidak memiliki izin yang benar.
Perbaikan: Perbarui kepemilikan direktori.
Di Windows, jalankan PowerShell sebagai Administrator atau tetapkan prefiks npm khusus:
Untuk penyiapan Docker, perbaiki izin volume:
Error "spawn git ENOENT"
Git belum terinstal atau tidak tersedia di PATH.
Perbaikan: Instal Git dari git-scm.com, restart terminal Anda, lalu coba instalasi lagi.
systemd WSL2 tidak berfungsi
Systemd belum diaktifkan dalam konfigurasi WSL Anda.
Perbaikan: Edit
/etc/wsl.confdan tambahkan.
Lalu restart WSL:
Buka kembali terminal Linux Anda dan verifikasi:
Kehabisan memori saat npm install di VPS
Instance VPS dengan memori rendah dapat gagal saat instalasi paket.
Perbaikan: Buat file swap.
Lalu jalankan ulang instalasi.
"Access not configured" saat terhubung ke platform perpesanan
Akun Anda belum diotorisasi oleh OpenClaw.
Perbaikan: Setujui akun Anda menggunakan kode pairing.
Selain itu, pastikan kredensial bot Anda (token, webhook, izin) sudah dikonfigurasi dengan benar.
Kesimpulan
Instalasi OpenClaw di macOS, Linux, dan Windows cukup mudah. Anda dapat menggunakan skrip satu baris, PowerShell, WSL2, atau npm, sesuai penyiapan Anda. Wizard onboarding memandu Anda memilih model, mengonfigurasi API, dan menyiapkan kanal perpesanan. Jika Anda tidak ingin mengelola lingkungan lokal, Kimi Claw menyediakan opsi yang sepenuhnya di-hosting sehingga Anda dapat menjalankan OpenClaw langsung di cloud.
FAQ
node --version untuk memastikan versi Anda memenuhi persyaratan minimum.npm install -g openclaw@latest dari terminal Anda. Perintah ini memperbarui CLI ke versi terbaru. Anda juga dapat menjalankan kembali installer satu baris, yang otomatis meningkatkan instalasi yang sudah ada. OpenClaw juga mendukung pembaruan dalam aplikasi melalui Control UI di 127.0.0.1:18789. Setelah memperbarui, mulai ulang gateway dengan openclaw gateway restart untuk memuat versi baru.openclaw gateway status untuk memastikan daemon aktif. Di Windows, WSL2 dengan systemd yang diaktifkan memberikan penyiapan always-on paling andal. Jika Anda tidak ingin mengelola layanan lokal, opsi yang dihosting sepenuhnya seperti Kimi Claw memungkinkan Anda menjalankan OpenClaw terus-menerus di cloud.