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 เพื่อดูข้อมูลวินิจฉัยการโพล |
อัปเกรด หากการรีสตาร์ตเป็นการตรวจจับผิด ให้ปรับ pollingStallThresholdMs การค้างอย่างต่อเนื่องยังบ่งชี้ถึงปัญหาพร็อกซี/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 |
อนุญาตกิลด์/ช่องทางและตรวจสอบ Intent สำหรับเนื้อหาข้อความ |
| ละเว้นข้อความกลุ่ม | ตรวจสอบบันทึกเหตุการณ์เพื่อหารายการที่ถูกตัดทิ้งโดยเงื่อนไขการกล่าวถึง | กล่าวถึงบอตหรือตั้งค่า 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
ลักษณะอาการขัดข้องของบอต QQ
| อาการ | วิธีตรวจสอบที่เร็วที่สุด | วิธีแก้ไข |
|---|---|---|
| บอตตอบว่า "ไปดาวอังคารแล้ว" | ตรวจสอบ appId และ clientSecret ในการกำหนดค่า |
ตั้งค่าข้อมูลรับรองหรือรีสตาร์ต Gateway |
| ไม่มีข้อความขาเข้า | openclaw channels status --probe |
ตรวจสอบข้อมูลรับรองบน QQ Open Platform |
| ไม่มีการถอดเสียงข้อความเสียง | ตรวจสอบการกำหนดค่าผู้ให้บริการ STT | กำหนดค่า channels.qqbot.stt หรือ tools.media.audio |
| ข้อความเชิงรุกไม่มาถึง | ตรวจสอบข้อกำหนดด้านการโต้ตอบของแพลตฟอร์ม QQ | QQ อาจบล็อกข้อความที่บอตเป็นผู้เริ่ม หากไม่มีการโต้ตอบเกิดขึ้นเมื่อไม่นานมานี้ |
การแก้ไขปัญหาแบบครบถ้วน: การแก้ไขปัญหาบอต QQ
Matrix
รูปแบบความล้มเหลวของ Matrix
| อาการ | วิธีตรวจสอบที่เร็วที่สุด | วิธีแก้ไข |
|---|---|---|
| เข้าสู่ระบบแล้วแต่ไม่ตอบสนองข้อความในห้อง | openclaw channels status --probe |
ตรวจสอบ groupPolicy รายการอนุญาตของห้อง และการกำหนดให้ต้องมีการกล่าวถึง |
| ไม่ประมวลผลข้อความส่วนตัว | openclaw pairing list matrix |
อนุมัติผู้ส่งหรือปรับนโยบายข้อความส่วนตัว |
| ห้องที่เข้ารหัสใช้งานไม่ได้ | 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?
