OpenClaw dapat diinstal di Mac dengan beberapa cara, tergantung cara kerja dan pengelolaan penyiapan yang Anda pilih. Dalam panduan ini, Anda akan menemukan petunjuk langkah demi langkah untuk berbagai metode instalasi, beserta tips agar OpenClaw berjalan lancar.
Ringkasan cepat: tiga cara menginstal OpenClaw di Mac
Berikut perbandingan berdampingan dari ketiga metode tersebut. Masing-masing berbeda dalam seberapa banyak penyiapan manual yang perlu Anda tangani.
| Penginstal Satu Baris | Homebrew | Kimi Claw (Online) | |
|---|---|---|---|
| Apa ini | Skrip instalasi resmi yang mengunduh dan menyiapkan OpenClaw secara otomatis | Penyiapan manual menggunakan Homebrew untuk menginstal dependensi (seperti Node.js), lalu menjalankan OpenClaw melalui CLI | Alat online yang memungkinkan Anda menjalankan OpenClaw di cloud tanpa penyiapan manual |
| Langkah manual yang diperlukan | Langkah manual minimal | Memerlukan beberapa langkah manual | Tidak memerlukan penyiapan manual |
| Memerlukan kode atau terminal | Ya | Ya | Tidak |
| Ketersediaan 24/7 | Hanya berjalan saat Mac Anda aktif | Hanya berjalan saat Mac Anda aktif | Berjalan 24/7 di cloud |
| Paling cocok untuk | Pengguna baru yang menginginkan penyiapan lokal paling cepat | Developer yang lebih suka mengelola paket melalui Homebrew | Pengguna yang ingin menjalankan OpenClaw tanpa penyiapan lokal |
Kimi Claw memungkinkan Anda menjalankan OpenClaw di cloud tanpa menyiapkan Node.js, Homebrew, atau kunci API. Anda bisa mulai menggunakan agent yang siap pakai di browser dalam hitungan menit.
Jika Anda lebih memilih penyiapan lokal, lanjutkan ke bagian berikutnya. Jika menginginkan opsi yang lebih sederhana, langsung ke bagian Jalankan OpenClaw di Mac dengan Kimi Claw, atau klik tombol di bawah untuk langsung mulai.
Sebelum mulai: persiapan penting dan keamanan
Sebelum menginstal OpenClaw secara lokal di Mac, ada beberapa langkah persiapan dan keamanan yang perlu diselesaikan. Jika Anda berencana menggunakan Kimi Claw, Anda dapat melewati bagian ini dan langsung menuju petunjuk penyiapan di bawah.
Dependensi: Penginstal satu baris akan menginstal Node.js secara otomatis bila diperlukan. Jika memilih Homebrew, Anda perlu menginstal Node.js secara manual (Node 24 direkomendasikan; Node 22 LTS 22.16+ juga didukung).
Pengaturan firewall dan jaringan: Firewall macOS biasanya nonaktif secara default. Anda dapat mengaktifkannya di System Settings > Network > Firewall. OpenClaw mengikat gateway ke 127.0.0.1 (localhost), sehingga perangkat lain di jaringan Anda tidak dapat terhubung langsung. Jika membutuhkan akses seluler atau jarak jauh, Anda dapat menggunakan alat seperti Tailscale atau tunnel SSH. Jangan meneruskan port
18789melalui router Anda.
Instal OpenClaw di Mac dengan skrip satu baris
Ini adalah cara tercepat untuk menjalankan OpenClaw secara lokal di Mac. OpenClaw berjalan dari Terminal dan menyediakan antarmuka berbasis browser untuk mengelola agent Anda, bukan aplikasi grafis tradisional. Satu perintah akan menginstal CLI, memeriksa versi Node.js Anda, dan meluncurkan wizard orientasi.
Langkah 1. Jalankan skrip penginstal di Terminal
Buka Terminal menggunakan Spotlight (⌘ + Space), lalu tempel perintah berikut:
Skrip akan mendeteksi sistem Anda, menginstal OpenClaw CLI, dan memeriksa versi Node.js Anda. Jika Node.js tidak ada atau sudah usang, skrip akan menginstal Node 24 secara otomatis (Node 22 LTS 22.16+ juga didukung).
Langkah 2. Atur kunci API Anda dan konfigurasikan gateway
Wizard orientasi dimulai otomatis setelah instalasi selesai. Pilih Moonshot AI (Kimi K2.5) sebagai penyedia LLM Anda dan tempel kunci Kimi API saat diminta. Terima pengaturan default untuk port gateway dan autentikasi. Jika ingin OpenClaw berjalan otomatis saat Mac dinyalakan, pilih opsi instalasi daemon selama orientasi.
Langkah 3. Verifikasi gateway dan buka dashboard
Jalankan perintah berikut untuk memastikan gateway berjalan:
Lalu buka dashboard:
Perintah ini membuka Control UI di browser Anda pada http://127.0.0.1:18789. Masukkan token gateway Anda untuk masuk. Setelah masuk, Anda dapat mulai berinteraksi dengan agent OpenClaw Anda.
Instal OpenClaw di Mac dengan Homebrew
Jika Anda lebih suka mengelola paket dengan Homebrew, Anda dapat menginstal OpenClaw di Mac melalui penyiapan yang lebih manual. Metode ini memberi Anda kendali lebih besar atas dependensi dan sesuai dengan alur kerja Homebrew yang sudah Anda gunakan.
Langkah 1. Instal Homebrew
Buka Terminal menggunakan Spotlight (⌘ + Space). Jika Homebrew belum terpasang, jalankan perintah berikut. Homebrew adalah manajer paket untuk macOS yang memungkinkan Anda menginstal dan mengelola alat developer dari Terminal, mirip dengan cara app store menginstal aplikasi.
Selama instalasi, Anda mungkin diminta memasukkan kata sandi login Mac. Perlu diketahui, demi keamanan Terminal tidak akan menampilkan karakter apa pun saat Anda mengetik. Anda juga mungkin melihat permintaan konfirmasi instalasi dan pesan yang menunjukkan file sedang dipasang.
Setelah instalasi selesai, Anda akan melihat pesan berhasil dan langkah berikutnya di Terminal.
Langkah 2. Instal Node.js
Setelah Homebrew terpasang, instal Node.js:
Setelah instalasi, pastikan versinya v24 (direkomendasikan) atau v22.16+.
Langkah 3. Instal OpenClaw CLI dan jalankan orientasi
Instal CLI secara global dengan npm, lalu jalankan orientasi:
Jika Anda melihat error izin EACCES saat menjalankan npm install -g, direktori global npm Anda memerlukan akses lebih tinggi. Jalankan sudo npm install -g openclaw@latest, atau ubah direktori default npm agar ke depannya tidak perlu menggunakan sudo.
Flag --install-daemon mendaftarkan OpenClaw sebagai LaunchAgent, sehingga gateway otomatis berjalan saat Anda login. Selama orientasi, pilih Moonshot AI (Kimi K2.5) sebagai penyedia Anda dan masukkan kunci Kimi API Anda.
Langkah 4. Periksa gateway dan buka dashboard
Pastikan gateway berjalan, lalu buka dashboard:
Control UI akan terbuka di browser Anda. Masukkan token gateway, dan Anda siap mulai.
Jalankan OpenClaw di Mac menggunakan Kimi Claw
Kimi Claw adalah alat online yang memungkinkan Anda menjalankan OpenClaw di cloud tanpa penyiapan lokal. Tidak ada yang perlu diinstal di Mac, dan Anda tidak perlu menggunakan Terminal atau mengelola dependensi. Semuanya berjalan di browser. Anda dapat membuat agent OpenClaw dalam hitungan menit. Kimi Claw menangani gateway, workspace, penyimpanan, dan akses model, sehingga agent Anda tetap online 24/7, bahkan saat MacBook ditutup.
Bagaimana cara menggunakan Kimi Claw?
Langkah 1. Buka Kimi Claw
Buka halaman Kimi Claw dan klik Create untuk mulai men-deploy lingkungan OpenClaw Anda.
Langkah 2. Deploy OpenClaw secara otomatis
Konfirmasikan deployment di jendela pop-up. Kimi Claw kemudian menyiapkan lingkungan OpenClaw, termasuk gateway, workspace, dan alat. Proses ini biasanya selesai dalam beberapa menit.
Langkah 3. Mulai gunakan OpenClaw
Setelah deployment selesai, workspace Anda terbuka di dashboard. Mulailah mengobrol dengan agent Anda, menyiapkan skill, menjadwalkan tugas, dan mengelola file, semuanya dari browser.
Perbedaan Kimi Claw dibanding menjalankan OpenClaw secara lokal
Kimi Claw menyediakan cara yang lebih sederhana untuk menjalankan OpenClaw tanpa penyiapan lokal. Alih-alih menginstal dependensi dan mengelola lingkungan lokal, Anda dapat menjalankan agent langsung di browser sementara Kimi Claw menangani penyiapan dan infrastruktur di baliknya.
Tanpa penyiapan lokal: Jalankan OpenClaw tanpa menginstal Node.js atau menggunakan Terminal. Semuanya bekerja langsung di browser, sehingga Anda dapat mulai lebih cepat dan terhindar dari masalah penyiapan lingkungan.
Akses instan ke 5.000+ skill: Alih-alih memasang alat secara manual, Kimi Claw dapat otomatis menggunakan skill yang dibutuhkan untuk tugas Anda dari pustaka besar alat yang tersedia, sehingga mengurangi waktu penyiapan dan masalah kompatibilitas.
Otomasi & penjadwalan yang selalu aktif: Berbeda dengan agent lokal yang berhenti saat Mac tidur, Kimi Claw berjalan 24/7 di cloud, sehingga cocok untuk tugas terjadwal dan alur kerja jangka panjang.
Penyimpanan cloud 40GB & memori persisten: Berbeda dengan penyiapan lokal, yang file-nya biasanya terikat pada satu perangkat, Kimi Claw menyertakan penyimpanan 40GB, sehingga laporan dan riset Anda dapat diakses dari browser mana pun. Kimi Claw juga mengingat preferensi dan konteks kerja Anda di setiap sesi, sehingga Anda dapat melanjutkan dari titik terakhir.
Model Kimi K2.5 terintegrasi dan pencarian kelas pro: Kimi Claw dilengkapi akses bawaan ke Kimi K2.5 dan kemampuan pencarian lanjutan, sehingga Anda tidak perlu mengelola kunci API atau menyiapkan layanan eksternal. Kimi Claw dapat otomatis menghadirkan informasi terbaru di berbagai bidang seperti keuangan, teknologi, dan berita, sehingga riset dan pelaksanaan tugas menjadi lebih lancar.
Biarkan OpenClaw berjalan 24/7 di Mac
Sebagian besar pengguna memperlakukan AI seperti aplikasi desktop biasa: dipakai saat bekerja di meja, lalu ditutup setelah selesai. Untuk otomasi yang bernilai, seperti memantau pasar global semalaman atau menyiapkan laporan riset di kotak masuk Anda sebelum pukul 08.00, agent Anda perlu tetap aktif sepanjang waktu. Karena macOS secara alami menjeda proses lokal saat sistem tidur, diperlukan strategi khusus untuk mencapainya. Bagian ini membahas dua cara menjaga koneksi tetap persisten:
Opsi A: Perangkat keras Mac khusus
Salah satu opsi adalah membiarkan Mac (misalnya Mac mini) terus berjalan. Anda dapat menonaktifkan mode tidur dengan sudo pmset -a sleep 0 dan mengaktifkan “Wake for network access” di System Settings. Untuk akses jarak jauh, Anda dapat menggunakan alat seperti Tailscale atau tunnel SSH.
Penyiapan ini membuat OpenClaw tetap berjalan di perangkat keras Anda sendiri, tetapi Anda harus menjaga mesin tetap menyala serta menangani pemeliharaan, pembaruan, dan restart sendiri.
Opsi B: Kimi Claw menanganinya secara otomatis
Jika Anda menjalankan agent dengan Kimi Claw, ketersediaan 24/7 sudah tersedia secara bawaan. Agent Anda berjalan secara independen dari perangkat lokal, sehingga tetap bekerja meski Mac Anda ditutup atau offline. Anda tidak perlu mengubah pengaturan tidur atau membiarkan mesin terus menyala.
Perbaiki error instalasi OpenClaw yang umum di Mac
Meski penyiapannya sederhana, Anda mungkin tetap mengalami kendala saat instalasi. Berikut beberapa masalah umum beserta cara mengatasinya.
Error perintah OpenClaw tidak ditemukan
Penyebab: Direktori bin global npm tidak ada di PATH shell Anda.
Perbaikan: Jalankan
source ~/.zshrcuntuk memuat ulang konfigurasi shell Anda. Jika Anda menggunakan Bash, bukan Zsh, ganti~/.zshrcdengan~/.bash_profile. Jika error masih muncul, cari prefix npm Anda dan tambahkan ke PATH:
OpenClaw tidak berjalan setelah reboot
Penyebab: LaunchAgent tidak dipasang selama orientasi.
Perbaikan: Jalankan perintah orientasi dengan flag daemon:
Ini mendaftarkan LaunchAgent yang menjalankan gateway OpenClaw secara otomatis saat Anda login. Untuk memastikan statusnya aktif:
Port 18789 sudah digunakan
Penyebab: Proses lain sedang memakai port gateway.
Perbaikan: Temukan dan hentikan proses yang bentrok:
Error Xcode Command Line Tools saat instalasi skill
Penyebab: Beberapa paket npm memerlukan kompilasi native, sementara Xcode Command Line Tools tidak ada atau sudah usang.
Perbaikan: Instal atau perbarui alat tersebut:
Setelah instalasi selesai, coba pasang skill lagi.
Versi Node.js terlalu lama
Penyebab: Node.js yang terpasang di Mac Anda lebih lama dari 22.16. OpenClaw memerlukan Node 24 (direkomendasikan) atau Node 22 LTS 22.16+.
Perbaikan: Jika Anda menggunakan Homebrew:
Jika Anda menggunakan installer satu baris, jalankan ulang. Skrip akan mendeteksi versi yang sudah usang dan memperbaruinya.
Kesimpulan
OpenClaw dapat berjalan secara lokal di Mac Anda menggunakan installer satu baris atau Homebrew, atau di browser dengan Kimi Claw tanpa penyiapan lokal. Setiap metode menghasilkan agent yang berfungsi, tetapi membutuhkan tingkat upaya manual yang berbeda. Jika Anda menginginkan penyiapan yang lebih cepat dengan ketersediaan 24/7 bawaan, Anda dapat mulai dengan Kimi Claw dan menjalankan agent dalam hitungan menit.
FAQ
openclaw onboard --install-daemon untuk mendaftarkan LaunchAgent yang memulai gateway saat login. Jika daemon sudah terinstal tetapi tidak berjalan, periksa statusnya dengan launchctl list | grep openclaw dan tinjau log sistem. Pengguna Kimi Claw tidak memerlukan konfigurasi ini karena layanan berjalan di server cloud dan tetap online secara mandiri.source ~/.zshrc untuk memuat ulang konfigurasi. Jika perintah masih tidak ditemukan, jalankan npm config get prefix untuk menemukan direktori bin dan tambahkan ke PATH Anda di ~/.zshrc. Mulai ulang Terminal setelah melakukan perubahan.sudo pmset -a sleep 0) dan akses jarak jauh melalui Tailscale, atau gunakan Kimi Claw. Kimi Claw adalah platform terkelola sepenuhnya yang menjaga agent OpenClaw Anda tetap online sepanjang waktu, tanpa perangkat keras yang perlu dirawat.curl -fsSL https://openclaw.ai/install.sh | bash. Skrip akan menginstal OpenClaw, memeriksa versi Node.js Anda, dan memandu Anda melalui penyiapan. Anda juga dapat menggunakan Homebrew: jalankan brew install node, lalu npm install -g openclaw@latest. Untuk opsi terkelola sepenuhnya yang tidak memerlukan terminal, Kimi Claw menjalankan OpenClaw di browser Anda, tanpa penyiapan lokal.curl -fsSL https://openclaw.ai/install.sh | bash) atau instal melalui Homebrew dengan npm install -g openclaw@latest. Untuk opsi berbasis browser yang tidak memerlukan unduhan, Kimi Claw menjalankan OpenClaw untuk Anda di server cloud.