Cara menginstal NanoClaw di Mac mini

Apa itu NanoClaw

NanoClaw adalah asisten AI open source yang Anda jalankan di komputer sendiri. NanoClaw ditulis dalam TypeScript dengan lisensi MIT. README-nya menyebutnya alternatif ringan untuk OpenClaw (github.com/nanocoai/nanoclaw, dibaca 2 Oktober 2026). Rilis terbarunya 2.4.0, pada 23 September 2026.

Perbedaan besarnya ada di isolasi. Setiap agen berjalan di dalam container Linux sendiri. Agen hanya bisa melihat folder yang Anda mount ke dalamnya. Agennya dibangun di atas Claude Agent SDK dari Anthropic. Anda menjangkaunya dari aplikasi chat seperti WhatsApp, Telegram, Discord, Slack, Teams, atau iMessage. Setiap channel ditambahkan dengan skill setup-nya sendiri.

Kebutuhan

Ini berasal dari dokumentasi instalasi NanoClaw (docs.nanoclaw.dev).

• macOS atau Linux, dengan memori minimal 4 GB. Installer memberi peringatan di bawah 3,700 MB.
• Git, untuk mengunduh kode. Installer tidak memasangnya untuk Anda.
• Docker Desktop di macOS. Agen berjalan di container Docker. Installer menambahkan Docker Desktop lewat Homebrew jika belum ada.
• Node 22 atau lebih baru dan pnpm 10 atau lebih baru. Installer menambahkan keduanya jika belum ada.
• Claude Code di Mac. NanoClaw memakainya untuk memperbaiki langkah setup yang gagal dan untuk menambah channel.
• Kredensial model. Setup menawarkan Claude atau Codex. Panduan ini memakai API key Anthropic, yang ditagih Anthropic berdasarkan pemakaian.

Instal

Pertama, cek bahwa Git sudah ada. Baris yang diawali git version berarti sudah ada.

git --version

Lalu jalankan empat perintah dari quick start resmi ini, satu baris per satu baris.

cd ~
git clone https://github.com/nanocoai/nanoclaw.git
cd nanoclaw
bash nanoclaw.sh

Script mengecek mesin dan memasang yang belum ada. Lalu wizard setup mengajukan beberapa pertanyaan. Dokumentasinya menyarankan Standard setup, lalu Fresh agent. Mereka memperkirakan 30 sampai 60 menit untuk keseluruhannya.

• Sandbox image. Fetch the hardened image butuh akun NanoClaw gratis. Build it here tidak butuh akun dan memakan beberapa menit.
• AI service. Pilih Claude, lalu Paste an Anthropic API key. Setup menyimpan key di vault lokal bernama OneCLI. Key itu tidak pernah masuk ke container agen.
• Service. Setup menjalankan NanoClaw di latar belakang dan mengirim pesan test untuk mengecek bahwa agen membalas.

Setup juga menawarkan login dengan langganan. Jika Anda berencana memakainya, cek dulu ketentuan penyedia Anda tentang tool pihak ketiga.

Setelah setup, kirim pesan dari folder nanoclaw. Teks di dalam tanda kutip adalah pesan Anda. Untuk menjalankan health check lengkap lagi, pakai langkah verify.

cd ~/nanoclaw
pnpm run chat "Help me plan one of those weekend ideas."
pnpm run setup -- --step verify

Kami belum menjalankan instalasi ini di mesin test kami sendiri. Perintah di atas disalin dari dokumentasi NanoClaw per 2 Oktober 2026. Cek lagi sebelum Anda mulai.

Jaga tetap berjalan 24/7

Setup memasang LaunchAgent di folder LaunchAgents di dalam Library di home Anda. Namanya mirip com.nanoclaw-v2 ditambah kode pendek untuk salinan Anda. RunAtLoad dan KeepAlive sudah diatur. Jadi LaunchAgent berjalan saat login dan restart jika crash. Ini perintah yang terdokumentasi.

