Lampiran

Troubleshooting — urutan cek

Saat rusak, jangan panik. Ikuti tangga cek resmi dari atas ke bawah. Catat hasil tiap anak tangga.

Daftar isi

Tangga triage
Tanda sehat
Pohon keputusan singkat
Pairing macet
Lab ops
FAQ

Fakta terverifikasi

Urutan: triage → status → status --all → gateway probe/status → doctor → channels status --probe → logs --follow
Doctor memperbaiki config/service
status --all untuk laporan yang bisa dibagikan (secrets disensor)

Tangga triage (wajib hafal)

openclaw triage
openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Jalankan satu per satu. Catat output di notebook lab.

Analogi: Seperti cek mobil: oli dulu, lalu aki, baru bongkar mesin. Jangan loncat ke logs mentah jika status sudah jelas.

Tanda sehat

triage menulis diagnosis yang sudah dibersihkan
status: channel configured, tanpa auth error
gateway probe: Reachable yes
gateway status: Runtime running, Connectivity probe ok
doctor: no blocking errors
channels probe: works / audit ok
logs: aktivitas stabil tanpa fatal berulang

Pohon keputusan singkat

Tidak ada balasan → status, gateway, channels probe, pairing list, logs
Control UI gagal connect → auth / origin / token / URL
Gateway tidak start → mode local, auth, EADDRINUSE (port dipakai)
Channel connect tapi pesan tidak mengalir → mention / pairing / permission
Cron/heartbeat gagal → cron status/list/runs
Browser tool gagal → browser status + plugins.allow

Pairing macet

Cek pairing list untuk channel terkait.

Kode kadaluarsa ~1 jam; buat request baru bila perlu.

Pastikan aturan chat pribadi memang pairing atau daftar putih sesuai niatmu.

Lab ops

Jalankan seluruh tangga sekali saat sehat (baseline) Latih matikan bot lalu hidupkan lagi Bandingkan status vs status --all Ikuti logs saat kirim pesan Telegram

Kuis singkat

Perintah pertama di tangga triage?
Mengapa status --all lebih aman dibagikan daripada logs mentah?
Port sering bentrok — gejala apa?

Kunci:

openclaw triage
Sudah disensor / lebih ringkas untuk dibagikan.
Port sudah dipakai / bot tidak mau start.

FAQ

Kapan doctor --fix? Saat docs/doctor menyarankan perbaikan aman; review dulu.

Bagagi logs mentah? Lebih aman status --all yang sudah redact.

Sumber

Troubleshooting