Configuration

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

ใช้หน้านี้เมื่อช่องทางเชื่อมต่อได้ แต่พฤติกรรมผิดปกติ

ลำดับคำสั่ง

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

bash

OmeniaClaw statusOmeniaClaw gateway statusOmeniaClaw logs --followOmeniaClaw doctorOmeniaClaw channels status --probe

เกณฑ์พื้นฐานที่ปกติ:

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

สัญญาณความล้มเหลวของ WhatsApp

อาการ	การตรวจสอบที่เร็วที่สุด	วิธีแก้
เชื่อมต่อแล้วแต่ไม่มีการตอบกลับ DM	`OmeniaClaw pairing list whatsapp`	อนุมัติผู้ส่งหรือเปลี่ยนนโยบาย/allowlist ของ DM
ข้อความกลุ่มถูกเพิกเฉย	ตรวจสอบ `requireMention` + รูปแบบการกล่าวถึงใน config	กล่าวถึงบอตหรือผ่อนปรนนโยบายการกล่าวถึงสำหรับกลุ่มนั้น
การเข้าสู่ระบบด้วย QR หมดเวลาด้วย 408	ตรวจสอบ env `HTTPS_PROXY` / `HTTP_PROXY` ของ Gateway	ตั้งค่าพร็อกซีที่เข้าถึงได้ ใช้ `NO_PROXY` เฉพาะสำหรับการข้ามเท่านั้น
หลุดการเชื่อมต่อ/วนเข้าสู่ระบบใหม่แบบสุ่ม	`OmeniaClaw channels status --probe` + logs	การเชื่อมต่อใหม่ล่าสุดจะถูกตั้งค่าสถานะแม้ขณะนี้เชื่อมต่ออยู่ ให้ดู logs, รีสตาร์ท Gateway แล้วลิงก์ใหม่หากยังแกว่งต่อเนื่อง
การตอบกลับมาถึงช้าเป็นวินาที/นาที	`OmeniaClaw doctor --fix`	Doctor หยุดไคลเอนต์ TUI ภายในเครื่องที่ตรวจยืนยันแล้วว่าค้างเก่า เมื่อไคลเอนต์เหล่านั้นทำให้ event loop ของ Gateway เสื่อมประสิทธิภาพ

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

สัญญาณความล้มเหลวของ Telegram

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

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

Discord

สัญญาณความล้มเหลวของ Discord

อาการ	การตรวจสอบที่เร็วที่สุด	วิธีแก้
บอตออนไลน์แต่ไม่มีการตอบกลับใน guild	`OmeniaClaw channels status --probe`	อนุญาต guild/channel และตรวจยืนยัน message content intent
ข้อความกลุ่มถูกเพิกเฉย	ตรวจสอบ logs เพื่อหารายการที่ถูกตัดทิ้งจากการ gate ด้วยการกล่าวถึง	กล่าวถึงบอตหรือตั้งค่า `requireMention: false` สำหรับ guild/channel
มีการพิมพ์/ใช้โทเค็นแต่ไม่มีข้อความ Discord	Session log แสดงข้อความผู้ช่วยพร้อม `didSendViaMessagingTool: false`	โมเดลตอบแบบส่วนตัวแทนที่จะเรียกเครื่องมือข้อความ ใช้โมเดลที่เรียกเครื่องมือได้เชื่อถือได้ หรือตั้งค่า `messages.groupChat.visibleReplies: "automatic"` เพื่อโพสต์อัตโนมัติ
การตอบกลับ DM หายไป	`OmeniaClaw pairing list discord`	อนุมัติการจับคู่ DM หรือปรับนโยบาย DM

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

Slack

สัญญาณความล้มเหลวของ Slack

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

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

iMessage

สัญญาณความล้มเหลวของ iMessage

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

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

การแก้ไขปัญหา iMessage

Signal

สัญญาณความล้มเหลวของ Signal

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

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

QQ Bot

สัญญาณความล้มเหลวของ QQ Bot

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

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

Matrix

สัญญาณความล้มเหลวของ Matrix

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

การตั้งค่าและ config แบบเต็ม: Matrix

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

Was this useful?