Configuration

Pemecahan masalah saluran

Gunakan halaman ini saat saluran tersambung tetapi perilakunya salah.

Urutan perintah

Jalankan ini secara berurutan terlebih dahulu:

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Baseline sehat:

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

Gejala	Pemeriksaan tercepat	Perbaikan
Tersambung tetapi tidak ada balasan DM	`openclaw pairing list whatsapp`	Setujui pengirim atau ubah kebijakan/allowlist DM.
Pesan grup diabaikan	Periksa `requireMention` + pola mention di config	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 sambung/login ulang acak	`openclaw channels status --probe` + log	Reconnect terbaru ditandai meskipun saat ini tersambung; pantau log, mulai ulang Gateway, lalu tautkan ulang jika flapping berlanjut.
Balasan tiba terlambat beberapa detik/menit	`openclaw doctor --fix`	Doctor menghentikan klien TUI lokal usang yang terverifikasi saat klien tersebut menurunkan kinerja event loop Gateway.

Pemecahan masalah lengkap: Pemecahan masalah WhatsApp

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 senyap	Verifikasi persyaratan mention dan mode privasi bot	Nonaktifkan mode privasi untuk visibilitas grup atau mention bot.
Kegagalan kirim dengan error 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 `TELEGRAM_BOT_TOKEN` akun default.
Polling macet atau reconnect lambat	`openclaw logs --follow` untuk diagnostik polling	Upgrade; jika restart adalah positif palsu, sesuaikan `pollingStallThresholdMs`. Kemacetan persisten tetap mengarah ke proxy/DNS/IPv6.
`setMyCommands` ditolak saat startup	Periksa log untuk `BOT_COMMANDS_TOO_MUCH`	Kurangi perintah Telegram Plugin/skill/kustom atau nonaktifkan menu native.
Setelah upgrade, allowlist memblokir Anda	`openclaw security audit` dan allowlist config	Jalankan `openclaw doctor --fix` atau ganti `@username` dengan ID pengirim numerik.

Pemecahan masalah lengkap: Pemecahan masalah Telegram

Gejala	Pemeriksaan tercepat	Perbaikan
Bot online tetapi tidak ada balasan guild	`openclaw channels status --probe`	Izinkan guild/saluran dan verifikasi intent konten pesan.
Pesan grup diabaikan	Periksa log untuk drop karena gating mention	Mention bot atau tetapkan `requireMention: false` guild/saluran.
Ada aktivitas mengetik/penggunaan token tetapi tidak ada pesan Discord	Log sesi menunjukkan teks asisten dengan `didSendViaMessagingTool: false`	Model menjawab secara privat alih-alih memanggil tool pesan. Gunakan model yang andal untuk tool-call, atau tetapkan `messages.groupChat.visibleReplies: "automatic"` untuk mem-posting otomatis.
Balasan DM hilang	`openclaw pairing list discord`	Setujui pairing DM atau sesuaikan kebijakan DM.

Pemecahan masalah lengkap: Pemecahan masalah Discord

Gejala	Pemeriksaan tercepat	Perbaikan
Socket mode tersambung tetapi tidak ada respons	`openclaw channels status --probe`	Verifikasi token app + token bot dan scope yang diperlukan; pantau `botTokenStatus` / `appTokenStatus = configured_unavailable` pada setup berbasis SecretRef.
DM diblokir	`openclaw pairing list slack`	Setujui pairing atau longgarkan kebijakan DM.
Pesan saluran diabaikan	Periksa `groupPolicy` dan allowlist saluran	Izinkan saluran atau ubah kebijakan menjadi `open`.

Pemecahan masalah lengkap: Pemecahan masalah Slack

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 mulai ulang proses saluran.
Pengirim DM diblokir	`openclaw pairing list imessage`	Setujui pairing atau perbarui allowlist.

Pemecahan masalah lengkap:

Gejala	Pemeriksaan tercepat	Perbaikan
Daemon dapat dijangkau tetapi bot senyap	`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 allowlist grup dan pola mention	Tambahkan pengirim/grup atau longgarkan gating.

Pemecahan masalah lengkap: Pemecahan masalah Signal

Gejala	Pemeriksaan tercepat	Perbaikan
Bot membalas "gone to Mars"	Verifikasi `appId` dan `clientSecret` di config	Tetapkan kredensial atau mulai ulang Gateway.
Tidak ada pesan masuk	`openclaw channels status --probe`	Verifikasi kredensial di QQ Open Platform.
Suara tidak ditranskripsikan	Periksa config penyedia STT	Konfigurasi `channels.qqbot.stt` atau `tools.media.audio`.
Pesan proaktif tidak tiba	Periksa persyaratan interaksi platform QQ	QQ dapat memblokir pesan yang diinisiasi bot tanpa interaksi terbaru.

Pemecahan masalah lengkap: Pemecahan masalah QQ Bot

Gejala	Pemeriksaan tercepat	Perbaikan
Sudah login tetapi mengabaikan pesan ruang	`openclaw channels status --probe`	Periksa `groupPolicy`, allowlist ruang, dan gating mention.
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 backup tertunda/rusak	`openclaw matrix verify backup status`	Jalankan `openclaw matrix verify backup restore` atau jalankan ulang dengan recovery key.
Cross-signing/bootstrap terlihat salah	`openclaw matrix verify bootstrap`	Perbaiki penyimpanan secret, cross-signing, dan status backup dalam satu kali proses.

Setup dan config lengkap: Matrix

Was this useful?