Pemecahan Masalah

Ada masalah? Jangan panik! Ikuti langkah-langkah di bawah ini, sebagian besar masalah bisa kamu selesaikan sendiri.

🔍 Langkah Diagnosis (Ikuti Urutannya)

Ketika OpenClaw bermasalah, lakukan pengecekan bertahap sesuai urutan berikut:

Cek Status

openclaw status

Lihat apakah OpenClaw masih berjalan. Jika menampilkan "stopped" atau error, coba restart terlebih dahulu.

Cek Status Gateway

openclaw gateway status

Gateway adalah jembatan yang menghubungkan OpenClaw dengan platform chat. Jika status gateway bermasalah, pesan chat tidak bisa dikirim atau diterima.

Lihat Log

openclaw logs

Log mencatat semua detail saat OpenClaw berjalan. Jika ada error, biasanya di log akan ada pesan error berwarna merah yang memberitahumu apa masalahnya.

Jalankan Health Check

openclaw doctor

Pemeriksaan kesehatan menyeluruh, akan memberitahumu komponen mana yang normal dan mana yang bermasalah.

Cek Koneksi Channel

openclaw channels status

Lihat status koneksi setiap channel chat, apakah ada yang terputus.

🐛 Error Umum dan Solusinya

Error: "openclaw: command not found"

Penyebab: Sistem tidak bisa menemukan perintah openclaw, biasanya masalah variabel lingkungan PATH.

Solusi:

# Cek lokasi instalasi openclaw
npm list -g openclaw

# Tambahkan direktori global npm ke PATH
export PATH="$(npm config get prefix)/bin:$PATH"

# Tambahkan perintah di atas ke file konfigurasi shell agar permanen
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Error: Konflik port (EADDRINUSE: address already in use :::18789)

Penyebab: Port 18789 sudah dipakai oleh program lain.

Solusi:

# Cari proses yang menggunakan port tersebut
lsof -i :18789

# Hentikan proses OpenClaw yang lama
openclaw stop

# Jika bukan proses OpenClaw, kamu bisa mengubah port di konfigurasi
# Edit ~/.openclaw/openclaw.json, ubah nilai port

Error: 429 Too Many Requests (Rate Limit)

Penyebab: Kamu mengirim request terlalu sering, provider model AI membatasi frekuensi panggilan API.

Solusi:

Tunggu beberapa menit lalu coba lagi
Kurangi frekuensi pengiriman pesan
Upgrade paket berbayar API-mu untuk mendapat rate limit yang lebih tinggi
Pertimbangkan beralih ke provider model dengan batasan yang lebih longgar

Error: Gateway tidak bisa dimulai

Penyebab: Mungkin Bot Token tidak valid, masalah koneksi jaringan, atau perubahan API platform chat.

Solusi:

# Cek log gateway
openclaw gateway logs

# Verifikasi apakah Bot Token masih valid
openclaw channels verify

# Restart gateway
openclaw gateway restart

Error: Pesan tidak terkirim

Penyebab: Mungkin konfigurasi channel salah, masalah jaringan, atau izin Bot tidak cukup.

Solusi:

Cek status channel: openclaw channels status
Pastikan Bot memiliki izin mengirim pesan di platform yang bersangkutan
Periksa apakah koneksi jaringan normal
Lihat apakah ada pesan error spesifik di log

Error: Dashboard tidak bisa dibuka

Penyebab: Layanan OpenClaw mungkin tidak berjalan, atau konfigurasi port salah.

Solusi:

# Pastikan OpenClaw sedang berjalan
openclaw status

# Jika tidak berjalan, mulai
openclaw start

# Lalu coba buka dashboard
openclaw dashboard

# Atau langsung akses di browser
# http://127.0.0.1:18789/

🆘 Masih Belum Terselesaikan?

Jika cara-cara di atas masih belum bisa menyelesaikan masalahmu, kamu bisa:

Cari atau kirim laporan masalah di GitHub Issues
Bergabung dengan komunitas Discord OpenClaw untuk meminta bantuan
Saat bertanya, sertakan output dari openclaw doctor dan openclaw logs