Konfiguration

Konfigurationsreferenz

Vollständige Referenz für alle YeePilot-Konfigurationsoptionen in config.yaml

Zuletzt aktualisiert: 1. März 2026

Konfigurationsdatei

YeePilot speichert seine Konfiguration unter ~/.yeepilot/config.yaml. Diese Datei wird automatisch bei der Ersteinrichtung erstellt und kann manuell oder über den Befehl yeepilot setup bearbeitet werden.

yaml

# Beispiel-Minimalkonfiguration
ai:
  provider: openai
  model: gpt-4o
 
security:
  mode: strict
 
personality:
  language: en

Um Ihre Konfiguration mit Standardwerten neu zu generieren, führen Sie aus:

bash

yeepilot setup --reset

KI-Einstellungen

Der Abschnitt ai: steuert, welchen KI-Anbieter und welches Modell YeePilot verwendet und wie es mit dem Sprachmodell interagiert.

yaml

ai:
  provider: openai
  model: gpt-4o
  api_key: ""
  base_url: ""
  max_tokens: 4096
  token_mode: normal
  conversation_max_history: 10
  output_truncate_length: 500
  max_response_length: 102400
  engine: v2
  autonomy_profile: guarded
  think_mode: "off"
  agent_mode: false

provider

Das zu verwendende KI-Backend. Unterstützte Werte: openai, anthropic, openrouter.

yaml

ai:
  provider: openai

model

Die spezifische Modell-ID. Muss eine gültige Modell-ID für Ihren gewählten Anbieter sein.

Anbieter	Beispielmodelle
openai	`gpt-4o`, `gpt-4o-mini`, `o3-mini`
anthropic	`claude-sonnet-4-20250514`, `claude-haiku-4-20250414`
openrouter	`openai/gpt-4o`, `anthropic/claude-sonnet-4-20250514`

api_key

Ihr API-Schlüssel für den konfigurierten Anbieter. Obwohl Sie ihn hier setzen können, wird die Verwendung des Betriebssystem-Schlüsselbunds über yeepilot setup --auth oder Umgebungsvariablen für bessere Sicherheit empfohlen.

yaml

ai:
  api_key: "sk-..."

base_url

Den Standard-API-Endpunkt überschreiben. Nützlich für Proxys, lokale Modelle oder alternative API-kompatible Dienste.

yaml

ai:
  provider: openai
  base_url: "http://localhost:11434/v1"

max_tokens

Maximale Anzahl von Token, die die KI pro Antwort generieren kann. Standard: 4096.

yaml

ai:
  max_tokens: 8192

token_mode

Steuert, wie aggressiv YeePilot den Token-Verbrauch verwaltet. Standard: normal.

normal -- Vollständiger Kontext und detaillierte Antworten.
saver -- Kürzere System-Prompts, komprimierte Historie, aggressivere Kontextkomprimierung. Reduziert Kosten erheblich.

yaml

ai:
  token_mode: saver

conversation_max_history

Anzahl der vorherigen Nachrichten, die im Gesprächskontext beibehalten werden. Standard: 10. Niedrigere Werte reduzieren den Token-Verbrauch und halten die KI auf aktuelle Aufgaben fokussiert.

yaml

ai:
  conversation_max_history: 10

output_truncate_length

Maximale Anzahl von Zeichen aus der Befehlsausgabe, die in den KI-Kontext aufgenommen werden. Standard: 500. Verhindert, dass große Ausgaben Ihr Token-Budget aufbrauchen.

yaml

ai:
  output_truncate_length: 500

max_response_length

Hartes Limit für die KI-Antwortgröße in Bytes. Standard: 102400 (100 KB).

yaml

ai:
  max_response_length: 102400

engine

Die Version der Ausführungs-Engine. Standard: v2.

v2 -- Aktuelle Engine mit Agent Loop, Werkzeugaufrufen und mehrstufiger Ausführung.
legacy -- Einzeldurchlauf-Befehlsgenerierung ohne Werkzeugaufrufe.

yaml

ai:
  engine: v2

autonomy_profile

Steuert, wie viel Freiheit die KI hat, Befehle ohne Bestätigungsanfrage auszuführen. Standard: guarded.

