Cara Menginstal OpenClaw di macOS: Panduan Setup Lengkap untuk Mac Mini

OpenClaw adalah kerangka kerja agen AI sumber terbuka yang kuat dan dapat dihosting sendiri yang berfungsi sebagai asisten pribadi yang sepenuhnya otonom. Berjalan 24/7 di perangkat keras lokal Anda, ia terhubung ke platform pesan populer seperti Telegram, WhatsApp, Slack, dan iMessage, menjalankan perintah shell, menjelajahi web, mengelola file, dan terintegrasi dengan mulus dengan model AI terkemuka industri seperti Claude dari Anthropic dan seri GPT dari OpenAI.

Bagi mereka yang menginginkan kinerja dan keandalan maksimal tanpa ketergantungan cloud, Mac Mini khusus — khususnya model Apple Silicon M-series (M1 hingga M4) — adalah salah satu platform terbaik yang tersedia. Mesin-mesin ini senyap, hemat energi, selalu aktif, dan terintegrasi dalam dengan macOS, menjadikannya ideal untuk menjalankan agen AI yang persisten. Panduan ini memandu Anda melalui setiap langkah pengaturan asisten OpenClaw Anda sendiri di server Mac Mini AlexHost.

> ⚠️ Peringatan Keamanan: OpenClaw beroperasi dengan izin tingkat sistem yang luas. Ia dapat membaca file, menjalankan perintah terminal, mengirim pesan, dan menjelajahi web secara otonom atas nama Anda. Jangan instal di mesin pribadi utama Anda jika data sensitif — seperti file iCloud, kata sandi, atau foto pribadi — disinkronkan dengannya. Perangkat khusus dan terisolasi seperti server Mac Mini yang dijelaskan dalam panduan ini adalah pendekatan yang sangat direkomendasikan.

Prasyarat: Apa yang Anda Butuhkan Sebelum Memulai

Sebelum menyelam ke dalam instalasi, pastikan Anda memiliki hal berikut:

• Server Mac Mini AlexHost (Apple Silicon M-series direkomendasikan)
• Akses SSH atau jarak jauh ke Mac Mini Anda (lihat panduan koneksi AlexHost)
• Kunci API Anthropic dari console.anthropic.com (atau kunci API OpenAI jika Anda lebih suka model GPT)
• Akun Telegram (opsional, untuk integrasi saluran pesan)
• Keakraban dasar dengan Terminal dan operasi baris perintah

Jika Anda mencari lingkungan hosting yang andal dan selalu aktif di luar Mac Mini, AlexHost juga menawarkan VPS Hosting dan Server Dedicated berkinerja tinggi yang dapat menjalankan beban kerja agen AI sepanjang waktu.

Langkah 1: Terhubung ke Server Mac Mini Anda

Mulai dengan membuat koneksi jarak jauh ke Mac Mini AlexHost Anda. Ikuti panduan koneksi Mac Mini resmi AlexHost untuk mengakses server Anda melalui SSH atau desktop jarak jauh. Setelah Anda memiliki sesi Terminal yang berfungsi di mesin, Anda siap untuk melanjutkan.

Langkah 2: Instal Dependensi yang Diperlukan

2.1 Instal Homebrew

Homebrew adalah pengelola paket de facto untuk macOS dan diperlukan untuk menginstal Node.js dan dependensi lainnya. Buka Terminal di Mac Mini Anda dan jalankan perintah berikut:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Ikuti petunjuk di layar dan tunggu instalasi selesai.

Hanya pengguna Apple Silicon (M1/M2/M3/M4): Setelah instalasi, Anda harus menambahkan Homebrew ke PATH shell Anda. Jalankan dua perintah ini:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Ini memastikan bahwa binari yang diinstal Homebrew dapat diakses dari sesi Terminal baru apa pun.

2.2 Instal Node.js (Versi 22 atau Lebih Baru Diperlukan)

OpenClaw memerlukan Node.js v22 atau lebih tinggi. Instal melalui Homebrew:

brew install node

Verifikasi versi yang diinstal:

node --version

Anda harus melihat output seperti v22.x.x atau lebih tinggi. Jika versi yang lebih lama ditampilkan, tingkatkan segera:

brew upgrade node

Jangan lanjutkan sampai Node.js v22 atau lebih baru dikonfirmasi — versi yang lebih lama akan menyebabkan penginstal OpenClaw gagal.

Langkah 3: Instal OpenClaw

3.1 Jalankan Skrip Penginstal Resmi

Dengan Node.js sudah ada, instal OpenClaw menggunakan penginstal satu baris resminya:

curl -fsSL https://openclaw.ai/install.sh | bash

Skrip ini secara otomatis:

• Mendeteksi sistem operasi dan arsitektur Anda
• Mengonfirmasi bahwa versi Node.js yang kompatibel tersedia
• Menginstal CLI OpenClaw secara global di sistem Anda
• Menyiapkan lingkungan runtime

Tunggu sampai Anda melihat pesan konfirmasi:

Installation finished successfully!

3.2 Verifikasi Instalasi

Konfirmasi bahwa CLI OpenClaw diinstal dengan benar dan dapat diakses:

openclaw --version

Nomor versi harus dicetak ke terminal. Jika Anda menerima kesalahan “command not found”, tutup jendela Terminal Anda sepenuhnya, buka kembali, dan coba perintah lagi. Ini menyegarkan PATH shell Anda dan biasanya menyelesaikan masalah.

