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

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

---

## ปัญหา 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 ในแอปเดสก์ท็อป