DocsAnleitungenUpdates & Fehlerbehebung
Zurück zur Doku
Anleitungen

Updates & Fehlerbehebung

YeePilot aktualisieren, häufige Probleme beheben und Ihre Installation verwalten

Zuletzt aktualisiert: 1. März 2026

YeePilot aktualisieren

YeePilot enthält einen integrierten Updater, der neue Versionen direkt von der Kommandozeile herunterlädt und installiert.

Nach Updates suchen

Prüfen Sie, ob eine neue Version verfügbar ist, ohne sie zu installieren:

bash
yeepilot update --check

Dies zeigt die aktuelle Version, die neueste verfügbare Version und was sich geändert hat.

Neueste Version installieren

Die neueste Version herunterladen und installieren:

bash
yeepilot update

Der Updater wird:

  1. Nach der neuesten Version suchen.
  2. Die Binärdatei für Ihre Plattform herunterladen.
  3. Die Download-Prüfsumme verifizieren.
  4. Die aktuelle Binärdatei ersetzen.

Neuinstallation erzwingen

Wenn Ihre Installation beschädigt ist oder Sie dieselbe Version neu installieren möchten:

bash
yeepilot update --force

Dies lädt die neueste Version herunter und installiert sie, auch wenn Sie bereits auf dem aktuellen Stand sind.

Auf vorherige Version zurücksetzen

Wenn eine neue Version ein Problem verursacht, setzen Sie auf die zuvor installierte Version zurück:

bash
yeepilot update --rollback

YeePilot bewahrt ein Backup der vorherigen Binärdatei auf, um Rollbacks zu ermöglichen. Ein Rollback ist nur für das letzte Update möglich -- Sie können nicht mehrere Versionen zurücksetzen.

Automatische Updates

Standardmäßig prüft YeePilot stündlich automatisch auf Updates und benachrichtigt Sie, wenn eine neue Version verfügbar ist.

Konfiguration

yaml
# ~/.yeepilot/config.yaml
update:
  auto_check: true
  check_interval_hours: 1

Automatische Update-Prüfungen deaktivieren

Wenn Sie Updates lieber manuell verwalten:

yaml
update:
  auto_check: false

Oder über Umgebungsvariable:

bash
export YEEPILOT_UPDATE_AUTO_CHECK=false

Prüfhäufigkeit anpassen

Weniger häufig prüfen, um Netzwerkanfragen zu reduzieren:

yaml
update:
  check_interval_hours: 24  # Einmal pro Tag

Häufige Probleme beheben

"Connection refused" oder "Connection timed out"

Symptome: YeePilot kann die KI-Anbieter-API nicht erreichen.

Ursachen und Lösungen:

  1. Ungültiger API-Schlüssel -- Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist:

    bash
    yeepilot status

    Wenn der Schlüssel falsch ist, konfigurieren Sie ihn neu:

    bash
    yeepilot setup --auth

  2. Falsche Anbieter-URL -- Wenn Sie eine benutzerdefinierte base_url verwenden, überprüfen Sie deren Erreichbarkeit:

    bash
    curl -I https://api.openai.com/v1/models

  3. Netzwerkprobleme -- Prüfen Sie Ihre Internetverbindung und Proxy-/Firewall-Einstellungen. Wenn Sie hinter einem Unternehmens-Proxy sind, stellen Sie sicher, dass dieser HTTPS-Verkehr zum API-Endpunkt Ihres KI-Anbieters zulässt.

  4. Sandbox blockiert Netzwerk -- Wenn sandbox.network_access auf false gesetzt ist, können über YeePilot ausgeführte Befehle nicht auf das Netzwerk zugreifen. YeePilots eigene API-Aufrufe werden jedoch nicht von Sandbox-Einstellungen beeinflusst. Dieser Fehler stammt eher von der Netzwerkkonfiguration.

"Model not found" oder "Invalid model"

Symptome: Der KI-Anbieter lehnt die Modell-ID ab.

Ursachen und Lösungen:

  1. Falsche Modell-ID -- Modellbezeichner sind anbieterspezifisch. Überprüfen Sie, ob Sie das richtige Format verwenden:

    AnbieterBeispiel-Modell-ID
    OpenAIgpt-4o, gpt-4o-mini
    Anthropicclaude-sonnet-4-20250514
    OpenRouteropenai/gpt-4o, anthropic/claude-sonnet-4-20250514

  2. Modellzugriff nicht aktiviert -- Einige Modelle erfordern eine ausdrückliche Zugangsgenehmigung vom Anbieter. Prüfen Sie im Dashboard Ihres Anbieters, ob Sie Zugriff auf das Modell haben.

  3. Anbieter-Nichtübereinstimmung -- Stellen Sie sicher, dass die Modell-ID zu Ihrem konfigurierten Anbieter passt. Eine Anthropic-Modell-ID funktioniert nicht mit einer OpenAI-Anbietereinstellung.

    yaml
    # Korrekt: Modell passt zum Anbieter
