Einrichtungsassistent

Der Befehl prx onboard erstellt Ihre initiale Konfigurationsdatei, indem er Sie durch Anbieterauswahl, API-Schlüssel-Eingabe, Modellwahl und Gedächtnis-Backend-Einrichtung führt. Er ist die empfohlene Methode, um PRX zum ersten Mal zu konfigurieren.

Was Onboard macht

Wenn Sie prx onboard ausführen, führt der Assistent folgende Schritte durch:

1. LLM-Anbieter auswählen -- Fordert Sie auf, aus den 9 unterstützten Anbietern zu wählen (Anthropic, OpenAI, Google Gemini, Ollama, OpenRouter usw.)
2. API-Schlüssel speichern -- Schreibt Ihre Anbieter-Zugangsdaten sicher in die Konfigurationsdatei
3. Verfügbare Modelle abrufen -- Fragt die Anbieter-API ab, um Modelle aufzulisten, auf die Sie Zugriff haben
4. Standardmodell festlegen -- Lässt Sie das standardmäßig verwendete Modell auswählen
5. Gedächtnis-Backend konfigurieren -- Wahl zwischen Markdown (dateibasiert), SQLite oder PostgreSQL
6. Konfigurationsdatei schreiben -- Erstellt ~/.config/openprx/openprx.toml mit Ihren Einstellungen

Nach der Einrichtung ist PRX bereit zur Ausführung mit prx daemon oder prx chat.

Interaktiver Modus

Die standardmäßige Einrichtung ist die Schnelleinrichtung, die nur wesentliche Fragen stellt. Für einen vollständigen interaktiven Assistenten, der jeden Konfigurationsabschnitt durchgeht, verwenden Sie das Flag --interactive:

prx onboard --interactive

Der interaktive Assistent umfasst zusätzliche Konfiguration für:

• Gateway-Host- und Port-Einstellungen
• Kanal-Vorkonfiguration (Telegram, Discord usw.)
• Sicherheit und Autonomiestufe
• Arbeitsbereichsverzeichnis
• Beobachtbarkeitseinstellungen

Schnelleinrichtung (Standard)

Die Standard-Ausführung von prx onboard startet eine vereinfachte Schnelleinrichtung:

prx onboard

Diese fragt nach Ihrem Anbieter, API-Schlüssel und Modell -- mehr nicht. Alle anderen Einstellungen verwenden sinnvolle Standardwerte.

Schnelleinrichtung mit Flags

Überspringen Sie die interaktiven Eingabeaufforderungen vollständig durch Übergabe von Flags:

prx onboard \
  --provider anthropic \
  --api-key sk-ant-api03-xxxxxxxxxxxx \
  --model claude-sonnet-4-20250514

Verfügbare Flags:

Flag	Beschreibung	Beispiel
--provider	Name des LLM-Anbieters	anthropic, openai, ollama, openrouter
--api-key	API-Schlüssel oder Zugangsdaten des Anbieters	sk-ant-..., sk-...
--model	Standard-Modellbezeichner	claude-sonnet-4-20250514, gpt-4o
--memory	Gedächtnis-Backend	markdown, sqlite, postgres
--interactive	Vollständigen interaktiven Assistenten ausführen	(kein Wert)
--channels-only	Nur den Kanal-Reparaturassistenten erneut ausführen	(kein Wert)

Beispiele

Anthropic Claude mit Standardeinstellungen:

prx onboard --provider anthropic --api-key "$ANTHROPIC_API_KEY"

Lokales Ollama (kein API-Schlüssel erforderlich):

prx onboard --provider ollama --model llama3.2

OpenRouter mit einem bestimmten Modell:

prx onboard --provider openrouter --api-key "$OPENROUTER_API_KEY" --model anthropic/claude-sonnet-4-20250514

OpenAI mit SQLite-Gedächtnis:

prx onboard --provider openai --api-key "$OPENAI_API_KEY" --model gpt-4o --memory sqlite

Konfigurationsdatei

Der Einrichtungsassistent schreibt die Konfiguration nach:

~/.config/openprx/openprx.toml

Unter Linux folgt dies der XDG-Base-Directory-Spezifikation. Unter macOS wird ~/Library/Application Support/openprx/openprx.toml verwendet, sofern XDG_CONFIG_HOME nicht gesetzt ist.

Beispiel einer generierten Konfiguration

Nach Ausführung von prx onboard --provider anthropic --model claude-sonnet-4-20250514 sieht die generierte Konfiguration so aus:

