123SUDODocs
Referenz

Fehlerbehebung

Korrekturen für Modellfehler, API-Schlüssel, lokale Modelle, Tools, Anhänge, Bilder, Sprache, Credits und Geräte.

Überprüfen Sie vor allem, ob Sie die neueste Version verwenden. Mehrere Probleme werden einfach durch ein Update behoben – siehe Updates und Versionen.

Die App lässt sich nicht installieren oder öffnen

Windows

Wenn SmartScreen das Installationsprogramm blockiert, wählen Sie Weitere Informationen → Trotzdem ausführen. Der Desktop-Build ist codesigniert, daher wird dies normalerweise nicht angezeigt.

Wenn die App installiert, aber nicht gestartet werden kann, versuchen Sie, sie über den Microsoft Store anstelle des direkten Installationsprogramms zu installieren – der Store-Build verwaltet seine eigenen Abhängigkeiten.

macOS

Wenn macOS sich weigert, die App zu öffnen, öffnen Sie Systemeinstellungen → Datenschutz und Sicherheit, lassen Sie sie dort zu und starten Sie sie dann erneut.

Stellen Sie sicher, dass Sie 9xchat in Anwendungen gezogen haben, anstatt es vom gemounteten Disk-Image auszuführen.

Linux

Überprüfen Sie, ob die heruntergeladene Datei als ausführbar markiert ist. Ist dies nicht der Fall, setzen Sie das ausführbare Bit darauf und führen Sie es erneut aus.

Mobile

Installieren Sie über Google Play oder den App Store, damit Updates automatisch eintreffen. Wenn die App nicht startet, aktualisieren Sie sie und starten Sie dann Ihr Gerät neu.

Antworten schlagen fehl oder bleiben teilweise stehen

Gehen Sie diese der Reihe nach durch:

  1. Überprüfen Sie Ihre Verbindung. Cloud-Modelle benötigen einen Internetzugang. Lokale Modelle tun es Nein – wenn Cloud-Anfragen fehlschlagen, lokale Anfragen aber funktionieren, liegt das Problem beim Netzwerk oder beim Anbieter, nicht bei 9xchat.

  2. Überprüfen Sie Ihr Guthaben. Wenn Sie 9xchat-Guthaben verwenden und diese haben gehen zur Neige, Anfragen hören auf. Laden Sie Ihr Guthaben auf oder wechseln Sie zu Ihrem eigenen API-Schlüssel.

  3. Überprüfen Sie Ihren API-Schlüssel. Wenn Sie Ihren eigenen Schlüssel mitgebracht haben, bestätigen Sie, dass er noch vorhanden ist gültig und es ist noch ein Kontingent bei diesem Anbieter vorhanden.

  4. Versuchen Sie es mit einem anderen Modell. Wenn ein Modell fehlschlägt und ein anderes erfolgreich ist, liegt das Problem vor liegt bei diesem bestimmten Modell oder Anbieter.

Ein Modell fehlt oder wird nicht geladen

  • Cloud-Modelle benötigen dafür entweder Credits oder einen konfigurierten API-Schlüssel Anbieter. Unter Bibliothek → Modellebleibt ein Anbieter alsInaktiv markiert, bis Sie seinen Schlüssel hinzufügen – diese Bezeichnung ist der schnellste Weg, um zu sehen, zu was Sie keine Route haben.

  • Lokale Modelle müssen Ihren lokalen Läufer starten, bevor 9xchat sie erreichen kann. Starten Sie es zuerst und öffnen Sie dann die Modellliste erneut.

Ihr API-Schlüssel wurde abgelehnt

Der Fehler liegt beim Provider, also gibt es auch die Lösung:

  1. Fügen Sie den Schlüssel erneut ein, ohne führende oder nachgestellte Leerzeichen.
  2. Bestätigen Sie, dass der Schlüssel zu dem Anbieter gehört, bei dem Sie ihn hinzugefügt haben.
  3. Überprüfen Sie, ob der Schlüssel noch vorhanden ist und nicht widerrufen oder rotiert wurde.
  4. Überprüfen Sie, ob die Abrechnung eingerichtet ist und ob das Kontingent bei diesem Anbieter verbleibt – a Ein gültiger Schlüssel ohne Guthaben schlägt auf die gleiche Weise fehl wie ein fehlerhafter.
  5. Bestätigen Sie, dass das von Ihnen ausgewählte Modell eines ist, das Ihr Konto verwenden darf. Einige Modelle benötigen eine separate Stufe beim Anbieter.

