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