# OpenPRX Configuration
# Generated by: prx onboard

# ── Provider ──────────────────────────────────────────────
default_provider = "anthropic"
default_model = "claude-sonnet-4-20250514"
default_temperature = 0.7
api_key = "sk-ant-api03-xxxxxxxxxxxx"

# ── Workspace ─────────────────────────────────────────────
workspace_dir = "~/.local/share/openprx"

# ── Memory ────────────────────────────────────────────────
[memory]
backend = "markdown"
# path defaults to workspace_dir/memory

# ── Gateway ───────────────────────────────────────────────
[gateway]
host = "127.0.0.1"
port = 3120

# ── Channels ──────────────────────────────────────────────
[channels]
cli = true

# ── Security ──────────────────────────────────────────────
[security]
autonomy = "supervised"

Sie können diese Datei jederzeit bearbeiten. PRX unterstützt Hot-Reload -- die meisten Änderungen werden wirksam, ohne den Daemon neu zu starten.

Konfigurationsabschnitte

Die Konfigurationsdatei unterstützt folgende Hauptabschnitte:

Abschnitt	Zweck
default_provider	Standardmäßig verwendeter LLM-Anbieter
default_model	Standardmäßig verwendetes Modell
api_key	API-Zugangsdaten des Anbieters
[memory]	Gedächtnis-Backend und Speichereinstellungen
[gateway]	HTTP/WebSocket-Gateway-Konfiguration
[channels]	Messaging-Kanal-Konfigurationen
[channels.telegram]	Telegram-Bot-Einstellungen
[channels.discord]	Discord-Bot-Einstellungen
[security]	Autonomiestufe, Sandbox, Richtlinien
[router]	LLM-Routing-Strategie
[self_system]	Einstellungen der Selbstentwicklungspipeline
[observability]	Metriken, Tracing, Logging
[cron]	Konfiguration geplanter Aufgaben
[plugins]	WASM-Plugin-Pfade und Einstellungen

Alle verfügbaren Optionen finden Sie in der Vollständigen Konfigurationsreferenz.

Überprüfung nach der Einrichtung

Führen Sie nach der Einrichtung den Diagnosebefehl aus, um zu überprüfen, ob alles korrekt konfiguriert ist:

prx doctor

Der Doctor prüft:

• Konfigurationsdatei -- Validiert TOML-Syntax und erforderliche Felder
• Anbieter-Konnektivität -- Testet den API-Schlüssel durch Abfrage des Anbieters
• Modellverfügbarkeit -- Bestätigt, dass das ausgewählte Modell erreichbar ist
• Gedächtnis-Backend -- Überprüft, ob das Speicher-Backend beschreibbar ist
• Systemabhängigkeiten -- Prüft optionale Werkzeuge (git, docker usw.)
• Netzwerk -- Testet Verbindung zu konfigurierten Diensten

Beispielausgabe:

PRX Doctor

  Config file .............. OK  (~/.config/openprx/openprx.toml)
  Provider (anthropic) ..... OK  (authenticated)
  Model .................... OK  (claude-sonnet-4-20250514)
  Memory (markdown) ........ OK  (writable)
  Gateway port (3120) ...... OK  (available)
  Git ...................... OK  (2.43.0)
  Docker ................... WARN (not installed -- sandbox features limited)

All critical checks passed.

Doctor-Unterbefehle

Der Doctor verfügt auch über Unterbefehle für gezielte Diagnosen:

# Modellkataloge aller Anbieter abfragen
prx doctor models

# Modelle für einen bestimmten Anbieter abfragen
prx doctor models --provider anthropic

Kanal-Reparaturassistent

Wenn Sie die Einrichtung bereits abgeschlossen haben und Kanal-Konfigurationen hinzufügen oder reparieren möchten, verwenden Sie das Flag --channels-only:

prx onboard --channels-only

Dies überspringt die Anbieter- und Modelleinrichtung und geht direkt zur Kanalkonfiguration.

Onboard erneut ausführen

Sie können prx onboard jederzeit erneut ausführen. Der Assistent erkennt Ihre vorhandene Konfiguration und bietet an, diese zu aktualisieren, anstatt sie von Grund auf zu überschreiben. Ihre bestehenden Kanal-Konfigurationen, Gedächtnisdaten und benutzerdefinierten Einstellungen bleiben erhalten.

Nächste Schritte

• Schnellstart -- Daemon starten und chatten
• Kanäle -- Messaging-Plattformen verbinden
• Konfigurationsreferenz -- Vollständige Liste aller Konfigurationsoptionen