Schlüssel werden verschlüsselt auf Ihrem Computer gespeichert. Wenn ein Schlüssel überall nicht mehr funktioniert, ersetzen Sie ihn beim Anbieter, anstatt 9xchat neu zu installieren.

Ein lokales Modell stellt keine Verbindung her

  1. Starten Sie Ihren lokalen Runner und vergewissern Sie sich, dass er außerhalb von 9xchat reagiert.
  2. Bestätigen Sie, dass die Adresse und der Port überwacht werden, die 9xchat erwartet.
  3. Stellen Sie sicher, dass das Modell selbst gezogen und geladen wird, nicht nur der Läufer, der läuft.
  4. Öffnen Sie Bibliothek → Modelle erneut, damit die Liste aktualisiert wird.

Lokale Modelle benötigen keinen Schlüssel und keine Credits. Wenn ein lokales Modell funktioniert und ein Cloud-Modell nicht, liegt das Problem an Ihrem Schlüssel, Ihrem Kontostand oder dem Netzwerk.

Ein Tool oder MCP-Server funktioniert nicht

  1. Überprüfen Sie, ob das Tool aktiviert ist. Unter jedem Tool befindet sich der Schalter „Aktiviert“. Bibliothek → Tools.

  2. Überprüfen Sie den Plan. Agentische Tools und Live-Websuche benötigen Pro – siehe Credits, Pro und Nutzung.

  3. Lesen Sie die Sicherheitszeile. Darin wird angegeben, welche Berechtigungen das Tool benötigt. Ein Werkzeug das nicht erreichen kann, was es braucht, scheitert, anstatt zu fragen.

  4. Bei MCP-Servern bestätigen Sie, dass die erforderlichen Geheimnisse angegeben wurden – ein Eintrag immer noch markiert Konfiguration erforderlich wurde nicht eingerichtet. Die Konfigurationsvorschau zeigt den genauen Befehl, den sie ausführt. Es lohnt sich, sie noch einmal zu lesen, wenn der Server nie startet.

  5. Isolieren Sie es. Deaktivieren Sie das Tool, stellen Sie dieselbe Frage und prüfen Sie, ob das Verhaltensänderungen. Das verrät Ihnen, ob es sich überhaupt um das Tool handelt.

Die Wissenssuche findet nichts

Eine Sammlung muss indiziert werden, bevor sie durchsucht werden kann.

  • Bestätigen Sie, dass die Dateien einer Sammlung hinzugefügt und nicht nur an einen Chat angehängt wurden.
  • Bestätigen Sie, dass das Tool Wissen durchsuchen aktiviert ist.
  • Wenn Ihr Einbettungsanbieter beim Hinzufügen der Dateien nicht erreichbar war, Die Suche greift auf die Stichwortübereinstimmung zurück und übersieht alles, was den Index benötigt. Fügen Sie die Dateien erneut hinzu, sobald der Anbieter erreichbar ist.

Siehe Wissen und Erinnerungen.

Ein Anhang wird nicht verarbeitet

  • Bestätigen Sie, dass das von Ihnen ausgewählte Modell diesen Dateityp akzeptiert. Ein Nur-Text-Modell kann ein Bild nicht lesen, und das Modell listet Markierungen auf, die das Sehen handhaben.
  • Sehr große Dateien können den Kontext eines Modells überschreiten. Versuchen Sie es mit einem kleineren Extrakt oder einem Modell mit einem größeren Kontextfenster.
  • Wenn die Datei an anderer Stelle korrekt geöffnet wird, hier jedoch ein Fehler auftritt, versuchen Sie, sie in eine zu konvertieren allgemeines Format zuerst.

Die Bildgenerierung schlägt fehl

  • Die Bilderzeugung erfordert Pro.
  • Bestätigen Sie, dass Sie ein Bildmodell ausgewählt haben – es wird separat von Ihrem ausgewählt Chat-Modell.
  • Überprüfen Sie Ihr Guthaben, wenn Sie über 9xchat Guthaben generieren.
  • Einige Eingabeaufforderungen werden vom Anbieter und nicht von 9xchat abgelehnt. Umformulierung ist normalerweise schneller als ein erneuter Versuch.

