> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Pemecahan masalah saluran Gunakan halaman ini saat channel terhubung tetapi perilakunya salah. ## Tangga perintah Jalankan ini secara berurutan terlebih dahulu: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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. ## WhatsApp ### 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](/id/channels/whatsapp#troubleshooting) ## Telegram ### 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](/id/channels/telegram#troubleshooting) ## 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](/id/channels/ambient-room-events), 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](/id/channels/discord#troubleshooting) ## 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](/id/channels/slack#troubleshooting) ## 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](/id/channels/imessage#troubleshooting) ## 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](/id/channels/signal#troubleshooting) ## 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](/id/channels/qqbot#troubleshooting) ## 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](/id/channels/matrix) ## Terkait * [Pairing](/id/channels/pairing) * [Perutean channel](/id/channels/channel-routing) * [Pemecahan masalah Gateway](/id/gateway/troubleshooting)