Configuration

การแก้ไขปัญหาช่องทาง

ใช้หน้านี้เมื่อช่องทางเชื่อมต่อได้ แต่ทำงานไม่ถูกต้อง

ลำดับคำสั่ง

ให้เรียกใช้คำสั่งเหล่านี้ตามลำดับก่อน:

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

สถานะพื้นฐานที่ปกติ:

  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable หรือ admin-capable
  • การตรวจสอบช่องทางแสดงว่าการรับส่งข้อมูลเชื่อมต่อแล้ว และแสดง works หรือ audit ok ในกรณีที่รองรับ

หลังการอัปเดต

ใช้ส่วนนี้เมื่อ Telegram, iMessage, การกำหนดค่าจากยุค BlueBubbles หรือช่องทาง Plugin อื่นหายไป หลังจากอัปเดต

bash
openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --all

มองหา plugin load failed: dependency tree corrupted; run openclaw doctor --fix ใน openclaw status --all ซึ่งหมายความว่ามีการกำหนดค่าช่องทางแล้ว แต่การตั้งค่า/โหลด Plugin พบโครงสร้าง การขึ้นต่อกันที่เสียหายแทนที่จะลงทะเบียนช่องทาง openclaw doctor --fix จะล้าง symlink การขึ้นต่อกันของรันไทม์ Plugin ที่ค้างอยู่และเงาการยืนยันตัวตนที่ค้างอยู่ จากนั้น openclaw gateway restart จะโหลด สถานะที่สะอาดอีกครั้ง

WhatsApp

ลักษณะอาการขัดข้องของ WhatsApp

อาการ วิธีตรวจสอบที่เร็วที่สุด วิธีแก้ไข
เชื่อมต่อแล้วแต่ไม่ตอบกลับ DM openclaw pairing list whatsapp อนุมัติผู้ส่งหรือเปลี่ยนนโยบาย DM/รายการที่อนุญาต
ไม่สนใจข้อความกลุ่ม ตรวจสอบ requireMention และรูปแบบการกล่าวถึงในการกำหนดค่า กล่าวถึงบอตหรือผ่อนปรนนโยบายการกล่าวถึงสำหรับกลุ่มนั้น
การเข้าสู่ระบบด้วย QR หมดเวลาด้วย 408 ตรวจสอบตัวแปรสภาพแวดล้อม HTTPS_PROXY / HTTP_PROXY ของ Gateway ตั้งค่าพร็อกซีที่เข้าถึงได้ ใช้ NO_PROXY สำหรับการข้ามเท่านั้น
วนตัดการเชื่อมต่อ/เข้าสู่ระบบใหม่แบบสุ่ม openclaw channels status --probe และบันทึกเหตุการณ์ ระบบจะแจ้งเตือนการเชื่อมต่อใหม่ล่าสุดแม้ปัจจุบันจะเชื่อมต่ออยู่ ให้เฝ้าดูบันทึกเหตุการณ์ รีสตาร์ต Gateway แล้วเชื่อมโยงใหม่หากยังคงเชื่อมต่อสลับไปมา
วน status=408 Request Time-out ตรวจสอบเชิงรุก บันทึกเหตุการณ์ doctor แล้วตรวจสอบสถานะ Gateway แก้ไขการเชื่อมต่อ/การจับเวลาของโฮสต์ก่อน สำรองข้อมูลการยืนยันตัวตนแล้วเชื่อมโยงบัญชีใหม่หากยังคงเกิดการวนซ้ำ
การตอบกลับมาถึงช้าหลายวินาที/นาที openclaw doctor --fix Doctor จะหยุดไคลเอ็นต์ TUI ภายในเครื่องที่ยืนยันแล้วว่าค้างอยู่ เมื่อไคลเอ็นต์เหล่านั้นทำให้ลูปเหตุการณ์ของ Gateway ทำงานด้อยลง

การแก้ไขปัญหาฉบับเต็ม: การแก้ไขปัญหา WhatsApp

Telegram

ลักษณะอาการขัดข้องของ Telegram