Langkah 4: Onboarding dan Konfigurasi

Langkah ini mengonfigurasi OpenClaw untuk menggunakan Claude dari Anthropic sebagai backend AI-nya dan mengatur daemon layanan latar belakang.

4.1 Jalankan Wizard Onboarding

openclaw onboard --install-daemon

Flag --install-daemon penting — ia mendaftarkan OpenClaw sebagai layanan latar belakang yang secara otomatis dimulai pada setiap boot sistem, memastikan asisten AI Anda selalu tersedia tanpa intervensi manual.

Wizard interaktif akan memandu Anda melalui tiga area konfigurasi:

a) Autentikasi — Pengaturan Kunci API

Ketika diminta kunci API, tempel kunci API Anthropic Anda dari console.anthropic.com. OpenClaw akan menggunakan kunci ini untuk berkomunikasi dengan Claude.

> 💡 Catatan penagihan: Anthropic mengenakan biaya per penggunaan token. Untuk asisten pribadi yang digunakan secara aktif, harapkan biaya dalam kisaran beberapa dolar per hari tergantung pada volume kueri dan pemilihan model.

b) Pengaturan Gateway — Konfigurasi Port

Terima pengaturan gateway default kecuali Anda memiliki alasan khusus untuk menggunakan port yang berbeda. Port gateway default adalah 18989. Ini adalah port melalui mana UI web OpenClaw dan integrasi pesan berkomunikasi.

c) Pengaturan Saluran — Integrasi Pesan

Pada tahap ini, Anda dapat menghubungkan aplikasi pesan (dibahas secara detail di Langkah 5) atau lewati ini untuk sekarang dan gunakan dashboard berbasis web sebagai gantinya. Pilih “skip for now” jika Anda ingin menguji UI web terlebih dahulu.

4.2 Verifikasi Gateway Sedang Berjalan

Setelah onboarding, konfirmasi bahwa layanan gateway OpenClaw aktif:

openclaw gateway status

Output harus mengonfirmasi gateway sedang berjalan. Jika tidak berjalan, mulai secara manual:

openclaw gateway --port 18789

4.3 Buka Dashboard Web

Luncurkan antarmuka kontrol OpenClaw di browser Anda:

openclaw dashboard

Ini membuka dashboard berbasis web di:

http://127.0.0.1:18789/

Jika dashboard dimuat dengan berhasil, gateway Anda sepenuhnya operasional. Anda dapat segera mulai mengobrol dengan OpenClaw langsung dari browser — tidak ada konfigurasi aplikasi pesan yang diperlukan pada tahap ini.

Langkah 5: Hubungkan Saluran Pesan Telegram (Opsional)

Menghubungkan OpenClaw ke Telegram memungkinkan Anda berinteraksi dengan asisten AI Anda dari perangkat apa pun, di mana pun di dunia, menggunakan aplikasi Telegram.

5.1 Buat Bot Telegram melalui BotFather

1. Buka Telegram dan cari @BotFather
2. Mulai percakapan dan kirim perintah: /newbot
3. Ikuti petunjuk BotFather — Anda akan memilih nama tampilan dan nama pengguna untuk bot Anda
4. BotFather akan menghasilkan dan mengirimkan Anda token API bot — salin token ini segera dan simpan dengan aman

5.2 Daftarkan Token Bot dengan OpenClaw

Kembali ke Terminal Mac Mini Anda dan jalankan:

openclaw onboard

Ketika diminta untuk memilih saluran pesan, pilih Telegram dan tempel token API bot Anda saat diminta.

5.3 Mulai Mengobrol

Buka Telegram, temukan bot yang baru dibuat dengan nama penggunanya, dan kirimkan pesan. OpenClaw akan merespons melalui antarmuka Telegram, memberi Anda kemampuan asisten AI penuh langsung dalam aplikasi.

Pemecahan Masalah Masalah Umum

Mengapa Menjalankan OpenClaw di Perangkat Keras Khusus?

Menjalankan OpenClaw di mesin khusus — daripada laptop atau desktop pribadi Anda — menawarkan keuntungan signifikan:

• Isolasi: File pribadi, kata sandi, dan data sensitif Anda tidak dapat diakses oleh agen
• Ketersediaan selalu aktif: Asisten berjalan 24/7 tanpa mengganggu alur kerja utama Anda
• Kinerja: Chip Apple Silicon M-series menangani beban kerja AI secara efisien dengan konsumsi daya rendah
• Stabilitas: Lingkungan server khusus menghindari konflik dengan perangkat lunak pribadi dan pembaruan sistem

Untuk tim atau pengembang yang membutuhkan lebih banyak kekuatan komputasi untuk beban kerja AI, solusi GPU Hosting AlexHost menyediakan sumber daya GPU khusus yang dirancang khusus untuk tugas-tugas AI dan pembelajaran mesin. Alternatifnya, jika Anda membutuhkan lingkungan berbasis Linux yang dapat diskalakan dengan akses root penuh, pertimbangkan paket VPS Hosting AlexHost.

Mengamankan Instalasi OpenClaw Anda

Karena OpenClaw memiliki izin sistem yang luas, pengerasan lingkungan server Anda sangat penting:

• Gunakan kunci SSH yang kuat untuk akses jarak jauh — nonaktifkan autentikasi SSH berbasis kata