Pemecahan masalah saluran

Gunakan halaman ini saat channel terhubung tetapi perilakunya salah.

Tangga perintah

Jalankan ini secara berurutan terlebih dahulu:

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

Baseline sehat:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable, atau admin-capable
Probe channel menunjukkan transport terhubung dan, jika didukung, works atau audit ok

Setelah pembaruan

Gunakan ini saat Telegram, iMessage, konfigurasi era BlueBubbles, atau channel Plugin lain menghilang setelah pembaruan.

openclaw status --all
openclaw doctor --fix
openclaw gateway restart
openclaw status --all

Cari plugin load failed: dependency tree corrupted; run openclaw doctor --fix di openclaw status --all. Itu berarti channel telah dikonfigurasi, tetapi jalur penyiapan/pemuatan Plugin menemui pohon dependensi yang rusak alih-alih mendaftarkan channel. openclaw doctor --fix menghapus direktori staging dependensi Plugin yang usang dan bayangan auth yang usang, lalu openclaw gateway restart memuat ulang status bersih.

Tanda kegagalan WhatsApp

Gejala	Pemeriksaan tercepat	Perbaikan
Terhubung tetapi tidak ada balasan DM	`openclaw pairing list whatsapp`	Setujui pengirim atau ubah kebijakan/daftar izin DM.
Pesan grup diabaikan	Periksa pola `requireMention` + mention di konfigurasi	Mention bot atau longgarkan kebijakan mention untuk grup tersebut.
Login QR habis waktu dengan 408	Periksa env Gateway `HTTPS_PROXY` / `HTTP_PROXY`	Tetapkan proxy yang dapat dijangkau; gunakan `NO_PROXY` hanya untuk bypass.
Loop putus/masuk ulang acak	`openclaw channels status --probe` + log	Reconnect terbaru ditandai meskipun saat ini terhubung; pantau log, restart Gateway, lalu tautkan ulang jika flapping berlanjut.
Loop `status=408 Request Time-out`	Probe, log, doctor, lalu status Gateway	Perbaiki konektivitas/timing host terlebih dahulu; cadangkan auth dan tautkan ulang akun jika loop berlanjut.
Balasan tiba terlambat detik/menit	`openclaw doctor --fix`	Doctor menghentikan klien TUI lokal usang yang terverifikasi ketika klien tersebut menurunkan kinerja loop peristiwa Gateway.

Pemecahan masalah lengkap: Pemecahan masalah WhatsApp

Tanda kegagalan Telegram

Gejala	Pemeriksaan tercepat	Perbaikan
`/start` tetapi tidak ada alur balasan yang dapat digunakan	`openclaw pairing list telegram`	Setujui pairing atau ubah kebijakan DM.
Bot online tetapi grup tetap diam	Verifikasi persyaratan mention dan mode privasi bot	Nonaktifkan mode privasi untuk visibilitas grup atau mention bot.
Kegagalan kirim dengan galat jaringan	Periksa log untuk kegagalan panggilan API Telegram	Perbaiki routing DNS/IPv6/proxy ke `api.telegram.org`.
Startup melaporkan `getMe returned 401`	Periksa sumber token yang dikonfigurasi	Salin ulang atau buat ulang token BotFather dan perbarui `botToken`, `tokenFile`, atau akun default `TELEGRAM_BOT_TOKEN`.
Polling macet atau reconnect lambat	`openclaw logs --follow` untuk diagnostik polling	Tingkatkan versi; jika restart adalah positif palsu, sesuaikan `pollingStallThresholdMs`. Macet persisten tetap mengarah ke proxy/DNS/IPv6.
`setMyCommands` ditolak saat startup	Periksa log untuk `BOT_COMMANDS_TOO_MUCH`	Kurangi perintah Telegram dari Plugin/skill/kustom atau nonaktifkan menu native.
Setelah upgrade, daftar izin memblokir Anda	`openclaw security audit` dan daftar izin konfigurasi	Jalankan `openclaw doctor --fix` atau ganti `@username` dengan ID pengirim numerik.

Pemecahan masalah lengkap: Pemecahan masalah Telegram

Discord

Tanda kegagalan Discord

Gejala	Pemeriksaan tercepat	Perbaikan
Bot online tetapi tidak ada balasan guild	`openclaw channels status --probe`	Izinkan guild/channel dan verifikasi intent konten pesan.
Pesan grup diabaikan	Periksa log untuk drop gating mention	Mention bot atau tetapkan `requireMention: false` pada guild/channel.
Penggunaan typing/token tetapi tidak ada pesan Discord	Periksa apakah ini peristiwa ruang ambient atau ruang `message_tool` yang diikutsertakan ketika model melewatkan `message(action=send)`	Periksa log verbose Gateway untuk metadata payload akhir yang ditekan, verifikasi `messages.groupChat.unmentionedInbound`, baca Peristiwa ruang ambient, atau pertahankan `messages.groupChat.visibleReplies: "automatic"` untuk permintaan grup normal.
Balasan DM hilang	`openclaw pairing list discord`	Setujui pairing DM atau sesuaikan kebijakan DM.