อาการ วิธีตรวจสอบที่เร็วที่สุด วิธีแก้ไข
/start แต่ไม่มีขั้นตอนการตอบกลับที่ใช้งานได้ openclaw pairing list telegram อนุมัติการจับคู่หรือเปลี่ยนนโยบาย DM
บอตออนไลน์แต่กลุ่มยังเงียบอยู่ ตรวจสอบข้อกำหนดการกล่าวถึงและโหมดความเป็นส่วนตัวของบอต ปิดใช้งานโหมดความเป็นส่วนตัวเพื่อให้มองเห็นข้อความกลุ่ม หรือกล่าวถึงบอต
การส่งล้มเหลวพร้อมข้อผิดพลาดเครือข่าย ตรวจสอบบันทึกเหตุการณ์เพื่อหาการเรียก Telegram API ที่ล้มเหลว แก้ไขการกำหนดเส้นทาง DNS/IPv6/พร็อกซีไปยัง api.telegram.org
เมื่อเริ่มต้นระบบรายงาน getMe returned 401 ตรวจสอบแหล่งโทเค็นที่กำหนดค่าไว้ คัดลอกใหม่หรือสร้างโทเค็น BotFather ใหม่ แล้วอัปเดต botToken, tokenFile หรือ TELEGRAM_BOT_TOKEN ของบัญชีเริ่มต้น
การสำรวจค้างหรือเชื่อมต่อใหม่ช้า openclaw logs --follow สำหรับการวินิจฉัยการสำรวจ อัปเกรด อาการค้างต่อเนื่องมักบ่งชี้ถึงปัญหาพร็อกซี/DNS/IPv6
setMyCommands ถูกปฏิเสธเมื่อเริ่มต้นระบบ ตรวจสอบบันทึกเหตุการณ์เพื่อหา BOT_COMMANDS_TOO_MUCH ลดจำนวนคำสั่ง Telegram จาก Plugin/Skills/คำสั่งที่กำหนดเอง หรือปิดใช้งานเมนูแบบเนทีฟ
อัปเกรดแล้วรายการที่อนุญาตบล็อกคุณ openclaw security audit และรายการที่อนุญาตในการกำหนดค่า เรียกใช้ openclaw doctor --fix หรือแทนที่ @username ด้วย ID ผู้ส่งแบบตัวเลข

การแก้ไขปัญหาฉบับเต็ม: การแก้ไขปัญหา Telegram

Discord

ลักษณะอาการขัดข้องของ Discord

อาการ วิธีตรวจสอบที่เร็วที่สุด วิธีแก้ไข
บอตออนไลน์แต่ไม่ตอบกลับในกิลด์ openclaw channels status --probe อนุญาตกิลด์/ช่องทางและตรวจสอบเจตนาการเข้าถึงเนื้อหาข้อความ
ไม่สนใจข้อความกลุ่ม ตรวจสอบบันทึกเหตุการณ์เพื่อหารายการที่ถูกละทิ้งจากการควบคุมด้วยการกล่าวถึง กล่าวถึงบอตหรือตั้งค่า requireMention: false ของกิลด์/ช่องทาง
มีการพิมพ์/ใช้โทเค็นแต่ไม่มีข้อความ Discord ตรวจสอบว่านี่เป็นเหตุการณ์ห้องแวดล้อมหรือห้อง message_tool ที่เลือกเข้าร่วม ซึ่งโมเดลพลาด message(action=send) หรือไม่ ตรวจสอบข้อมูลเมตาของเพย์โหลดสุดท้ายที่ถูกระงับในบันทึกแบบละเอียดของ Gateway ตรวจสอบ messages.groupChat.unmentionedInbound อ่าน เหตุการณ์ห้องแวดล้อม หรือคง messages.groupChat.visibleReplies: "automatic" ไว้สำหรับคำขอแบบกลุ่มตามปกติ
ไม่มีการตอบกลับ DM openclaw pairing list discord อนุมัติการจับคู่ DM หรือปรับนโยบาย DM

การแก้ไขปัญหาฉบับเต็ม: การแก้ไขปัญหา Discord

Slack

ลักษณะอาการขัดข้องของ Slack

อาการ วิธีตรวจสอบที่เร็วที่สุด วิธีแก้ไข
โหมดซ็อกเก็ตเชื่อมต่อแล้วแต่ไม่มีการตอบสนอง openclaw channels status --probe ตรวจสอบโทเค็นแอป + โทเค็นบอตและขอบเขตสิทธิ์ที่จำเป็น เฝ้าดู botTokenStatus / appTokenStatus = configured_unavailable ในการตั้งค่าที่อิง SecretRef
DM ถูกบล็อก openclaw pairing list slack อนุมัติการจับคู่หรือผ่อนปรนนโยบาย DM
ไม่สนใจข้อความในช่องทาง ตรวจสอบ groupPolicy และรายการช่องทางที่อนุญาต อนุญาตช่องทางหรือเปลี่ยนนโยบายเป็น open

การแก้ไขปัญหาฉบับเต็ม: การแก้ไขปัญหา Slack

