Langsung ke konten utama

Pemecahan masalah channel

Gunakan halaman ini saat sebuah channel terhubung tetapi perilakunya salah.

Urutan perintah

Jalankan ini terlebih dahulu secara berurutan:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Baseline sehat:
  • Runtime: running
  • RPC probe: ok
  • Probe channel menunjukkan transport terhubung dan, jika didukung, works atau audit ok

WhatsApp

Signature kegagalan WhatsApp

GejalaPemeriksaan tercepatPerbaikan
Terhubung tetapi tidak ada balasan DMopenclaw pairing list whatsappSetujui pengirim atau ubah kebijakan/allowlist DM.
Pesan grup diabaikanPeriksa requireMention + pola mention di konfigurasiMention bot atau longgarkan kebijakan mention untuk grup itu.
Putus sambung acak/loop login ulangopenclaw channels status --probe + logLogin ulang dan verifikasi direktori kredensial sehat.
Pemecahan masalah lengkap: /channels/whatsapp#troubleshooting

Telegram

Signature kegagalan Telegram

GejalaPemeriksaan tercepatPerbaikan
/start tetapi tidak ada alur balasan yang dapat digunakanopenclaw pairing list telegramSetujui pairing atau ubah kebijakan DM.
Bot online tetapi grup tetap diamVerifikasi persyaratan mention dan mode privasi botNonaktifkan mode privasi untuk visibilitas grup atau mention bot.
Kegagalan kirim dengan kesalahan jaringanPeriksa log untuk kegagalan panggilan Telegram APIPerbaiki routing DNS/IPv6/proxy ke api.telegram.org.
setMyCommands ditolak saat startupPeriksa log untuk BOT_COMMANDS_TOO_MUCHKurangi perintah Telegram plugin/Skills/kustom atau nonaktifkan menu native.
Sudah upgrade dan allowlist memblokir Andaopenclaw security audit dan allowlist konfigurasiJalankan openclaw doctor --fix atau ganti @username dengan ID pengirim numerik.
Pemecahan masalah lengkap: /channels/telegram#troubleshooting

Discord

Signature kegagalan Discord

GejalaPemeriksaan tercepatPerbaikan
Bot online tetapi tidak ada balasan guildopenclaw channels status --probeIzinkan guild/channel dan verifikasi message content intent.
Pesan grup diabaikanPeriksa log untuk drop mention gatingMention bot atau setel guild/channel requireMention: false.
Balasan DM tidak adaopenclaw pairing list discordSetujui pairing DM atau sesuaikan kebijakan DM.
Pemecahan masalah lengkap: /channels/discord#troubleshooting

Slack

Signature kegagalan Slack

GejalaPemeriksaan tercepatPerbaikan
Socket mode terhubung tetapi tidak ada responsopenclaw channels status --probeVerifikasi app token + bot token dan scope yang diperlukan; perhatikan botTokenStatus / appTokenStatus = configured_unavailable pada penyiapan berbasis SecretRef.
DM diblokiropenclaw pairing list slackSetujui pairing atau longgarkan kebijakan DM.
Pesan channel diabaikanPeriksa groupPolicy dan allowlist channelIzinkan channel atau ubah kebijakan menjadi open.
Pemecahan masalah lengkap: /channels/slack#troubleshooting

iMessage dan BlueBubbles

Signature kegagalan iMessage dan BlueBubbles

GejalaPemeriksaan tercepatPerbaikan
Tidak ada event masukVerifikasi keterjangkauan webhook/server dan izin aplikasiPerbaiki URL webhook atau status server BlueBubbles.
Bisa mengirim tetapi tidak menerima di macOSPeriksa izin privasi macOS untuk otomasi MessagesBerikan ulang izin TCC dan restart proses channel.
Pengirim DM diblokiropenclaw pairing list imessage atau openclaw pairing list bluebubblesSetujui pairing atau perbarui allowlist.
Pemecahan masalah lengkap:

Signal

Signature kegagalan Signal

GejalaPemeriksaan tercepatPerbaikan
Daemon dapat dijangkau tetapi bot diamopenclaw channels status --probeVerifikasi URL/akun daemon signal-cli dan mode receive.
DM diblokiropenclaw pairing list signalSetujui pengirim atau sesuaikan kebijakan DM.
Balasan grup tidak terpicuPeriksa allowlist grup dan pola mentionTambahkan pengirim/grup atau longgarkan gating.
Pemecahan masalah lengkap: /channels/signal#troubleshooting

QQ Bot

Signature kegagalan QQ Bot

GejalaPemeriksaan tercepatPerbaikan
Bot membalas “gone to Mars”Verifikasi appId dan clientSecret di konfigurasiSetel kredensial atau restart gateway.
Tidak ada pesan masukopenclaw channels status --probeVerifikasi kredensial di QQ Open Platform.
Suara tidak ditranskripsikanPeriksa konfigurasi provider STTKonfigurasikan channels.qqbot.stt atau tools.media.audio.
Pesan proaktif tidak sampaiPeriksa persyaratan interaksi platform QQQQ mungkin memblokir pesan yang diprakarsai bot tanpa interaksi baru-baru ini.
Pemecahan masalah lengkap: /channels/qqbot#troubleshooting

Matrix

Signature kegagalan Matrix

GejalaPemeriksaan tercepatPerbaikan
Sudah login tetapi mengabaikan pesan roomopenclaw channels status --probePeriksa groupPolicy, allowlist room, dan mention gating.
DM tidak diprosesopenclaw pairing list matrixSetujui pengirim atau sesuaikan kebijakan DM.
Room terenkripsi gagalopenclaw matrix verify statusVerifikasi ulang device, lalu periksa openclaw matrix verify backup status.
Pemulihan backup tertunda/rusakopenclaw matrix verify backup statusJalankan openclaw matrix verify backup restore atau jalankan ulang dengan recovery key.
Cross-signing/bootstrap tampak salahopenclaw matrix verify bootstrapPerbaiki status secret storage, cross-signing, dan backup dalam satu langkah.
Penyiapan dan konfigurasi lengkap: Matrix