ai:
  provider: anthropic
  model: claude-sonnet-4-20250514
 
# Falsch: Anthropic-Modell mit OpenAI-Anbieter
ai:
  provider: openai
  model: claude-sonnet-4-20250514

"Permission denied"

Symptome: YeePilot kann keine Befehle ausführen oder auf Dateien zugreifen.

Ursachen und Lösungen:

  1. Binärdatei-Berechtigungen -- Die YeePilot-Binärdatei benötigt Ausführungsberechtigung:

    bash
    chmod +x /usr/local/bin/yeepilot

  2. Installationsort -- Wenn die Installation in /usr/local/bin/ Root erfordert, verwenden Sie sudo:

    bash
    sudo curl -fsSL https://yee.to/install.sh | bash

  3. Sandbox-gesperrte Pfade -- Prüfen Sie, ob der Zielpfad in Ihrer sandbox.denied_paths-Liste steht:

    yaml
    sandbox:
  denied_paths:
    - "/etc/shadow"  # Befehle können auf diesen Pfad nicht zugreifen

  4. Dateibesitz -- Stellen Sie sicher, dass das Konfigurationsverzeichnis Ihrem Benutzer gehört:

    bash
    ls -la ~/.yeepilot/
# Falls Root gehörend:
sudo chown -R $(whoami) ~/.yeepilot/

"Keyring not available" oder Fehler bei der Zugangsdatenspeicherung

Symptome: YeePilot kann API-Schlüssel nicht im System-Schlüsselbund speichern oder abrufen.

Ursachen und Lösungen:

  1. Linux: libsecret-tools installieren

    bash
    # Ubuntu / Debian
sudo apt install libsecret-tools
 
# Fedora / CentOS
sudo dnf install libsecret
 
# Arch
sudo pacman -S libsecret

  2. Linux-Headless-Server: Kein Keyring-Daemon -- Auf Servern ohne Desktop-Umgebung fällt YeePilot auf eine verschlüsselte JSON-Datei unter ~/.yeepilot/credentials.json zurück. Wenn dieser Fallback nicht funktioniert, stellen Sie sicher, dass das Konfigurationsverzeichnis existiert und beschreibbar ist:

    bash
    mkdir -p ~/.yeepilot
chmod 700 ~/.yeepilot

  3. macOS: Keychain-Zugriffsaufforderung -- Wenn Keychain-Aufforderungen wiederholt erscheinen, klicken Sie auf Immer erlauben, um YeePilot dauerhaften Zugriff zu gewähren.

  4. Umgebungsvariablen als Workaround verwenden -- Wenn die Zugangsdatenspeicherung weiterhin Probleme verursacht, setzen Sie Ihren API-Schlüssel per Umgebungsvariable:

    bash
    export OPENAI_API_KEY=sk-...

Sandbox-Fehler

Symptome: Befehle schlagen mit Namespace- oder Sandbox-bezogenen Fehlern fehl.

Ursachen und Lösungen:

  1. User-Namespaces deaktiviert -- Einige Linux-Kernel oder gehärtete Konfigurationen deaktivieren User-Namespaces. Prüfen Sie:

    bash
    cat /proc/sys/kernel/unprivileged_userns_clone

    Wenn die Ausgabe 0 ist, aktivieren Sie es entweder:

    bash
    sudo sysctl kernel.unprivileged_userns_clone=1

    Oder deaktivieren Sie Namespace-Sandboxing:

    yaml
    sandbox:
  use_namespaces: false

  2. macOS oder Windows -- Namespace-Sandboxing ist auf diesen Plattformen nicht verfügbar. YeePilot deaktiviert es automatisch, aber wenn Sie Fehler sehen, setzen Sie explizit:

    yaml
    sandbox:
  use_namespaces: false

  3. Sandbox zu restriktiv -- Wenn legitime Befehle blockiert werden, passen Sie die Limits an:

    yaml
    sandbox:
  max_cpu_seconds: 600    # Von 300 erhöhen
  max_memory_mb: 1024     # Von 512 erhöhen
  max_processes: 128      # Von 64 erhöhen