high -- Führt SAFE- und MODERATE-Befehle automatisch aus. Nur DANGEROUS-Befehle erfordern Bestätigung.
guarded -- Führt SAFE-Befehle automatisch aus. MODERATE- und DANGEROUS-Befehle erfordern Bestätigung.
strict_review -- Jeder Befehl erfordert eine ausdrückliche Bestätigung vor der Ausführung, unabhängig von der Risikostufe.

yaml

ai:
  autonomy_profile: guarded

think_mode

Aktiviert erweitertes Reasoning für Anbieter, die es unterstützen (Anthropic, OpenAI Reasoning-Modelle). Standard: off.

off -- Kein erweitertes Denken.
on -- Denken mit Anbieter-Standardbudget aktivieren.
low -- Minimales Denkbudget.
medium -- Moderates Denkbudget für komplexe Aufgaben.
high -- Maximales Denkbudget für die schwierigsten Probleme.

yaml

ai:
  think_mode: medium

Sie können dies auch während einer Sitzung mit dem /think-Slash-Befehl umschalten.

agent_mode

Aktiviert den KI-Agent-Loop, der es der KI ermöglicht, mehrere Werkzeugaufrufe und Befehle zu verketten, um komplexe Aufgaben abzuschließen. Standard: false.

yaml

ai:
  agent_mode: true

Sicherheitseinstellungen

Der Abschnitt security: steuert Befehlssicherheitsprüfungen, Bestätigungsanforderungen und Audit-Protokollierung.

yaml

security:
  mode: strict
  require_confirmation: true
  blocked_patterns:
    - "rm -rf /"
    - "mkfs"
    - "dd if=/dev/zero"
  audit_log_path: "~/.yeepilot/audit.log"
  audit_max_size_mb: 10
  audit_max_archives: 50

mode

Die allgemeine Sicherheitshaltung. Standard: strict.

strict -- Maximale Sicherheit. Die meisten destruktiven Befehle werden vollständig blockiert. Empfohlen für Produktionsserver.
moderate -- Ausgewogene Sicherheit. Destruktive Befehle erfordern Bestätigung, werden aber nicht blockiert.
permissive -- Minimale Einschränkungen. Nur die gefährlichsten Befehle (z.B. Festplatten löschen) werden blockiert. Nur für isolierte Entwicklungsumgebungen geeignet.

yaml

security:
  mode: strict

require_confirmation

Ob vor der Ausführung von Befehlen eine Bestätigung erfolgen soll. Standard: true. Bei false bestimmt das Autonomieprofil, welche Befehle automatisch ausgeführt werden.

yaml

security:
  require_confirmation: true

blocked_patterns

Zusätzliche Befehlsmuster, die vollständig blockiert werden. Diese werden zusätzlich zu YeePilots integrierter Sperrliste von über 70 gefährlichen Mustern hinzugefügt.

yaml

security:
  blocked_patterns:
    - "shutdown"
    - "reboot"
    - "halt"
    - "init 0"

audit_log_path

Dateipfad für das manipulationserkennbare Audit-Protokoll. Standard: ~/.yeepilot/audit.log.

yaml

security:
  audit_log_path: "/var/log/yeepilot/audit.log"

audit_max_size_mb

Maximale Größe einer einzelnen Audit-Protokolldatei vor der Rotation. Standard: 10 MB.

yaml

security:
  audit_max_size_mb: 10

audit_max_archives

Anzahl der zu behaltenden rotierten Audit-Protokolldateien. Standard: 50.

yaml

security:
  audit_max_archives: 50

Sandbox-Einstellungen

Der Abschnitt sandbox: konfiguriert die Befehlsausführungsisolation. Sandbox-Einstellungen begrenzen, was Befehle tun können, um Ihr System zu schützen.

yaml

sandbox:
  enabled: true
  use_namespaces: true
  network_access: true
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64
  denied_paths:
    - "/etc/shadow"
    - "/root/.ssh"

enabled

Aktiviert oder deaktiviert die Ausführungs-Sandbox. Standard: true. Die Deaktivierung entfernt alle Ausführungslimits.

yaml

sandbox:
  enabled: true

use_namespaces

