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 จะลบไดเรกทอรี staging ของการพึ่งพา Plugin ที่ค้างอยู่
และเงาการยืนยันตัวตนที่ค้างอยู่ จากนั้น openclaw gateway restart จะโหลดสถานะ
ที่สะอาดใหม่
ลายเซ็นความล้มเหลวของ WhatsApp
| อาการ | การตรวจที่เร็วที่สุด | วิธีแก้ |
|---|---|---|
| เชื่อมต่อแล้วแต่ไม่มีการตอบกลับ DM | openclaw pairing list whatsapp |
อนุมัติผู้ส่ง หรือเปลี่ยนนโยบาย/รายการอนุญาตของ DM |
| ข้อความกลุ่มถูกละเว้น | ตรวจ requireMention + รูปแบบการ mention ในการตั้งค่า |
mention บอต หรือผ่อนคลายนโยบาย mention สำหรับกลุ่มนั้น |
| การเข้าสู่ระบบด้วย QR หมดเวลาด้วย 408 | ตรวจ env 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 |
| บอตออนไลน์แต่กลุ่มยังเงียบ | ตรวจข้อกำหนดการ mention และโหมดความเป็นส่วนตัวของบอต | ปิดโหมดความเป็นส่วนตัวเพื่อให้มองเห็นในกลุ่ม หรือ mention บอต |
| ส่งไม่สำเร็จพร้อมข้อผิดพลาดเครือข่าย | ตรวจบันทึกสำหรับความล้มเหลวในการเรียก API ของ Telegram | แก้การกำหนดเส้นทาง DNS/IPv6/พร็อกซีไปยัง api.telegram.org |
การเริ่มต้นรายงาน getMe returned 401 |
ตรวจแหล่งที่มาของโทเค็นที่ตั้งค่าไว้ | คัดลอกใหม่หรือสร้างโทเค็น BotFather ใหม่ แล้วอัปเดต botToken, tokenFile หรือบัญชีเริ่มต้น TELEGRAM_BOT_TOKEN |
| การ polling ค้างหรือเชื่อมต่อใหม่ช้า | openclaw logs --follow สำหรับการวินิจฉัย polling |
อัปเกรด; หากการรีสตาร์ตเป็นผลบวกลวง ให้ปรับ pollingStallThresholdMs การค้างถาวรยังชี้ไปที่พร็อกซี/DNS/IPv6 |
setMyCommands ถูกปฏิเสธตอนเริ่มต้น |
ตรวจบันทึกสำหรับ BOT_COMMANDS_TOO_MUCH |
ลดคำสั่ง Telegram จาก Plugin/skill/กำหนดเอง หรือปิดเมนูเนทีฟ |
| อัปเกรดแล้วรายการอนุญาตบล็อกคุณ | openclaw security audit และรายการอนุญาตในการตั้งค่า |
เรียกใช้ openclaw doctor --fix หรือแทนที่ @username ด้วยรหัสผู้ส่งแบบตัวเลข |
การแก้ปัญหาแบบเต็ม: การแก้ปัญหา Telegram
Discord
ลายเซ็นความล้มเหลวของ Discord
| อาการ | การตรวจที่เร็วที่สุด | วิธีแก้ |
|---|---|---|
| บอตออนไลน์แต่ไม่มีการตอบกลับในกิลด์ | openclaw channels status --probe |
อนุญาตกิลด์/ช่อง และตรวจยืนยัน intent ของเนื้อหาข้อความ |
| ข้อความกลุ่มถูกละเว้น | ตรวจบันทึกสำหรับการ drop จากการกั้นด้วย mention | mention บอต หรือตั้งค่า requireMention: false ของกิลด์/ช่อง |
| มีการพิมพ์/ใช้โทเค็นแต่ไม่มีข้อความ Discord | ตรวจว่านี่เป็นเหตุการณ์ห้อง ambient หรือห้อง message_tool ที่เลือกใช้ ซึ่งโมเดลพลาด message(action=send) |
ตรวจบันทึกแบบละเอียดของ Gateway สำหรับเมทาดาทาของ payload สุดท้ายที่ถูกระงับ ตรวจยืนยัน messages.groupChat.unmentionedInbound อ่าน เหตุการณ์ห้อง Ambient หรือคง messages.groupChat.visibleReplies: "automatic" ไว้สำหรับคำขอกลุ่มปกติ |
| คำตอบ DM หายไป | openclaw pairing list discord |
อนุมัติการจับคู่ DM หรือปรับนโยบาย DM |
การแก้ปัญหาแบบเต็ม: การแก้ปัญหา Discord
Slack
ลายเซ็นความล้มเหลวของ Slack
| อาการ | การตรวจที่เร็วที่สุด | วิธีแก้ |
|---|---|---|
| โหมดซ็อกเก็ตเชื่อมต่อแล้วแต่ไม่มีการตอบสนอง | openclaw channels status --probe |
ตรวจยืนยันโทเค็นแอป + โทเค็นบอต และ scope ที่จำเป็น; เฝ้าดู 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 หรือใช้ wrapper SSH สำหรับ cliPath |
| ส่งได้แต่รับไม่ได้บน macOS | ตรวจสิทธิ์ความเป็นส่วนตัวของ macOS สำหรับการทำงานอัตโนมัติของ Messages | ให้สิทธิ์ TCC อีกครั้งและรีสตาร์ตโปรเซสช่องทาง |
| ผู้ส่ง DM ถูกบล็อก | openclaw pairing list imessage |
อนุมัติการจับคู่ หรืออัปเดตรายการอนุญาต |
การแก้ปัญหาแบบเต็ม:
Signal
ลายเซ็นความล้มเหลวของ Signal
| อาการ | การตรวจที่เร็วที่สุด | วิธีแก้ |
|---|---|---|
| daemon เข้าถึงได้แต่บอตเงียบ | openclaw channels status --probe |
ตรวจยืนยัน URL/บัญชี daemon ของ signal-cli และโหมดรับ |
| DM ถูกบล็อก | openclaw pairing list signal |
อนุมัติผู้ส่ง หรือปรับนโยบาย DM |
| การตอบกลับกลุ่มไม่ถูกทริกเกอร์ | ตรวจรายการอนุญาตของกลุ่มและรูปแบบการ mention | เพิ่มผู้ส่ง/กลุ่ม หรือผ่อนคลายการกั้น |
การแก้ปัญหาแบบเต็ม: การแก้ปัญหา 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 หรือรันอีกครั้งพร้อมคีย์กู้คืน |
| cross-signing/bootstrap ดูผิดปกติ | openclaw matrix verify bootstrap |
ซ่อมแซมที่จัดเก็บความลับ, cross-signing และสถานะข้อมูลสำรองในครั้งเดียว |
การตั้งค่าและการกำหนดค่าแบบเต็ม: Matrix