Das Diktieren oder Vorlesen schlägt fehl

Beide benötigen einen funktionierenden Audioanbieter und keiner hat eine lokale Option.

  • Bestätigen Sie, dass Ihr TranskriptionsanbieterunterEinstellungen → Standard festgelegt ist Modelle.
  • Erteilen Sie die Mikrofonberechtigung 9xchat im Datenschutzbereich Ihres Betriebssystems Einstellungen – unter macOS Systemeinstellungen → Datenschutz und Sicherheit → Mikrofon.
  • Beide benötigen eine Verbindung, auch wenn Ihr Chat-Modell lokal ist.

Mikrofoneingang erfordert Pro; laut vorlesen geht nicht.

Das Guthaben geht schneller zur Neige als erwartet

Jede Nachricht zeigt ihre eigenen Kosten, Latenz und Token-Aufschlüsselung an, und die Sitzung zeigt eine laufende Gesamtsumme an. Wenn eine Gesamtsumme falsch aussieht, öffnen Sie die Zahlen pro Nachricht, um zu sehen, welcher Austausch dafür verantwortlich ist – langer Kontext, Begründungs-Tokens und große Anhänge erhöhen alle die Kosten für eine einzelne Runde.

Sie können dies pro Chat begrenzen, indem Sie die maximalen Abschlusstokens und das Kontextlimit in den Modelleinstellungen senken und Context Shield reduziert, wie viel Verlauf mit jeder Nachricht erneut gesendet wird.

Um das Ausgeben von Credits vollständig zu verhindern, fügen Sie Ihren eigenen API-Schlüssel hinzu oder verwenden Sie ein lokales Modell.

Eine Funktion ist ausgegraut oder fehlt

Mehrere Funktionen erfordern Pro: mehrere Registerkarten, das schwebende Fenster, Mini-Chat, der Schnellassistent, Agenten-Tools, Live-Websuche, der Bildspielplatz, Mikrofoneingang und das Speichersystem. Credits, Pro und Nutzung listet die vollständige Aufteilung auf.

Wenn Sie bereits bezahlen, bestätigen Sie, dass dieses Gerät mit der UID angemeldet ist, die das Abonnement enthält, und dass Sie das Gerätelimit nicht überschritten haben – ein Gerät kostenlos, drei Pro-Geräte. Folgen Sie UID auf drei Geräten, um ein Gerät anzuschließen, zu wechseln oder zu entfernen.

Auf einem anderen Gerät fehlt etwas

Ihr Arbeitsbereich wird lokal auf jedem Gerät gespeichert, sodass ein zweiter Computer, der mit derselben UID angemeldet ist, Ihre Chats, Notizen oder Erinnerungen nicht erbt. Das ist eher zu erwarten als ein Fehler.

  • Speicher gelten pro Gerät. Eine Neuinstallation beginnt ohne Speicher.
  • Handoff koppelt zwei Geräte für ein Gespräch; Der Rest wird nicht kopiert Ihres Arbeitsbereichs.
  • Um Material selbst zu verschieben, verwenden Sie Einstellungen → Daten & Exporte.

Ihr Abonnement folgt der UID, sodass ein Gerät, das sich damit verifiziert, Pro abruft, auch wenn der Inhalt nicht übertragen wird.

Hier hat nichts geholfen

Kontaktieren Sie uns über support mit:

  • Ihr Betriebssystem und die 9xchat-Version,
  • das Modell und den Anbieter, den Sie verwendet haben,
  • Egal, ob Sie Credits, Ihren eigenen Schlüssel oder ein lokales Model hatten,
  • was Sie getan haben und der genaue sichtbare Fehler.

Fügen Sie diese niemals in einen Bericht ein

Ihre UID, ein beliebiger API-Schlüssel, MCP-Geheimnisse oder der Inhalt einer privaten Konversation. Der Support benötigt sie nie und ein Screenshot des Modellbildschirms kann einen Schlüssel offenlegen.

Auf dieser Seite