# Find your label
launchctl list | grep nanoclaw

# Restart
launchctl kickstart -k gui/$(id -u)/com.nanoclaw-v2-<slug>

# Stop / start
launchctl unload ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist
launchctl load   ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist

# Logs (stdout and stderr go to files, not the system log)
tail -f logs/nanoclaw.log logs/nanoclaw.error.log

Docker juga harus berjalan. Jika tidak, tidak ada agen yang bisa mulai. Dokumentasi troubleshooting menyuruh menjalankan Docker Desktop, mengecek bahwa docker info berfungsi, lalu me-restart NanoClaw. Di pengaturan Docker Desktop, aktifkan opsi untuk menjalankannya saat Anda login.

LaunchAgent hanya berjalan saat ada user yang login. Setelah reboot, tidak ada yang berjalan sampai seseorang login. Di Mac tanpa pengawasan, aktifkan login otomatis untuk akun yang menjalankan NanoClaw. Lalu cegah Mac tidur. Tidur menjeda Docker dan memutus semua koneksi chat.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Alasannya ada di apa yang terjadi saat Mac tidur. Checklist lengkapnya, termasuk listrik padam, ada di panduan Mac yang selalu menyala.

Catatan keamanan

• Agen hanya melihat folder yang Anda izinkan. File allowlist-nya adalah mount-allowlist.json di ~/.config/nanoclaw, di luar checkout. Pada instalasi baru, isinya kosong.
• Agen tidak pernah memegang API key mentah Anda. Request keluar melewati vault, yang menambahkan key saat request dikirim.
• Setup mengirim diagnostik anonim. Atur NANOCLAW_NO_DIAGNOSTICS=1 untuk mematikannya.
• Dokumentasinya punya halaman hardening untuk setup yang lebih ketat. Isinya mencakup batas akses jaringan, siapa yang boleh mengirim pesan ke agen, dan perintah apa yang boleh dijalankannya.

Container membantu, tetapi mesin khusus lebih membantu. Jalankan NanoClaw di Mac yang tidak menyimpan apa pun milik Anda selain itu. Jika agen berbuat aneh, kerusakannya berhenti di mesin itu. Untuk menghapusnya nanti, dokumentasinya memberi flag uninstall. Tambahkan --dry-run untuk melihat dulu apa yang akan dihapus.

bash nanoclaw.sh --uninstall

Menjalankannya di Mac MacRun

Paket agen kami adalah Mac mini khusus yang tidak pernah tidur. Mesinnya berada di fasilitas privat milik kami sendiri di New Jersey. Sesi login-nya kembali sendiri setelah reboot, jadi LaunchAgent berjalan lagi. Claude Code dan Codex sudah terpasang, sehingga kebutuhan NanoClaw akan Claude Code sudah terpenuhi. NanoClaw dan Docker Desktop tidak terpasang. Anda memasangnya sendiri, karena Anda punya akses admin penuh.

M6 dasar punya memori 16 GB, jauh di atas batas minimal 4 GB. Paket agen seharga $169 per bulan. MacRun tidak menjual API key. Pakai API key dari penyedia model Anda, yang menagih pemakaian sesuai ketentuannya sendiri.

Kapan Anda tidak butuh MacRun

Jika Anda sudah punya Mac yang selalu menyala dan login, pakai itu. Langkah di atas sama saja. NanoClaw juga berjalan di Linux dengan Docker Engine. Jika Anda tidak butuh apa pun dari macOS, server Linux kecil lebih murah daripada Mac mana pun.

MacRun juga untuk pekerjaan developer, sesuai kebijakan penggunaan kami. NanoClaw yang meninjau kode, memantau CI, atau menulis release notes cocok. NanoClaw yang mengurus chat keluarga tidak cocok. Siap mencobanya di mesin yang tetap menyala? Lihat halaman Mac untuk agen.