Fehlerbehebung

Diese Anleitung behandelt haeufige Probleme, die bei der Verwendung von Neotask auftreten koennen, und wie Sie sie loesen.

Lizenz & Aktivierung

"Ungueltiger Lizenzschluessel"

• Ueberpruefen Sie das Schluesselformat: SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX
• Pruefen Sie auf zusaetzliche Leerzeichen oder fehlende Zeichen
• Stellen Sie sicher, dass eine aktive Internetverbindung besteht
• Versuchen Sie, den Schluessel sorgfaeltig erneut einzugeben

"Lizenz widerrufen"

• Ihre Lizenz wurde vom Server widerrufen
• Ueberpruefen Sie Ihren Abrechnungsstatus auf neotask.ai
• Kontaktieren Sie den Support, wenn Sie glauben, dass dies ein Fehler ist

"Lizenz abgelaufen"

• Ihr Abonnement ist abgelaufen
• Erneuern Sie Ihren Tarif ueber das Abrechnungsportal
• Die App wechselt bei Ablauf in den Nur-Lese-Modus

"Offline-Gnadenfrist abgelaufen"

• Sie waren laenger als 72 Stunden offline
• Verbinden Sie sich mit dem Internet fuer automatische Revalidierung
• Die App nimmt den normalen Betrieb wieder auf, sobald eine Verbindung besteht

"Version blockiert"

• Ihre App-Version wurde aus Sicherheitsgruenden blockiert
• Aktualisieren Sie sofort auf die neueste Version
• Auto-Update sollte Sie auffordern; wenn nicht, laden Sie von der Website herunter

Gateway-Probleme

"Gateway konnte nicht gestartet werden"

1. Pruefen Sie, ob Port 18789 verfuegbar ist (nicht von einer anderen App verwendet)
2. Versuchen Sie, die App neu zu starten
3. Ueberpruefen Sie den Gateway-Zustand im Dashboard
4. Unter macOS stellen Sie sicher, dass die App die notwendigen Berechtigungen hat unter Systemeinstellungen > Datenschutz & Sicherheit

"3-Strike-Sperre"

• Nach 3 aufeinanderfolgenden Gateway-Fehlern werden Operationen blockiert
• Starten Sie die App neu, um den Sperrzaehler zurueckzusetzen
• Wenn es weiterhin auftritt, ueberpruefen Sie die Logs auf den zugrunde liegenden Fehler

"Gateway getrennt"

• Die lokale Laufzeitumgebung hat die Verbindung verloren
• Klicken Sie auf "Erneut verbinden" im Gateway-Panel
• Wenn die Verbindung immer wieder getrennt wird, starten Sie die App neu
• Pruefen Sie, ob keine Firewall Localhost-Verbindungen blockiert

Sprachprobleme

"Keine Audioeingabe erkannt"

• Erteilen Sie Mikrofonberechtigung:
  • macOS: Systemeinstellungen > Datenschutz & Sicherheit > Mikrofon > Fuer Neotask aktivieren
  • Windows: Einstellungen > Datenschutz > Mikrofon > Apps den Zugriff erlauben
• Pruefen Sie, ob Ihr Mikrofon nicht stummgeschaltet ist
• Ueberpruefen Sie, ob das richtige Eingabegeraet in den Systemeinstellungen ausgewaehlt ist

"Aktivierungswort wird nicht erkannt"

1. Stellen Sie sicher, dass die Sprachaktivierung in den Einstellungen aktiviert ist
2. Pruefen Sie, ob der Aktivierungsmodus auf "Porcupine" eingestellt ist (nicht "Shortcut" oder "Aus")
3. Sagen Sie die Aktivierungsphrase deutlich: "Hey Neotask"
4. Versuchen Sie stattdessen die Tastenkombination (Cmd+Shift+Leertaste / Ctrl+Shift+Leertaste)
5. Pruefen Sie, ob eine andere App das Mikrofon verwendet

"TTS-Audio abgehackt oder verzoegert"

• Ueberpruefen Sie Ihre Internetverbindung (TTS erfordert die ElevenLabs API)
• ElevenLabs koennte eine Ratenbegrenzung erleben
• Versuchen Sie eine andere Stimme in den Einstellungen
• Reduzieren Sie die Netzwerkaktivitaet im Hintergrund

"Sprach-Shortcut funktioniert nicht"

• Eine andere App koennte dieselbe Tastenkombination belegt haben
• Aendern Sie die Tastenkombination unter Einstellungen > Aktivierung > Tastenkombination
• Unter macOS pruefen Sie Systemeinstellungen > Tastatur > Tastaturkuerzel auf Konflikte

Verbindung & Netzwerk