"Token limit exceeded" oder Kontext zu groß

Symptome: Der KI-Anbieter lehnt Anfragen ab, weil die Nachricht zu lang ist.

Ursachen und Lösungen:

  1. Gesprächsverlauf reduzieren -- Weniger Nachrichten bedeutet weniger Kontext zum Senden:

    yaml
    ai:
  conversation_max_history: 5

  2. Ausgabetrunkierung reduzieren -- Begrenzen Sie, wie viel Befehlsausgabe einbezogen wird:

    yaml
    ai:
  output_truncate_length: 200

  3. Token-Sparmodus aktivieren -- Komprimiert den Kontext aggressiver:

    yaml
    ai:
  token_mode: saver

  4. Neue Sitzung starten -- Wenn die aktuelle Sitzung zu viel Kontext angesammelt hat, starten Sie neu. Die KI überträgt keinen Kontext zwischen Sitzungen.

TUI-Anzeigeprobleme

Symptome: Verzerrte Ausgabe, defekte Rahmenzeichen oder fehlende Farben.

Ursachen und Lösungen:

  1. Modernes Terminal verwenden -- Ältere Terminals unterstützen möglicherweise kein Unicode oder True Color. Verwenden Sie unter Windows das Windows Terminal. Unter Linux verwenden Sie einen modernen Terminal-Emulator (GNOME Terminal, Konsole, Alacritty, Kitty).

  2. Gebietsschema-Einstellungen prüfen -- Stellen Sie sicher, dass Ihr Gebietsschema UTF-8 unterstützt:

    bash
    locale

    Wenn LANG nicht auf .UTF-8 endet, setzen Sie es:

    bash
    export LANG=de_DE.UTF-8

  3. Themes wechseln -- Wenn Farben falsch aussehen, probieren Sie ein anderes Theme:

    yaml
    tui:
  theme: dark  # oder light, neon, auto

  4. Live-Stream-Panel deaktivieren -- Wenn das Live-Panel Flackern verursacht:

    yaml
    tui:
  live_stream_panel_enabled: false

Konfiguration zurücksetzen

Wenn Ihre Konfigurationsdatei beschädigt ist oder Sie neu beginnen möchten:

bash
yeepilot setup --reset

Dies regeneriert ~/.yeepilot/config.yaml mit Standardwerten und führt Sie erneut durch den Einrichtungsassistenten.

Um manuell zurückzusetzen, löschen Sie die Konfigurationsdatei und führen Sie die Einrichtung aus:

bash
rm ~/.yeepilot/config.yaml
yeepilot setup

YeePilot deinstallieren

Vollständige Deinstallation

Binärdatei, Konfiguration, Audit-Protokolle, Tresor und alle gespeicherten Daten entfernen:

bash
yeepilot uninstall --all

Konfiguration behalten

Binärdatei entfernen, aber Konfigurationsdateien behalten (nützlich, wenn Sie eine Neuinstallation planen):

bash
yeepilot uninstall --keep-config

Nur Binärdatei

Nur die Binärdatei entfernen und alles andere unberührt lassen:

bash
yeepilot uninstall --binary-only

Manuelle Deinstallation

Wenn der uninstall-Befehl nicht verfügbar ist oder die Binärdatei fehlt:

Linux/macOS:

bash
sudo rm /usr/local/bin/yeepilot
rm -rf ~/.yeepilot

Windows (PowerShell):

powershell
Remove-Item "C:\Program Files\YeePilot\yeepilot.exe"
Remove-Item -Recurse "$env:USERPROFILE\.yeepilot"

Denken Sie daran, unter Windows auch C:\Program Files\YeePilot aus Ihrem PATH zu entfernen.

Hilfe erhalten

Wenn Sie auf ein Problem stoßen, das hier nicht behandelt wird:

  1. Version prüfen -- Stellen Sie sicher, dass Sie die neueste Version ausführen:

    bash
    yeepilot update

  2. Status prüfen -- Überprüfen Sie Ihre aktive Konfiguration:

    bash
    yeepilot status

  3. Audit-Protokoll überprüfen -- Das Audit-Protokoll kann Fehlerdetails enthalten:

    bash
    tail -50 ~/.yeepilot/audit.log

  4. Website besuchen -- Besuchen Sie yee.to (opens in new tab) für die neueste Dokumentation und Ankündigungen.

Zurück

Best Practices

Guides