Lampiran

Troubleshooting — urutan cek

Pas rusak, jangan panik. Intinya: 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

Yang sudah dicek

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 — biar baseline-nya jelas.

Analogi: Kayak cek mobil: oli dulu, lalu aki, baru bongkar mesin. Jangan loncat ke logs mentah kalau status udah 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

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

Pairing macet

Cek pairing list buat channel terkait.

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

Pastiin 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 (klik buat buka)

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 nyaranin perbaikan aman; review dulu.

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

Sumber

Troubleshooting