Instalasi & Setup OpenClaw

Apa Itu OpenClaw?

OpenClaw adalah personal AI assistant dan AI agent yang berjalan di komputer atau server milik kita sendiri.

Berbeda dengan chatbot biasa yang hanya menjawab pertanyaan, OpenClaw dirancang agar AI dapat menggunakan tools, memory, sessions, skills, dan agent untuk membantu melakukan pekerjaan secara langsung.

OpenClaw juga dapat dihubungkan ke berbagai platform seperti:

• +

  WhatsApp

• +

  Telegram

• +

  Discord

• +

  Slack

• +

  Microsoft Teams

• +

  Google Chat

• +

  Signal

• +

  dan berbagai channel lainnya

Sederhananya:

Kamu
  ↓
WhatsApp / Telegram / Dashboard
  ↓
OpenClaw
  ↓
AI Model
  ↓
Tools / Skills / File / Browser / Automation

Jadi OpenClaw bisa digunakan sebagai AI assistant pribadi yang selalu tersedia, baik dari komputer sendiri maupun melalui chat yang kita gunakan sehari-hari.

Sebelum Instalasi

Cara instalasi OpenClaw sekarang jauh lebih simpel.

Installer resminya dapat:

Mendeteksi sistem operasi
→ Mengecek Node.js
→ Menginstall Node.js jika diperlukan
→ Menginstall OpenClaw
→ Menjalankan onboarding

OpenClaw saat ini membutuhkan versi Node.js yang didukung, tetapi jika Node.js belum terinstall, installer resmi dapat menyiapkannya secara otomatis.

Jadi untuk instalasi normal, cukup siapkan:

Windows

PowerShell
Internet

Linux

Terminal
curl
Internet

Tidak perlu menginstall Docker, pnpm, atau dependency development lainnya untuk instalasi biasa. pnpm hanya diperlukan jika ingin menjalankan OpenClaw dari source code.

Instalasi OpenClaw di Windows

Buka PowerShell, kemudian jalankan satu command:

$ powershell -c "irm https://openclaw.ai/install.ps1 | iex"

Installer akan mengurus dependency yang dibutuhkan, menginstall OpenClaw, kemudian menjalankan proses onboarding. Installer script merupakan metode instalasi tercepat yang direkomendasikan dokumentasi OpenClaw.

Instalasi OpenClaw di Linux

Buka terminal kemudian jalankan:

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

Installer akan mengecek environment, menyiapkan Node.js jika diperlukan, menginstall OpenClaw, dan menjalankan onboarding.

Command yang sama juga dapat digunakan pada macOS dan WSL2.

Setup Pertama

Setelah instalasi selesai, OpenClaw akan membawa kita ke proses onboarding.

Di sini kita akan melakukan konfigurasi awal seperti:

OpenClaw
   ↓
Pilih / hubungkan AI Provider
   ↓
Pilih Model
   ↓
Konfigurasi Gateway
   ↓
Optional: Hubungkan Channel
   ↓
Selesai

Provider dan metode autentikasi yang tersedia dapat berbeda tergantung model yang ingin digunakan.

Channel seperti WhatsApp, Telegram, atau Discord juga tidak wajib langsung dipasang. Kita bisa menyelesaikan setup dasar terlebih dahulu dan menambahkannya nanti.

OpenClaw versi terbaru juga menyediakan guided setup melalui Control UI untuk konfigurasi provider, channel, dan session.

Mengecek OpenClaw Berhasil Terinstall

Cek versi:

$ openclaw --version

Kemudian cek status:

$ openclaw status

openclaw status menampilkan ringkasan seperti kondisi Gateway, agent/session, provider, serta masalah konfigurasi yang terdeteksi.

Untuk pemeriksaan lebih lengkap:

$ openclaw status --all

Membuka Dashboard OpenClaw

Jalankan:

$ openclaw dashboard

Command tersebut membuka Control UI OpenClaw, tempat kita dapat mengelola dan menggunakan OpenClaw melalui browser.

Jika Ingin Menjalankan Setup Lagi

Gunakan:

$ openclaw onboard

Untuk konfigurasi yang lebih lengkap seperti provider tertentu, channel, skills, import, atau pengaturan Gateway lanjutan:

