Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Gunakan halaman ini saat saluran tersambung tetapi perilakunya salah.

​
Urutan 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 saluran menunjukkan transport tersambung dan, jika didukung, works atau audit ok

​
WhatsApp

​
Pola kegagalan WhatsApp

GejalaPemeriksaan tercepatPerbaikan
Tersambung tetapi tidak ada balasan DMopenclaw pairing list whatsappSetujui pengirim atau ubah kebijakan/allowlist DM.
Pesan grup diabaikanPeriksa requireMention + pola mention di configMention bot atau longgarkan kebijakan mention untuk grup tersebut.
Login QR habis waktu dengan 408Periksa env Gateway HTTPS_PROXY / HTTP_PROXYTetapkan proxy yang dapat dijangkau; gunakan NO_PROXY hanya untuk bypass.
Loop putus sambung/login ulang acakopenclaw channels status --probe + logReconnect terbaru ditandai meskipun saat ini tersambung; pantau log, mulai ulang Gateway, lalu tautkan ulang jika flapping berlanjut.
Balasan tiba terlambat beberapa detik/menitopenclaw doctor --fixDoctor menghentikan klien TUI lokal usang yang terverifikasi saat klien tersebut menurunkan kinerja event loop Gateway.
Pemecahan masalah lengkap: Pemecahan masalah WhatsApp

​
Telegram

​
Pola 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 senyapVerifikasi persyaratan mention dan mode privasi botNonaktifkan mode privasi untuk visibilitas grup atau mention bot.
Kegagalan kirim dengan error jaringanPeriksa log untuk kegagalan panggilan API TelegramPerbaiki routing DNS/IPv6/proxy ke api.telegram.org.
Startup melaporkan getMe returned 401Periksa sumber token yang dikonfigurasiSalin ulang atau buat ulang token BotFather dan perbarui botToken, tokenFile, atau TELEGRAM_BOT_TOKEN akun default.
Polling macet atau reconnect lambatopenclaw logs --follow untuk diagnostik pollingUpgrade; jika restart adalah positif palsu, sesuaikan pollingStallThresholdMs. Kemacetan persisten tetap mengarah ke proxy/DNS/IPv6.
setMyCommands ditolak saat startupPeriksa log untuk BOT_COMMANDS_TOO_MUCHKurangi perintah Telegram Plugin/skill/kustom atau nonaktifkan menu native.
Setelah upgrade, allowlist memblokir Andaopenclaw security audit dan allowlist configJalankan openclaw doctor --fix atau ganti @username dengan ID pengirim numerik.
Pemecahan masalah lengkap: Pemecahan masalah Telegram

​
Discord

​
Pola kegagalan Discord

GejalaPemeriksaan tercepatPerbaikan
Bot online tetapi tidak ada balasan guildopenclaw channels status --probeIzinkan guild/saluran dan verifikasi intent konten pesan.
Pesan grup diabaikanPeriksa log untuk drop karena gating mentionMention bot atau tetapkan requireMention: false guild/saluran.
Ada aktivitas mengetik/penggunaan token tetapi tidak ada pesan DiscordLog sesi menunjukkan teks asisten dengan didSendViaMessagingTool: falseModel 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 hilangopenclaw pairing list discordSetujui pairing DM atau sesuaikan kebijakan DM.
Pemecahan masalah lengkap: Pemecahan masalah Discord

​
Slack

​
Pola kegagalan Slack

GejalaPemeriksaan tercepatPerbaikan
Socket mode tersambung tetapi tidak ada responsopenclaw channels status --probeVerifikasi token app + token bot dan scope yang diperlukan; pantau botTokenStatus / appTokenStatus = configured_unavailable pada setup berbasis SecretRef.
DM diblokiropenclaw pairing list slackSetujui pairing atau longgarkan kebijakan DM.
Pesan saluran diabaikanPeriksa groupPolicy dan allowlist saluranIzinkan saluran atau ubah kebijakan menjadi open.
Pemecahan masalah lengkap: Pemecahan masalah Slack

​
iMessage

​
Pola kegagalan iMessage

GejalaPemeriksaan tercepatPerbaikan
imsg hilang atau gagal di non-macOSopenclaw channels status --probe --channel imessageJalankan OpenClaw di Mac Messages atau gunakan wrapper SSH untuk cliPath.
Dapat mengirim tetapi tidak menerima di macOSPeriksa izin privasi macOS untuk automasi MessagesBerikan ulang izin TCC dan mulai ulang proses saluran.
Pengirim DM diblokiropenclaw pairing list imessageSetujui pairing atau perbarui allowlist.
Pemecahan masalah lengkap:

​
Signal

​
Pola kegagalan Signal

GejalaPemeriksaan tercepatPerbaikan
Daemon dapat dijangkau tetapi bot senyapopenclaw channels status --probeVerifikasi URL/akun daemon signal-cli dan mode penerimaan.
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: Pemecahan masalah Signal

​
QQ Bot

​
Pola kegagalan QQ Bot

GejalaPemeriksaan tercepatPerbaikan
Bot membalas “gone to Mars”Verifikasi appId dan clientSecret di configTetapkan kredensial atau mulai ulang Gateway.
Tidak ada pesan masukopenclaw channels status --probeVerifikasi kredensial di QQ Open Platform.
Suara tidak ditranskripsikanPeriksa config penyedia STTKonfigurasi channels.qqbot.stt atau tools.media.audio.
Pesan proaktif tidak tibaPeriksa persyaratan interaksi platform QQQQ dapat memblokir pesan yang diinisiasi bot tanpa interaksi terbaru.
Pemecahan masalah lengkap: Pemecahan masalah QQ Bot

​
Matrix

​
Pola kegagalan Matrix

GejalaPemeriksaan tercepatPerbaikan
Sudah login tetapi mengabaikan pesan ruangopenclaw channels status --probePeriksa groupPolicy, allowlist ruang, dan gating mention.
DM tidak diprosesopenclaw pairing list matrixSetujui pengirim atau sesuaikan kebijakan DM.
Ruang terenkripsi gagalopenclaw matrix verify statusVerifikasi ulang perangkat, 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 terlihat salahopenclaw matrix verify bootstrapPerbaiki penyimpanan secret, cross-signing, dan status backup dalam satu kali proses.
Setup dan config lengkap: Matrix

​
Terkait