Verwendet Linux-Kernel-Namespaces für vollständige Prozessisolation (User, PID, Mount, Network). Standard: true. Nur unter Linux verfügbar. Fällt auf Prozessebenen-Limits unter macOS und Windows zurück.

yaml

sandbox:
  use_namespaces: true

network_access

Erlaubt Befehlen den Netzwerkzugriff. Standard: true. Auf false setzen, um die Befehlsausführung vollständig vom Netzwerk zu isolieren.

yaml

sandbox:
  network_access: false

max_cpu_seconds

Maximale CPU-Zeit, die ein einzelner Befehl verbrauchen kann. Standard: 300 Sekunden (5 Minuten).

yaml

sandbox:
  max_cpu_seconds: 300

max_memory_mb

Maximaler Speicher, den ein Befehl verwenden kann. Standard: 512 MB.

yaml

sandbox:
  max_memory_mb: 512

max_filesize_mb

Maximale Größe einer einzelnen Datei, die ein Befehl erstellen kann. Standard: 100 MB.

yaml

sandbox:
  max_filesize_mb: 100

max_processes

Maximale Anzahl von Kindprozessen, die ein Befehl erzeugen kann. Standard: 64.

yaml

sandbox:
  max_processes: 64

denied_paths

Dateipfade, die Befehle nicht lesen oder schreiben dürfen. Werden zusätzlich zu den integrierten geschützten Pfaden hinzugefügt.

yaml

sandbox:
  denied_paths:
    - "/etc/shadow"
    - "/etc/passwd"
    - "/root/.ssh"
    - "/home/*/.ssh/id_*"

Persönlichkeitseinstellungen

Der Abschnitt personality: steuert, wie YeePilot mit Ihnen kommuniziert.

yaml

personality:
  tone: casual
  language: en
  use_emoji: true
  verbosity: normal

tone

Der Gesprächston der KI-Antworten. Standard: casual.

casual -- Freundliche, ungezwungene Antworten.
professional -- Formelle, präzise Antworten. Gut für Arbeitsumgebungen.
minimal -- Minimale Erklärungen. Nur die Befehle und Ergebnisse.

yaml

personality:
  tone: professional

language

Sprache für YeePilots Oberfläche und KI-Antworten. Standard: en.

en -- Englisch
de -- Deutsch
auto -- Erkennung aus der Systemsprache

yaml

personality:
  language: auto

use_emoji

Emoji in KI-Antworten und Statusnachrichten einbeziehen. Standard: true.

yaml

personality:
  use_emoji: false

verbosity

Wie viel Detail die KI in Antworten einbezieht. Standard: normal.

brief -- Kurze, prägnante Erklärungen.
normal -- Ausgewogene Erklärungen mit Kontext.
detailed -- Ausführliche Erklärungen mit Hintergrundinformationen.

yaml

personality:
  verbosity: detailed

TUI-Einstellungen

Der Abschnitt tui: passt das Erscheinungsbild und Verhalten der Terminal-Benutzeroberfläche an.

yaml

tui:
  theme: auto
  stats_panel: true
  code_line_numbers: true
  live_stream_panel_enabled: true
  live_stream_panel_height: 12

theme

Farbschema für die Terminal-Oberfläche. Standard: auto (passt sich dem Terminal-Hintergrund an).

Verfügbare Themes: auto, dark, light, neon und weitere.

yaml

tui:
  theme: neon

stats_panel

Statistik-Panel mit Token-Verbrauch, Kosten und Sitzungsinformationen anzeigen. Standard: true.

yaml

tui:
  stats_panel: true

code_line_numbers

Zeilennummern in Codeblöcken in der TUI anzeigen. Standard: true.

yaml

tui:
  code_line_numbers: true

live_stream_panel_enabled

Ein Live-Panel anzeigen, das Befehlsausgaben in Echtzeit streamt, während Befehle ausgeführt werden. Standard: true.

yaml

tui:
  live_stream_panel_enabled: true

live_stream_panel_height

Anzahl der Zeilen für das Live-Stream-Panel. Standard: 12.

yaml

tui:
  live_stream_panel_height: 16

Tresor-Einstellungen

Der Abschnitt vault: konfiguriert den verschlüsselten Zugangsdatentresor zum Speichern von Geheimnissen wie Datenbankpasswörtern und API-Token.

yaml

