Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
ใช้หน้านี้เมื่อช่องทางเชื่อมต่อได้ แต่พฤติกรรมผิดปกติ
ลำดับคำสั่ง
รันคำสั่งเหล่านี้ตามลำดับก่อน:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Runtime: runningConnectivity probe: okCapability: read-only, write-capable, หรือ admin-capable- การตรวจสอบช่องทางแสดงว่าทรานสปอร์ตเชื่อมต่อแล้ว และในกรณีที่รองรับ แสดง
works หรือ audit ok
WhatsApp
สัญญาณความล้มเหลวของ WhatsApp
| อาการ | การตรวจสอบที่เร็วที่สุด | วิธีแก้ |
|---|
| เชื่อมต่อแล้วแต่ไม่มีการตอบกลับ DM | openclaw pairing list whatsapp | อนุมัติผู้ส่งหรือเปลี่ยนนโยบาย/allowlist ของ DM |
| ข้อความกลุ่มถูกเพิกเฉย | ตรวจสอบ requireMention + รูปแบบการกล่าวถึงใน config | กล่าวถึงบอตหรือผ่อนปรนนโยบายการกล่าวถึงสำหรับกลุ่มนั้น |
| การเข้าสู่ระบบด้วย QR หมดเวลาด้วย 408 | ตรวจสอบ env HTTPS_PROXY / HTTP_PROXY ของ Gateway | ตั้งค่าพร็อกซีที่เข้าถึงได้ ใช้ NO_PROXY เฉพาะสำหรับการข้ามเท่านั้น |
| หลุดการเชื่อมต่อ/วนเข้าสู่ระบบใหม่แบบสุ่ม | openclaw channels status --probe + logs | การเชื่อมต่อใหม่ล่าสุดจะถูกตั้งค่าสถานะแม้ขณะนี้เชื่อมต่ออยู่ ให้ดู logs, รีสตาร์ท Gateway แล้วลิงก์ใหม่หากยังแกว่งต่อเนื่อง |
| การตอบกลับมาถึงช้าเป็นวินาที/นาที | openclaw doctor --fix | Doctor หยุดไคลเอนต์ TUI ภายในเครื่องที่ตรวจยืนยันแล้วว่าค้างเก่า เมื่อไคลเอนต์เหล่านั้นทำให้ event loop ของ Gateway เสื่อมประสิทธิภาพ |
Telegram
สัญญาณความล้มเหลวของ Telegram
| อาการ | การตรวจสอบที่เร็วที่สุด | วิธีแก้ |
|---|
/start แต่ไม่มีโฟลว์ตอบกลับที่ใช้งานได้ | openclaw pairing list telegram | อนุมัติการจับคู่หรือเปลี่ยนนโยบาย DM |
| บอตออนไลน์แต่กลุ่มยังเงียบ | ตรวจยืนยันข้อกำหนดการกล่าวถึงและโหมดความเป็นส่วนตัวของบอต | ปิดโหมดความเป็นส่วนตัวเพื่อให้มองเห็นกลุ่ม หรือกล่าวถึงบอต |
| ส่งล้มเหลวพร้อมข้อผิดพลาดเครือข่าย | ตรวจสอบ logs เพื่อหาความล้มเหลวของการเรียก Telegram API | แก้การกำหนดเส้นทาง DNS/IPv6/พร็อกซีไปยัง api.telegram.org |
ตอนเริ่มต้นรายงาน getMe returned 401 | ตรวจสอบแหล่งที่มาของโทเค็นที่ตั้งค่าไว้ | คัดลอกใหม่หรือสร้างโทเค็น BotFather ใหม่ แล้วอัปเดต botToken, tokenFile, หรือ TELEGRAM_BOT_TOKEN ของบัญชีเริ่มต้น |
| การ polling ค้างหรือเชื่อมต่อใหม่ช้า | openclaw logs --follow เพื่อดูการวินิจฉัย polling | อัปเกรด หากการรีสตาร์ทเป็นผลบวกเท็จ ให้ปรับ pollingStallThresholdMs การค้างต่อเนื่องยังคงชี้ไปที่พร็อกซี/DNS/IPv6 |
setMyCommands ถูกปฏิเสธตอนเริ่มต้น | ตรวจสอบ logs เพื่อหา BOT_COMMANDS_TOO_MUCH | ลดคำสั่ง Telegram ของ Plugin/Skills/กำหนดเอง หรือปิดเมนูเนทีฟ |
| อัปเกรดแล้ว allowlist บล็อกคุณ | openclaw security audit และ allowlist ใน config | รัน openclaw doctor --fix หรือแทนที่ @username ด้วย ID ผู้ส่งแบบตัวเลข |
Discord
สัญญาณความล้มเหลวของ Discord
| อาการ | การตรวจสอบที่เร็วที่สุด | วิธีแก้ |
|---|
| บอตออนไลน์แต่ไม่มีการตอบกลับใน guild | openclaw channels status --probe | อนุญาต guild/channel และตรวจยืนยัน message content intent |
| ข้อความกลุ่มถูกเพิกเฉย | ตรวจสอบ logs เพื่อหารายการที่ถูกตัดทิ้งจากการ gate ด้วยการกล่าวถึง | กล่าวถึงบอตหรือตั้งค่า requireMention: false สำหรับ guild/channel |
| มีการพิมพ์/ใช้โทเค็นแต่ไม่มีข้อความ Discord | Session log แสดงข้อความผู้ช่วยพร้อม didSendViaMessagingTool: false | โมเดลตอบแบบส่วนตัวแทนที่จะเรียกเครื่องมือข้อความ ใช้โมเดลที่เรียกเครื่องมือได้เชื่อถือได้ หรือตั้งค่า messages.groupChat.visibleReplies: "automatic" เพื่อโพสต์อัตโนมัติ |
| การตอบกลับ DM หายไป | openclaw pairing list discord | อนุมัติการจับคู่ DM หรือปรับนโยบาย DM |
Slack
สัญญาณความล้มเหลวของ Slack
| อาการ | การตรวจสอบที่เร็วที่สุด | วิธีแก้ |
|---|
| Socket mode เชื่อมต่อแล้วแต่ไม่มีการตอบสนอง | openclaw channels status --probe | ตรวจยืนยันโทเค็นแอป + โทเค็นบอตและ scopes ที่จำเป็น ดู botTokenStatus / appTokenStatus = configured_unavailable ในการตั้งค่าที่ใช้ SecretRef |
| DM ถูกบล็อก | openclaw pairing list slack | อนุมัติการจับคู่หรือผ่อนปรนนโยบาย DM |
| ข้อความช่องถูกเพิกเฉย | ตรวจสอบ groupPolicy และ allowlist ของช่อง | อนุญาตช่องหรือเปลี่ยนนโยบายเป็น open |
iMessage
สัญญาณความล้มเหลวของ iMessage
| อาการ | การตรวจสอบที่เร็วที่สุด | วิธีแก้ |
|---|
imsg หายไปหรือล้มเหลวบนระบบที่ไม่ใช่ macOS | openclaw channels status --probe --channel imessage | รัน OpenClaw บน Mac ที่ใช้ Messages หรือใช้ SSH wrapper สำหรับ cliPath |
| ส่งได้แต่รับไม่ได้บน macOS | ตรวจสอบสิทธิ์ความเป็นส่วนตัวของ macOS สำหรับการทำงานอัตโนมัติของ Messages | อนุญาตสิทธิ์ TCC ใหม่และรีสตาร์ทโปรเซสช่องทาง |
| ผู้ส่ง DM ถูกบล็อก | openclaw pairing list imessage | อนุมัติการจับคู่หรืออัปเดต allowlist |
Signal
สัญญาณความล้มเหลวของ Signal
| อาการ | การตรวจสอบที่เร็วที่สุด | วิธีแก้ |
|---|
| Daemon เข้าถึงได้แต่บอตเงียบ | openclaw channels status --probe | ตรวจยืนยัน URL/account และโหมดรับของ daemon signal-cli |
| DM ถูกบล็อก | openclaw pairing list signal | อนุมัติผู้ส่งหรือปรับนโยบาย DM |
| การตอบกลับในกลุ่มไม่ทำงาน | ตรวจสอบ allowlist ของกลุ่มและรูปแบบการกล่าวถึง | เพิ่มผู้ส่ง/กลุ่ม หรือผ่อนปรนการ gate |
QQ Bot
สัญญาณความล้มเหลวของ QQ Bot
| อาการ | การตรวจสอบที่เร็วที่สุด | วิธีแก้ |
|---|
| บอตตอบว่า “gone to Mars” | ตรวจยืนยัน appId และ clientSecret ใน config | ตั้งค่าข้อมูลประจำตัวหรือรีสตาร์ท Gateway |
| ไม่มีข้อความขาเข้า | openclaw channels status --probe | ตรวจยืนยันข้อมูลประจำตัวบน QQ Open Platform |
| เสียงไม่ได้ถูกถอดความ | ตรวจสอบ config ของผู้ให้บริการ STT | ตั้งค่า channels.qqbot.stt หรือ tools.media.audio |
| ข้อความเชิงรุกไม่มาถึง | ตรวจสอบข้อกำหนดการโต้ตอบของแพลตฟอร์ม QQ | QQ อาจบล็อกข้อความที่บอตเริ่มเองหากไม่มีการโต้ตอบล่าสุด |
Matrix
สัญญาณความล้มเหลวของ Matrix
| อาการ | การตรวจสอบที่เร็วที่สุด | วิธีแก้ |
|---|
| เข้าสู่ระบบแล้วแต่เพิกเฉยต่อข้อความในห้อง | openclaw channels status --probe | ตรวจสอบ groupPolicy, allowlist ของห้อง และการ gate ด้วยการกล่าวถึง |
| DM ไม่ถูกประมวลผล | openclaw pairing list matrix | อนุมัติผู้ส่งหรือปรับนโยบาย DM |
| ห้องที่เข้ารหัสล้มเหลว | openclaw matrix verify status | ตรวจยืนยันอุปกรณ์ใหม่ แล้วตรวจสอบ openclaw matrix verify backup status |
| การกู้คืน backup ค้างอยู่/เสียหาย | openclaw matrix verify backup status | รัน openclaw matrix verify backup restore หรือรันอีกครั้งด้วยคีย์กู้คืน |
| Cross-signing/bootstrap ดูผิดปกติ | openclaw matrix verify bootstrap | ซ่อมแซม secret storage, cross-signing และสถานะ backup ในรอบเดียว |
ที่เกี่ยวข้อง