Pemecahan masalah lengkap: Pemecahan masalah Discord

Slack

Tanda kegagalan Slack

Gejala	Pemeriksaan tercepat	Perbaikan
Mode socket terhubung tetapi tidak ada respons	`openclaw channels status --probe`	Verifikasi token aplikasi + token bot dan scope yang diperlukan; pantau `botTokenStatus` / `appTokenStatus = configured_unavailable` pada penyiapan berbasis SecretRef.
DM diblokir	`openclaw pairing list slack`	Setujui pairing atau longgarkan kebijakan DM.
Pesan channel diabaikan	Periksa `groupPolicy` dan daftar izin channel	Izinkan channel atau ubah kebijakan ke `open`.

Pemecahan masalah lengkap: Pemecahan masalah Slack

iMessage

Tanda kegagalan iMessage

Gejala	Pemeriksaan tercepat	Perbaikan
`imsg` hilang atau gagal di non-macOS	`openclaw channels status --probe --channel imessage`	Jalankan OpenClaw di Mac Messages atau gunakan wrapper SSH untuk `cliPath`.
Dapat mengirim tetapi tidak menerima di macOS	Periksa izin privasi macOS untuk automasi Messages	Berikan ulang izin TCC dan restart proses channel.
Pengirim DM diblokir	`openclaw pairing list imessage`	Setujui pairing atau perbarui daftar izin.

Pemecahan masalah lengkap:

Pemecahan masalah iMessage

Signal

Tanda kegagalan Signal

Gejala	Pemeriksaan tercepat	Perbaikan
Daemon dapat dijangkau tetapi bot diam	`openclaw channels status --probe`	Verifikasi URL/akun daemon `signal-cli` dan mode penerimaan.
DM diblokir	`openclaw pairing list signal`	Setujui pengirim atau sesuaikan kebijakan DM.
Balasan grup tidak terpicu	Periksa daftar izin grup dan pola mention	Tambahkan pengirim/grup atau longgarkan gating.

Pemecahan masalah lengkap: Pemecahan masalah Signal

QQ Bot

Tanda kegagalan QQ Bot

Gejala	Pemeriksaan tercepat	Perbaikan
Bot membalas “gone to Mars”	Verifikasi `appId` dan `clientSecret` di konfigurasi	Tetapkan kredensial atau restart Gateway.
Tidak ada pesan masuk	`openclaw channels status --probe`	Verifikasi kredensial di QQ Open Platform.
Suara tidak ditranskripsi	Periksa konfigurasi penyedia STT	Konfigurasikan `channels.qqbot.stt` atau `tools.media.audio`.
Pesan proaktif tidak tiba	Periksa persyaratan interaksi platform QQ	QQ dapat memblokir pesan yang dimulai bot tanpa interaksi terbaru.

Pemecahan masalah lengkap: Pemecahan masalah QQ Bot

Matrix

Tanda kegagalan Matrix

Gejala	Pemeriksaan tercepat	Perbaikan
Sudah masuk tetapi mengabaikan pesan ruang	`openclaw channels status --probe`	Periksa `groupPolicy`, daftar izin ruang, dan gating penyebutan.
DM tidak diproses	`openclaw pairing list matrix`	Setujui pengirim atau sesuaikan kebijakan DM.
Ruang terenkripsi gagal	`openclaw matrix verify status`	Verifikasi ulang perangkat, lalu periksa `openclaw matrix verify backup status`.
Pemulihan cadangan tertunda/rusak	`openclaw matrix verify backup status`	Jalankan `openclaw matrix verify backup restore` atau jalankan ulang dengan kunci pemulihan.
Penandatanganan silang/bootstrap terlihat salah	`openclaw matrix verify bootstrap`	Perbaiki penyimpanan rahasia, penandatanganan silang, dan status cadangan dalam satu proses.

Penyiapan dan konfigurasi lengkap: Matrix

​Tangga perintah

​Setelah pembaruan

​WhatsApp

​Tanda kegagalan WhatsApp

​Telegram

​Tanda kegagalan Telegram

​Discord

​Tanda kegagalan Discord

​Slack

​Tanda kegagalan Slack

​iMessage

​Tanda kegagalan iMessage

​Signal

​Tanda kegagalan Signal

​QQ Bot

​Tanda kegagalan QQ Bot

​Matrix

​Tanda kegagalan Matrix

​Terkait