Cara Menginstal OpenClaw di Windows

OpenClaw adalah alat yang kuat untuk membangun workflow AI, tetapi penyiapannya di Windows bisa membingungkan bagi pemula. Panduan ini memandu Anda melalui metode instalasi utama agar Anda dapat segera mulai.

Instalasi OpenClaw Windows: perbandingan 3 metode

Sebelum masuk ke langkah-langkahnya, berikut ringkasan singkat tiga cara menginstal OpenClaw di Windows. Setiap metode memiliki kompromi berbeda terkait waktu penyiapan, cakupan fitur, dan kebutuhan teknis.

Kimi Claw adalah alat online yang memungkinkan Anda menjalankan OpenClaw di browser. Penyiapan dan konfigurasinya ditangani otomatis, sehingga Anda tidak memerlukan Node.js, WSL, atau penyiapan API key. Anda dapat mulai memakai agent siap pakai dalam hitungan menit.

Untuk penyiapan lokal dengan PowerShell atau WSL2, gulir ke Metode 1 atau Metode 2. Untuk melewati instalasi lokal sepenuhnya, langsung ke Metode 3: Kimi Claw. Jika ingin mulai lebih cepat, Anda dapat langsung memulainya.

Yang perlu disiapkan sebelum menginstal OpenClaw secara lokal di Windows

Jika Anda berencana menginstal OpenClaw secara lokal, pastikan sistem Anda memenuhi persyaratan berikut. Jika memilih opsi cloud seperti Kimi Claw, Anda dapat melewati bagian ini sepenuhnya.

Persyaratan sistem

• Windows 10 atau Windows 11 (64-bit)

• RAM minimal 4 GB (8 GB direkomendasikan untuk build npm yang stabil)

• Koneksi internet stabil

• Hak administrator untuk penyiapan awal jika Anda memilih WSL2

• Untuk OpenClaw WSL2: virtualisasi harus diaktifkan di BIOS/UEFI

Software yang diperlukan

• Node.js 22.14 atau lebih baru. OpenClaw memerlukan runtime Node.js modern. Unduh dari nodejs.org atau instal melalui skrip onboarding.

• Git for Windows (opsional tetapi disarankan). Beberapa paket dan skill npm bergantung pada Git.

Metode 1: Instal OpenClaw di Windows menggunakan PowerShell

Dibandingkan WSL2, metode PowerShell membutuhkan langkah lebih sedikit dan tidak memerlukan lingkungan Linux. Satu perintah akan mengunduh OpenClaw, memeriksa versi Node.js Anda, dan menjalankan wizard onboarding. Metode ini bekerja di Windows 10 maupun Windows 11.

Langkah 1: Instal dan jalankan OpenClaw Anda

Windows membatasi eksekusi skrip secara default untuk melindungi sistem Anda. Sebelum menginstal OpenClaw, Anda harus mengizinkan PowerShell mengeksekusi skrip lokal dengan menjalankan perintah "safety switch" ini:

Lalu, jalankan perintah berikut:

Setelah menjalankan perintah, Anda akan melihat output yang mirip dengan tangkapan layar di bawah. Tutup lalu buka kembali PowerShell untuk menyegarkan PATH sistem sebelum melanjutkan ke onboarding.

Langkah 2: Pastikan catatan risiko & pilih mode onboarding

Pilih Yes untuk mengakui risiko dan melanjutkan.

Berikutnya, pilih QuickStart untuk memulai onboarding dengan cepat. Anda dapat menyesuaikan pengaturan nanti, atau memilih Manual untuk konfigurasi penuh.

Langkah 3: Konfigurasi dan autentikasi model AI Anda

1. Pilih Moonshot AI sebagai penyedia model/autentikasi

1. Autentikasi dan konfigurasi model AI Anda

Untuk menghubungkan OpenClaw, aktifkan Kimi API Key Anda melalui Kimi Open Platform. Isi ulang $5 memberi Anda voucher bonus$5, tetapi kami merekomendasikan $20+ untuk membuka akses Tier 2. Ini mengurangi latensi dan memastikan agent OpenClaw Anda mampu menangani tugas kompleks yang terdiri dari banyak langkah.

1. Buat Kimi API key

Buka bagian API Keys dan klik Create API Key. Pastikan Anda menyimpan API Key di tempat yang aman dan mudah diakses. Key ini hanya ditampilkan satu kali saat dibuat.

1. Masukkan API key Anda dan pilih model default

Saat wizard onboarding meminta, tempel API key unik Anda ke jendela PowerShell/Terminal.

Saat diminta memilih model default, pilih moonshot/kimi-k2.5 (atau pilih "Keep current" jika sudah disorot). Model ini menawarkan keseimbangan terbaik antara kecepatan dan penalaran untuk tugas agentic.

Langkah 4: Pilih channel

