# Felsökning

Vanliga problem och hur du löser dem.

---

## Gateway-problem

### Gateway startar inte

- **Portkonfikt**, En annan process kan använda port 18789. Kontrollera med `lsof -i :18789`.
- **Konfigurationsfel**, Ogiltig JSON i `neotask.json`. Gateway validerar konfiguration vid start och rapporterar specifika fel.
- **Gateway-lås**, En tidigare instans kan ha lämnat en inaktuell låsfil. Diagnostikverktyget kan detektera och åtgärda detta.
- **Node.js-version**, Neotask kräver Node 22+.

### Gateway startar men inga kanaler ansluter

- **Saknade inloggningsuppgifter**, Varje kanal behöver sin egen autentisering (bot-token, QR-skanning, API-nyckel).
- **Nätverksproblem**, Kanaler behöver internetåtkomst för att ansluta till meddelandeplattforms-API:er.
- **Hastighetsgränser**, Vissa plattformar hastighetsbegränsar nya anslutningar. Vänta och försök igen.

### Kan inte ansluta från skrivbordsappen

- **Fel port**, Se till att skrivbordsappen ansluter till rätt Gateway-port.
- **Autentiseringsmismatch**, Gateway-token måste matcha.
- **Brandvägg**, Se till att porten är tillgänglig om Gateway är på en annan maskin.

---

## Kanalproblem

### WhatsApp ansluter inte

- **QR utgången**, QR-koder går ut efter ~60 sekunder. Skanna om snabbt.
- **Flerenhets-gräns**, WhatsApp begränsar länkade enheter.
- **Session skadad**, Radera WhatsApp-sessionskatalogen och para om.

### Telegram-bot tar inte emot meddelanden

- **Ogiltig bot-token**, Verifiera din bot-token med BotFather.
- **Integritetsläge**, Botar ser bara meddelanden när de omnämns i grupper som standard.
- **Webhook-konflikt**, En annan tjänst kan konsumera meddelanden.

### Discord-bot svarar inte

- **Saknade intents**, Aktivera nödvändiga Gateway Intents i Discord Developer Portal.
- **Saknade behörigheter**, Boten behöver läs- och sändningsbehörigheter i målkanalerna.

---

## Modellproblem

### Autentiseringsfel

- **Nyckel inte konfigurerad**, Se till att leverantörens API-nyckel är inställd.
- **Nyckel utgången**, Vissa OAuth-tokens går ut. Autentisera om.
- **Hastighetsgräns**, Nyckelrotation byter automatiskt om du har flera nycklar.

### Långsamma svar

- **Modellval**, Större modeller är långsammare. Prova en snabbare modell för snabba uppgifter.
- **Kontextstorlek**, Långa konversationer bromsar behandlingen. Prova `/compact`.
- **Nätverksfördröjning**, Kontrollera anslutning till din modelleverantör.

---

## Nodproblem

### Följappen kan inte hitta Gateway

- **Bindningsläge**, Gateway måste vara bunden till LAN eller Tailnet (inte loopback) för externa enheter.
- **Samma nätverk**, För Bonjour-identifiering måste båda enheterna vara på samma nätverk.
- **Manuell inmatning**, Ange Gateway-värd och port manuellt i appinställningarna.

---

## Sessionsproblem

### Kontextfönster överskridet

- **Kompaktera**, Använd `/compact` för att sammanfatta och återställa kontext.
- **Aktivera automatisk kompaktering**, Ange en kompakteringströskel i konfigurationen.
- **Ny session**, Börja om med `/new`.

---

## Diagnostik

Det inbyggda diagnostikverktyget kontrollerar vanliga problem och kan åtgärda många automatiskt:

- Konfigurationsvalidering
- Filbehörigheter
- Kanalanslutning
- Modellautentiseringsstatus
- Node.js-kompatibilitet
- Nätverkskonfiguration

Kontrollera Gateway-loggar för detaljerad felinformation. Slutpunkten `/health` ger maskinläsbar status för alla komponenter.

---

## Få hjälp

1. Kör diagnostikverktyget för automatiserade åtgärder
2. Kontrollera Gateway-loggar för detaljerade felmeddelanden
3. Kontakta support via Intercom-chattwidgeten i skrivbordsappen