$ openclaw onboard --classic

Menjalankan onboarding kembali tidak otomatis menghapus konfigurasi yang sudah ada kecuali kita secara eksplisit memilih reset.

Update OpenClaw

Untuk memperbarui OpenClaw:

$ openclaw update

OpenClaw memiliki updater sendiri sehingga tidak perlu melakukan instalasi ulang manual setiap kali ada versi baru.

Setelah update, cek kembali:

$ openclaw status

Troubleshooting

openclaw Command Tidak Ditemukan

Jika muncul:

openclaw: command not found

atau di Windows:

'openclaw' is not recognized

tutup terminal lalu buka kembali. Kemudian coba:

$ openclaw --version

Jika tetap tidak tersedia, jalankan kembali installer resmi.

Windows

$ powershell -c "irm https://openclaw.ai/install.ps1 | iex"

Linux

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

OpenClaw Error atau Tidak Berjalan Normal

Jalankan:

$ openclaw doctor

Ini adalah command troubleshooting utama OpenClaw.

openclaw doctor akan memeriksa konfigurasi, Gateway, channel, plugin, skills, model routing, dan state OpenClaw kemudian memberikan langkah perbaikan jika menemukan masalah.

Jika ingin mencoba menerapkan perbaikan yang direkomendasikan:

$ openclaw doctor --fix

Gateway Tidak Bisa Terhubung

Cek:

$ openclaw gateway status

Kemudian:

$ openclaw status --deep

Untuk melihat log secara langsung:

$ openclaw logs --follow

Command tersebut merupakan bagian dari troubleshooting resmi OpenClaw untuk mengecek Gateway dan konektivitas.

Jika diperlukan, restart Gateway:

$ openclaw gateway restart

Config Error

Jika muncul pesan seperti:

Invalid config

cek konfigurasi dengan:

$ openclaw config validate

Kemudian jalankan:

$ openclaw doctor --fix

Dokumentasi OpenClaw merekomendasikan alur tersebut untuk konfigurasi yang invalid.

Dashboard Error Setelah Update

Jika dashboard menampilkan:

Protocol mismatch

jalankan kembali:

$ openclaw dashboard

kemudian lakukan hard refresh pada browser.

Jika masih bermasalah, bersihkan site data/cache dashboard atau coba buka menggunakan private/incognito window.

Command Penting OpenClaw

Untuk penggunaan sehari-hari, sebenarnya cukup ingat beberapa command berikut:

$ # Cek versi
openclaw --version

# Cek kondisi OpenClaw
openclaw status

# Buka dashboard
openclaw dashboard

# Setup ulang
openclaw onboard

# Cari dan perbaiki error
openclaw doctor

# Restart Gateway
openclaw gateway restart

# Lihat log
openclaw logs --follow

# Update
openclaw update

Catatan Keamanan

OpenClaw bukan sekadar chatbot. Agent dapat diberikan akses ke tools, browser, file, command, perangkat, dan layanan lainnya, sehingga akses tersebut harus dianggap sensitif.

Hindari:

Mengekspos Gateway ke internet sembarangan
Memberikan credential yang tidak diperlukan
Menginstall plugin/skill dari sumber tidak dipercaya
Memberikan permission berlebihan kepada agent

Gateway OpenClaw sendiri menggunakan authentication secara default dan onboarding membuat token untuk mengamankan akses Gateway.

Ringkasan

Instalasi OpenClaw sekarang bisa dilakukan hanya dengan satu command.

Windows

$ powershell -c "irm https://openclaw.ai/install.ps1 | iex"

Linux

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

Setelah installer selesai:

Install
  ↓
Onboarding
  ↓
Hubungkan AI Provider
  ↓
Pilih Model
  ↓
Buka Dashboard
  ↓
OpenClaw Siap Digunakan

Jika suatu saat terjadi error, command pertama yang sebaiknya dicoba adalah:

$ openclaw doctor

dan untuk mengecek kondisi keseluruhan:

$ openclaw status

Dengan setup ini, kita sudah memiliki fondasi OpenClaw dan bisa lanjut ke materi berikutnya seperti menghubungkan provider/model, memasang Skills, menghubungkan WhatsApp/Telegram, atau membuat AI agent sendiri.