Pilih aplikasi yang ingin Anda hubungkan ke OpenClaw. Jika masih belum yakin, lewati saja.

Langkah 5: Konfigurasi untuk performa

Klik Yes untuk mengonfigurasi, atau No untuk melewati.

Langkah 6: Aktifkan Hooks

Pilih metode untuk chat dengan bot Anda, lalu tunggu hingga bot mulai berjalan.

Langkah 7: Jalankan OpenClaw Anda

Setelah semua langkah di atas selesai, silakan gunakan OpenClaw Anda.

Metode 2: Instal OpenClaw di Windows dengan WSL2

Penyiapan OpenClaw WSL2 menyediakan lingkungan Linux penuh di dalam Windows, yang merupakan cara resmi yang direkomendasikan untuk menjalankan OpenClaw. Metode ini memberi Anda akses ke seluruh rangkaian fitur, termasuk manajemen daemon systemd, skrip shell native, dan build npm yang lebih mulus. Jika Anda berencana menggunakan OpenClaw di Windows untuk alur kerja harian atau development, OpenClaw WSL adalah pilihan terbaik.

Langkah 1: Aktifkan WSL2 untuk OpenClaw di Windows 11/10

Buka PowerShell sebagai Administrator dan jalankan:

Perintah ini mengaktifkan WSL, mengunduh Ubuntu, lalu menginstalnya. Setelah proses selesai, restart komputer Anda. Saat Windows menyala kembali, Ubuntu akan terbuka dan meminta Anda membuat nama pengguna serta kata sandi.

Jika WSL sudah terinstal, verifikasi dengan:

Langkah 2: Konfigurasi WSL2 untuk systemd

OpenClaw berjalan sebagai layanan latar belakang menggunakan systemd. Aktifkan di konfigurasi WSL Anda:

Kemudian restart WSL dari PowerShell:

Buka kembali terminal Ubuntu Anda dan pastikan systemd berjalan:

Output seharusnya menampilkan systemd. Jika yang muncul adalah init, periksa kembali file /etc/wsl.conf Anda.

Langkah 3: Instal Node.js 22.14+

OpenClaw memerlukan Node.js 22.14 atau lebih baru. Instal dari repositori NodeSource:

Verifikasi instalasi:

Langkah 4: Instal OpenClaw melalui npm

Setelah Node.js siap, instal OpenClaw secara global:

Sebagai alternatif, gunakan skrip installer resmi:

Verifikasi instalasi:

Langkah 5: Selesaikan penyiapan OpenClaw Windows melalui onboarding

Jalankan wizard onboarding dengan flag daemon untuk menyiapkan OpenClaw sebagai layanan systemd:

Wizard akan memandu Anda untuk:

• Memilih penyedia LLM dan memasukkan API key Anda

• Memilih model default

• Mengonfigurasi channel pesan (opsional)

• Menginstal gateway sebagai layanan latar belakang

Setelah onboarding, aktifkan persistensi layanan agar OpenClaw otomatis berjalan saat WSL boot:

Gateway adalah layanan latar belakang inti yang menangani semua operasi OpenClaw, termasuk permintaan agent, pesan, dan eksekusi model. Memastikan gateway berjalan menandakan instalasi OpenClaw Anda sudah lengkap dan siap digunakan, sekaligus mencegah error pada langkah berikutnya.

Jalankan perintah berikut di terminal PowerShell atau WSL untuk memeriksa statusnya:

Metode 3: Jalankan OpenClaw di Windows dengan Kimi Claw (tanpa penyiapan)

Jika mengelola Node.js, WSL, dan API keys terasa terlalu merepotkan, Kimi Claw menawarkan cara yang lebih sederhana untuk menjalankan OpenClaw. Anda dapat menjalankan OpenClaw langsung di browser tanpa penyiapan lokal atau konfigurasi manual. Untuk memulai, ikuti langkah-langkah berikut:

Langkah 1: Buka Kimi Claw dan buat instance

Buka halaman Kimi Claw dan klik Create untuk memulai.

Langkah 2: Mulai deployment

Konfirmasi deployment pada pop-up. Kimi Claw akan menyiapkan lingkungan OpenClaw Anda dalam sekitar dua menit, termasuk gateway, workspace, dan tools. Tidak perlu perintah atau konfigurasi manual.

Langkah 3: Bekerja di workspace Anda

Setelah deployment selesai, workspace Anda akan terbuka di dashboard. Dari browser, Anda dapat mulai chat dengan AI agent, menyiapkan skill, mengonfigurasi tugas terjadwal, dan mengelola file.

Yang Anda dapatkan dengan Kimi Claw

• Nol konfigurasi: Tidak perlu mengelola Node.js, WSL, atau API key

• Penyimpanan cloud 40 GB: Simpan laporan, dataset, dan file yang dibuat, tetap tersedia di berbagai sesi