vault:
  enabled: true
  start_locked: true
  auto_lock_duration: "15m"
  bruteforce_protection_enabled: true

enabled

Die verschlüsselte Tresor-Funktion aktivieren. Standard: true.

yaml

vault:
  enabled: true

start_locked

Ob der Tresor beim Start von YeePilot gesperrt sein soll, sodass Sie ihn entsperren müssen. Standard: true.

yaml

vault:
  start_locked: true

auto_lock_duration

Den Tresor nach dieser Inaktivitätsdauer automatisch sperren. Standard: 15m. Unterstützt das Go-Dauerformat (z.B. 5m, 1h, 30s).

yaml

vault:
  auto_lock_duration: "30m"

bruteforce_protection_enabled

Brute-Force-Schutz aktivieren, der Entsperrversuche nach wiederholten Fehlversuchen drosselt. Standard: true.

yaml

vault:
  bruteforce_protection_enabled: true

Plattform-Einstellungen

Der Abschnitt platform: konfiguriert die Konnektivität zum YeePilot-Plattformdienst.

yaml

platform:
  server_url: "https://yee.to"

server_url

Die URL des YeePilot-Plattformservers. Standard: https://yee.to. Ändern Sie dies nur, wenn Sie eine selbst gehostete Plattforminstanz verwenden.

yaml

platform:
  server_url: "https://yee.to"

Update-Einstellungen

Der Abschnitt update: steuert das automatische Update-Verhalten.

yaml

update:
  auto_check: true
  check_interval_hours: 1

auto_check

Automatisch nach Updates suchen, wenn YeePilot startet. Standard: true.

yaml

update:
  auto_check: true

check_interval_hours

Wie oft nach Updates gesucht wird, in Stunden. Standard: 1.

yaml

update:
  check_interval_hours: 24

Datei-Einstellungen

Der Abschnitt files: steuert das Verhalten des /file-Befehls zum Hochladen von Dateien als KI-Kontext.

yaml

files:
  max_entries: 20
  max_file_size: 102400
  max_total: 524288
  upload_dir: ""

max_entries

Maximale Anzahl von Dateien, die an eine Sitzung angehängt werden können. Standard: 20.

yaml

files:
  max_entries: 20

max_file_size

Maximale Größe einer einzelnen Datei in Bytes. Standard: 102400 (100 KB).

yaml

files:
  max_file_size: 102400

max_total

Maximale Gesamtgröße aller angehängten Dateien in Bytes. Standard: 524288 (512 KB).

yaml

files:
  max_total: 524288

upload_dir

Benutzerdefiniertes Verzeichnis für temporäre Datei-Uploads. Leer lassen, um den Systemstandard zu verwenden.

yaml

files:
  upload_dir: "/tmp/yeepilot-files"

Vollständiges Konfigurationsbeispiel

Nachfolgend eine umfassende Konfigurationsdatei mit allen Abschnitten und häufig angepassten Werten:

yaml

ai:
  provider: openai
  model: gpt-4o
  max_tokens: 4096
  token_mode: normal
  conversation_max_history: 10
  output_truncate_length: 500
  max_response_length: 102400
  engine: v2
  autonomy_profile: guarded
  think_mode: "off"
  agent_mode: false
 
security:
  mode: strict
  require_confirmation: true
  blocked_patterns: []
  audit_log_path: "~/.yeepilot/audit.log"
  audit_max_size_mb: 10
  audit_max_archives: 50
 
sandbox:
  enabled: true
  use_namespaces: true
  network_access: true
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64
  denied_paths: []
 
personality:
  tone: casual
  language: en
  use_emoji: true
  verbosity: normal
 
tui:
  theme: auto
  stats_panel: true
  code_line_numbers: true
  live_stream_panel_enabled: true
  live_stream_panel_height: 12
 
vault:
  enabled: true
  start_locked: true
  auto_lock_duration: "15m"
  bruteforce_protection_enabled: true
 
platform:
  server_url: "https://yee.to"
 
update:
  auto_check: true
  check_interval_hours: 1
 
files:
  max_entries: 20
  max_file_size: 102400
  max_total: 524288

Zurück

Zugangsdatentresor

Security

Weiter

Umgebungsvariablen

Configuration