Betulkan OpenClaw yang Tidak Berfungsi di Botchat – Panduan Semak & Baiki

Belum cukup bukti untuk menentukan punca khusus kegagalan OpenClaw di botchat anda, tetapi laluan diagnosis yang betul sudah tersedia dengan jelas. Prosedur standard yang disarankan dokumentasi adalah menjalankan serangkaian arahan ini secara berurutan:

openclaw status

openclaw gateway status

openclaw logs --follow

openclaw doctor

openclaw channels status --probe

Perkara yang Perlu Disemak Segera

• Garis Dasar Sihat: Buka terminal dan pastikan output menunjukkan

  Runtime: running

  ,

  Connectivity probe: ok

  , dan Capability yang sah seperti read-only atau write-capable. Siasatan saluran pula mesti menunjukkan

  transport connected

  . Di platform yang menyokong, anda patut melihat status works atau

  audit ok

  .
• Bot Telegram "Online" Tetapi Kumpulan Senyap: Jika ini berlaku, dokumentasi menyarankan untuk memeriksa keperluan requireMention dan mod privasi bot. Secara lalai, bot Telegram tidak dapat membaca semua mesej kumpulan. Anda mesti mematikan mod privasi melalui arahan /setprivacy di BotFather, atau menjadikan bot sebagai pentadbir kumpulan. Selepas itu, buang dan tambah semula bot ke dalam kumpulan agar Telegram menguatkuasakan perubahan tersebut.
• Ralat Penghantaran (Network Error): Punca biasanya berkaitan rangkaian. Log Telegram API adalah tempat yang tepat untuk disemak. Seterusnya, betulkan konfigurasi DNS, IPv6, atau laluan proksi ke api.telegram.org.
• Ralat

  getMe returned 401

  Semasa Permulaan: Ini bermaksud token yang anda dapatkan dari BotFather sudah tidak sah atau tamat tempoh. Anda perlu mengemas kini botToken, tokenFile, atau pembolehubah persekitaran TELEGRAM_BOT_TOKEN untuk akaun lalai.
• Polling Tersekat atau Proses Sambung Semula (Reconnect) Perlahan: Pantau output

  openclaw logs --follow

  untuk melihat jika terdapat gelung sambungan yang tidak stabil. Jika masalah berterusan, dokumentasi mengesahkan punca selalunya berkisar pada isu proksi, DNS, atau IPv6.
• Konflik getUpdates 409: Ini adalah petanda jelas ada lebih daripada satu proses yang menggunakan token bot yang sama. Proses itu mungkin datang dari gerbang (gateway) OpenClaw lain, skrip luaran, atau pencekau (poller) asing. Dokumentasi Telegram OpenClaw menegaskan bahawa hanya satu pencekau aktif dibenarkan untuk setiap token bot.

Jika Bot Rosak Selepas Kemas Kini (Update)

Selepas melakukan kemas kini perisian, dokumentasi mengarahkan urutan pemulihan ini:

1. Jalankan

   openclaw status --all

   untuk melihat status semasa.
2. Jalankan

   openclaw doctor --fix

   untuk membersihkan 'staging/auth shadow' yang mungkin korup.
3. Mulakan semula gerbang dengan

   openclaw gateway restart

   .
4. Sahkan pemulihan dengan menjalankan

   openclaw status --all

   sekali lagi.

Jika anda melihat mesej ralat seperti

plugin load failed: dependency tree corrupted

openclaw doctor --fix

Persediaan Telegram yang Betul patutnya bagaimana?

Satu lagi punca kekeliruan adalah kaedah log masuk. Saluran Telegram OpenClaw tidak menggunakan arahan

openclaw channels login telegram

channels.telegram.enabled: true

Untuk mesej langsung (DM), ia menggunakan kaedah penyandingan (pairing). Selepas menghidupkan gerbang, anda patut menyemak statusnya dengan

openclaw pairing list telegram

Kesimpulan Pantas

• Buat masa ini, tidak cukup bukti untuk mengatakan punca kegagalan adalah X. Keadaan ini adalah Insufficient evidence.
• Akan tetapi, jika anda serius mahu menyelesaikannya, dapatkan dahulu output 5 arahan diagnosis di atas. Untuk saluran Telegram secara spesifik, empat kategori masalah paling patut disyaki adalah: tetapan privasi/mention, token pengesahan 401, halangan DNS/IPv6/proksi, dan konflik token dengan ralat polling 409.