• Memori persisten: AI agent Anda mengingat interaksi, preferensi, dan konteks sebelumnya

• 5.000+ skill ClawHub: Akses skill otomatisasi, riset, coding, dan analisis secara instan

• Otomatisasi tugas terjadwal: Atur tugas berulang seperti laporan harian, pengingat, dan pemantauan

• Berfungsi dari perangkat apa pun: Akses agent OpenClaw Anda dari browser apa pun di Windows, Mac, atau perangkat mobile

Pengaturan firewall Windows dan keamanan untuk OpenClaw

Kimi Claw menangani keamanan dan jaringan di server cloud secara otomatis. Jika Anda lebih suka menginstal OpenClaw secara lokal dengan PowerShell atau WSL2, ada beberapa pengaturan keamanan yang disarankan setelah instalasi.

• Mengonfigurasi Windows Firewall

Saat gateway OpenClaw pertama kali berjalan, Windows Firewall mungkin meminta Anda mengizinkan akses jaringan. Izinkan hanya untuk jaringan privat. Jika Anda menggunakan OpenClaw WSL2, gateway berjalan di dalam lingkungan Linux dan berkomunikasi melalui localhost, sehingga aturan firewall tambahan biasanya tidak diperlukan.

Jika Browser Relay atau fitur lain tidak dapat terhubung, pastikan traffic localhost tidak diblokir oleh perangkat lunak keamanan pihak ketiga seperti program antivirus, klien VPN, atau firewall perusahaan.

• Mengamankan Control UI

OpenClaw Control UI berjalan pada port 18789 dan memberikan akses penuh ke agent Anda. Jangan pernah membuka port ini ke internet publik. Biarkan gateway tetap terikat ke 127.0.0.1 dan akses hanya dari mesin lokal Anda.

Untuk akses jarak jauh yang aman, gunakan Tailscale untuk membuat tunnel jaringan privat:

Dengan begitu, port tetap berada di localhost sekaligus dapat diakses melalui jaringan Tailscale privat Anda.

Error umum instalasi OpenClaw di Windows dan cara memperbaikinya

Meski panduannya sudah jelas, masalah tetap bisa muncul saat instalasi. Berikut masalah yang paling sering dilaporkan saat menginstal OpenClaw di Windows beserta cara memperbaikinya.

OpenClaw tidak dikenali

• Penyebab: Direktori bin global npm tidak ada di PATH sistem Anda.

• Perbaikan: Jalankan perintah berikut untuk menemukan prefix npm Anda

Tambahkan path output ke variabel lingkungan Windows Anda. Jangan tambahkan \\bin. Lalu tutup dan buka kembali PowerShell.

Git tidak ditemukan saat instalasi

• Penyebab: Git for Windows belum terinstal.

• Perbaikan: Unduh dan instal Git dari git-scm.com. Setelah instalasi selesai, restart PowerShell dan coba kembali installer OpenClaw Windows.

Versi Node.js terlalu lama

• Penyebab: Sistem Anda memiliki versi Node.js lama yang tidak memenuhi persyaratan minimum (v22.14+).

• Perbaikan: Unduh versi LTS terbaru dari nodejs.org dan instal. Jika Anda menggunakan OpenClaw WSL2, instal ulang melalui repositori NodeSource.

Error izin ditolak

• Penyebab: PowerShell tidak memiliki izin yang memadai, atau direktori global npm tidak dapat ditulisi.

• Perbaikan: Jalankan PowerShell sebagai Administrator, atau ubah prefix global npm ke direktori yang dapat ditulisi pengguna

Gateway tidak dapat dimulai

• Penyebab: Port 18789 sudah digunakan, atau file konfigurasi rusak.

• Perbaikan: Periksa proses yang bentrok lalu restart

systemd WSL2 tidak berfungsi

• Penyebab: File /etc/wsl.conf tidak memuat konfigurasi systemd.

• Perbaikan: Pastikan file tersebut berisi pengaturan yang benar

Jika pengaturan tersebut belum ada, tambahkan lalu restart WSL dengan wsl --shutdown di PowerShell.

Kesimpulan

Menginstal OpenClaw di Windows bisa sesederhana penyiapan berbasis skrip atau berupa lingkungan WSL2 yang lebih canggih, tergantung kebutuhan Anda. Jika Anda menginginkan kontrol penuh dan fleksibilitas, PowerShell dan WSL2 adalah pilihan yang solid. Jika Anda lebih suka melewati penyiapan dan langsung mulai, Kimi Claw memungkinkan Anda menjalankan OpenClaw di browser tanpa penyiapan lokal. Pilih pendekatan yang sesuai dengan alur kerja dan tingkat kenyamanan teknis Anda, lalu Anda siap memaksimalkan OpenClaw.