iMessage

ลักษณะอาการขัดข้องของ iMessage

อาการ วิธีตรวจสอบที่เร็วที่สุด วิธีแก้ไข
imsg หายไปหรือทำงานล้มเหลวบนระบบที่ไม่ใช่ macOS openclaw channels status --probe --channel imessage เรียกใช้ OpenClaw บน Mac ที่ใช้ Messages หรือใช้ตัวห่อหุ้ม SSH สำหรับ cliPath
ส่งได้แต่รับไม่ได้บน macOS ตรวจสอบสิทธิ์ความเป็นส่วนตัวของ macOS สำหรับระบบอัตโนมัติของ Messages ให้สิทธิ์ TCC อีกครั้งและรีสตาร์ตกระบวนการช่องทาง
ผู้ส่ง DM ถูกบล็อก openclaw pairing list imessage อนุมัติการจับคู่หรืออัปเดตรายการที่อนุญาต

การแก้ไขปัญหาฉบับเต็ม: การแก้ไขปัญหา iMessage

Signal

ลักษณะอาการขัดข้องของ Signal

อาการ วิธีตรวจสอบที่เร็วที่สุด วิธีแก้ไข
เข้าถึงดีมอนได้แต่บอตเงียบ openclaw channels status --probe ตรวจสอบ URL/บัญชีดีมอน signal-cli และโหมดรับ
DM ถูกบล็อก openclaw pairing list signal อนุมัติผู้ส่งหรือปรับนโยบาย DM
การตอบกลับในกลุ่มไม่ทำงาน ตรวจสอบรายการกลุ่มที่อนุญาตและรูปแบบการกล่าวถึง เพิ่มผู้ส่ง/กลุ่มหรือผ่อนปรนการควบคุม

การแก้ไขปัญหาฉบับเต็ม: การแก้ไขปัญหา Signal

QQ Bot

ลักษณะอาการขัดข้องของ QQ Bot

อาการ วิธีตรวจสอบที่เร็วที่สุด วิธีแก้ไข
บอตตอบว่า "ไปดาวอังคารแล้ว" ตรวจสอบ appId และ clientSecret ในการกำหนดค่า ตั้งค่าข้อมูลประจำตัวหรือรีสตาร์ต Gateway
ไม่มีข้อความขาเข้า openclaw channels status --probe ตรวจสอบข้อมูลประจำตัวบน QQ Open Platform
ไม่มีการถอดเสียงข้อความเสียง ตรวจสอบการกำหนดค่าผู้ให้บริการ STT กำหนดค่า channels.qqbot.stt หรือ tools.media.audio
ข้อความเชิงรุกไม่มาถึง ตรวจสอบข้อกำหนดการโต้ตอบของแพลตฟอร์ม QQ QQ อาจบล็อกข้อความที่บอตเป็นผู้เริ่ม หากไม่มีการโต้ตอบเมื่อเร็ว ๆ นี้

การแก้ไขปัญหาฉบับเต็ม: การแก้ไขปัญหา QQ Bot

Matrix

ลักษณะอาการขัดข้องของ Matrix

อาการ การตรวจสอบที่เร็วที่สุด วิธีแก้ไข
เข้าสู่ระบบแล้วแต่ไม่ตอบสนองต่อข้อความในห้อง openclaw channels status --probe ตรวจสอบ groupPolicy, รายการอนุญาตของห้อง และการจำกัดให้ต้องมีการกล่าวถึง
DM ไม่ถูกประมวลผล openclaw pairing list matrix อนุมัติผู้ส่งหรือปรับนโยบาย DM
ห้องที่เข้ารหัสใช้งานไม่ได้ openclaw matrix verify status ยืนยันอุปกรณ์อีกครั้ง แล้วตรวจสอบ openclaw matrix verify backup status
การกู้คืนข้อมูลสำรองค้างอยู่/ขัดข้อง openclaw matrix verify backup status เรียกใช้ openclaw matrix verify backup restore หรือเรียกใช้อีกครั้งโดยใช้คีย์กู้คืน
การลงนามข้ามอุปกรณ์/การเริ่มต้นระบบดูไม่ถูกต้อง openclaw matrix verify bootstrap ซ่อมแซมพื้นที่จัดเก็บข้อมูลลับ การลงนามข้ามอุปกรณ์ และสถานะข้อมูลสำรองในครั้งเดียว

การตั้งค่าและการกำหนดค่าฉบับเต็ม: Matrix

ที่เกี่ยวข้อง

Was this useful?
On this page

On this page