Configuration
การแก้ไขปัญหาช่องทาง
ใช้หน้านี้เมื่อช่องทางเชื่อมต่อได้ แต่ทำงานไม่ถูกต้อง
ลำดับคำสั่ง
ให้เรียกใช้คำสั่งเหล่านี้ตามลำดับก่อน:
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeสถานะพื้นฐานที่ปกติ:
Runtime: runningConnectivity probe: okCapability: read-only,write-capableหรือadmin-capable- การตรวจสอบช่องทางแสดงว่าการรับส่งข้อมูลเชื่อมต่อแล้ว และแสดง
worksหรือaudit okในกรณีที่รองรับ
หลังการอัปเดต
ใช้ส่วนนี้เมื่อ Telegram, iMessage, การกำหนดค่าจากยุค BlueBubbles หรือช่องทาง Plugin อื่นหายไป หลังจากอัปเดต
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
| อาการ | วิธีตรวจสอบที่เร็วที่สุด | วิธีแก้ไข |
|---|---|---|
| เชื่อมต่อแล้วแต่ไม่ตอบกลับ 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