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

ปัญหาทั่วไปและวิธีแก้ไข

ปัญหา Gateway

Gateway ไม่เริ่มต้น

• Port conflict, กระบวนการอื่นอาจใช้พอร์ต 18789 อยู่ ตรวจสอบด้วย lsof -i :18789
• Config error, JSON ไม่ถูกต้องใน neotask.json Gateway ตรวจสอบ config เมื่อเริ่มต้นและรายงานข้อผิดพลาดเฉพาะ
• Gateway lock, instance ก่อนหน้าอาจทิ้ง lock file ที่ล้าสมัย เครื่องมือวินิจฉัยสามารถตรวจจับและแก้ไขได้
• Node.js version, Neotask ต้องการ Node 22+

Gateway เริ่มต้นแต่ไม่มีช่องทางเชื่อมต่อ

• ขาดข้อมูลประจำตัว, ช่องทางแต่ละช่องต้องการ auth ของตัวเอง (bot token, QR scan, API key)
• ปัญหาเครือข่าย, ช่องทางต้องการการเข้าถึงอินเทอร์เน็ตเพื่อเชื่อมต่อกับ messaging platform API
• Rate limit, บางแพลตฟอร์มจำกัดการเชื่อมต่อใหม่ รอและลองซ้ำ

ไม่สามารถเชื่อมต่อจากแอปเดสก์ท็อป

• พอร์ตผิด, ตรวจสอบว่าแอปเดสก์ท็อปเชื่อมต่อกับพอร์ต Gateway ที่ถูกต้อง
• Token ไม่ตรงกัน, Gateway token ต้องตรงกัน
• Firewall, ตรวจสอบว่าพอร์ตเข้าถึงได้หาก Gateway อยู่บนเครื่องอื่น

ปัญหาช่องทาง

WhatsApp ไม่เชื่อมต่อ

• QR หมดอายุ, QR code หมดอายุหลังจาก ~60 วินาที สแกนซ้ำอย่างรวดเร็ว
• ขีดจำกัด multi-device, WhatsApp จำกัดอุปกรณ์ที่เชื่อมต่อ
• Session เสียหาย, ลบไดเรกทอรีเซสชัน WhatsApp แล้วจับคู่ใหม่

Telegram bot ไม่รับข้อความ

• Bot token ไม่ถูกต้อง, ตรวจสอบ bot token ของคุณกับ BotFather
• Privacy mode, Bot เห็นข้อความเฉพาะเมื่อถูกกล่าวถึงในกลุ่มโดยค่าเริ่มต้น
• Webhook conflict, บริการอื่นอาจกำลังบริโภคข้อความ

Discord bot ไม่ตอบสนอง

• ขาด intent, เปิดใช้งาน Gateway Intent ที่ต้องการใน Discord Developer Portal
• ขาดสิทธิ์, Bot ต้องการสิทธิ์อ่านและส่งในช่องทางเป้าหมาย

ปัญหา Model

ข้อผิดพลาด Auth

• ไม่ได้กำหนดค่า Key, ตรวจสอบว่ากำหนดค่า provider API key แล้ว
• Key หมดอายุ, บาง OAuth token หมดอายุ ตรวจสอบสิทธิ์ซ้ำ
• Rate limit, การหมุนเวียน key จะสลับโดยอัตโนมัติหากคุณมีหลาย key

การตอบสนองช้า

• การเลือก model, Model ขนาดใหญ่ช้ากว่า ลอง model ที่เร็วกว่าสำหรับงานรวดเร็ว
• ขนาด context, การสนทนายาวทำให้การประมวลผลช้า ลอง /compact
• ความหน่วงของเครือข่าย, ตรวจสอบการเชื่อมต่อกับ model provider ของคุณ

ปัญหา Node

แอปคู่หูหา Gateway ไม่เจอ

• โหมด binding, Gateway ต้องถูก bind กับ LAN หรือ Tailnet (ไม่ใช่ loopback) สำหรับอุปกรณ์ภายนอก
• เครือข่ายเดียวกัน, สำหรับการค้นพบ Bonjour ทั้งสองอุปกรณ์ต้องอยู่ในเครือข่ายเดียวกัน
• การป้อนด้วยตนเอง, ป้อน Gateway host และพอร์ตด้วยตนเองในการตั้งค่าแอป

ปัญหาเซสชัน

เกิน context window

• Compact, ใช้ /compact เพื่อสรุปและรีเซ็ต context
• เปิดใช้งาน auto-compaction, ตั้งเกณฑ์ compaction ใน config
• เซสชันใหม่, เริ่มใหม่ด้วย /new

การวินิจฉัย

เครื่องมือวินิจฉัยในตัวตรวจสอบปัญหาทั่วไปและสามารถแก้ไขได้หลายอย่างโดยอัตโนมัติ:

• การตรวจสอบ config
• สิทธิ์ไฟล์
• การเชื่อมต่อช่องทาง
• สถานะ auth ของ model
• ความเข้ากันได้กับ Node.js
• การกำหนดค่าเครือข่าย

ตรวจสอบ Gateway log สำหรับข้อมูลข้อผิดพลาดโดยละเอียด /health endpoint ให้สถานะที่อ่านได้โดยเครื่องของส่วนประกอบทั้งหมด

การรับความช่วยเหลือ

1. รันเครื่องมือวินิจฉัยสำหรับการแก้ไขอัตโนมัติ
2. ตรวจสอบ Gateway log สำหรับข้อความแสดงข้อผิดพลาดโดยละเอียด
3. ติดต่อฝ่ายสนับสนุนผ่าน Intercom chat widget ในแอปเดสก์ท็อป