"Kann nicht mit dem Server verbinden"

• Ueberpruefen Sie Ihre Internetverbindung
• Pruefen Sie, ob neotask.ai in Ihrem Browser erreichbar ist
• Wenn Sie hinter einer Unternehmens-Firewall sind, stellen Sie sicher, dass HTTPS-Verkehr erlaubt ist
• Versuchen Sie, VPN voruebergehend zu deaktivieren

"API-Anfrage fehlgeschlagen"

• Ueberpruefen Sie Ihre Internetverbindung
• Stellen Sie sicher, dass Ihre Lizenz aktiv ist
• Wenn Sie BYOK verwenden, pruefen Sie, ob Ihr API-Schluessel gueltig ist und Guthaben hat
• Versuchen Sie, das Dashboard zu aktualisieren

Agenten & Sitzungen

"Agent kann nicht erstellt werden: Limit erreicht"

• Die Agentenanzahl ist in keinem Tarif begrenzt; das Erstellen eigener Agenten erfordert einen bezahlten Tarif
• Wenn Sie dies im Free-Tarif sehen, wechseln Sie zu einem bezahlten Tarif, um eigene Agenten zu erstellen
• Loeschen Sie nicht verwendete Agenten, um Ihren Arbeitsbereich uebersichtlich zu halten

"Agent antwortet nicht"

• Ueberpruefen Sie den Gateway-Zustand (muss ausgefuehrt werden)
• Stellen Sie sicher, dass das Modell des Agenten zugaenglich ist (API-Schluessel gueltig, Anbieter verfuegbar)
• Pruefen Sie das Tagesbudget, denn wenn es ueberschritten ist, werden Agenten bis Mitternacht UTC pausiert
• Versuchen Sie, die Sitzung zurueckzusetzen

"Sitzungsnachrichten werden nicht geladen"

• Aktualisieren Sie die Seite/App
• Ueberpruefen Sie den Gateway-Verbindungsstatus
• Wenn die Sitzung sehr lang ist, versuchen Sie, eine neue Sitzung zu erstellen

Abrechnung & Zahlungen

"Zahlung fehlgeschlagen"

• Ueberpruefen Sie, ob Ihre Kartendaten korrekt sind
• Erkundigen Sie sich bei Ihrer Bank nach moeglichen Sperren fuer internationale Transaktionen
• Versuchen Sie eine andere Zahlungsmethode
• Kontaktieren Sie den Support, wenn das Problem weiterhin besteht

"Nutzungszuweisung ueberschritten"

• Der Token-Verbrauch Ihres Agenten hat die in Ihrem Abonnement enthaltene Zuweisung ueberschritten
• Zusaetzliche Nutzung wird zu Nutzungsraten abgerechnet. Ueberpruefen Sie die Nutzungsseite in Ihrem Dashboard fuer Details.
• Wechseln Sie zum BYOK-Modus (eigene API-Schluessel verwenden), um Token-Kosten direkt an Ihren Anbieter zu leiten
• Legen Sie taegliche Budgetlimits fest, um unerwartete Mehrkosten zu vermeiden

"Tarif nach Zahlung nicht aktualisiert"

• Stripe Webhooks koennen eine leichte Verzoegerung haben (normalerweise unter 1 Minute)
• Aktualisieren Sie das Dashboard
• Wenn nach 5 Minuten immer noch nicht aktualisiert, kontaktieren Sie den Support mit Ihrer Zahlungsbestaetigung

Leistung

"App langsam beim Start"

• Lizenzvalidierung und Gateway-Start erfolgen beim Start, und das ist normal
• Stellen Sie sicher, dass Ihr System die Mindestanforderungen erfuellt
• Schliessen Sie unnoetige Hintergrund-Apps

"Hohe CPU-Auslastung"

• Wenn das immer aktive Aktivierungswort (Porcupine) verwendet wird, benoetigt es minimale CPU, kann aber deaktiviert werden
• Pausieren Sie Sprachsitzungen, wenn sie nicht in Gebrauch sind
• Pruefen Sie auf haengende Gateway-Prozesse im Aktivitaetsmonitor / Task-Manager

"Hoher Speicherverbrauch"

• Lange Chat-Sitzungen sammeln Speicher an
• Erstellen Sie regelmaessig neue Sitzungen
• Starten Sie die App neu, um angesammelten Zustand zu loeschen

Hilfe erhalten

• Dokumentation: Sie sind hier. Durchsuchen Sie die Wissensdatenbank.
• Support: Besuchen Sie die Support-Seite auf neotask.ai/support
• Kontakt: Verwenden Sie das Kontaktformular auf der Website
• Status: Pruefen Sie den Dienststatus auf neotask.ai