Einrichtung
anyy setup führt Sie von einem installierten Anyy-Befehl zu einem funktionierenden persönlichen Assistenten. Sie können ein Modell konfigurieren, Nachrichtenkanäle verbinden, optionale Medien- und Webfähigkeiten ergänzen und MCP-Server registrieren.
Wählen Sie bei der ersten Installation Schnelleinrichtung. Bringen Sie zuerst ein lokales Gespräch zum Laufen, bevor Sie Ausweichmodelle, Nachrichtenkanäle oder externe Werkzeuge hinzufügen.
Bevor Sie beginnen
Sie benötigen ein interaktives Terminal und mindestens eine nutzbare Modellverbindung:
- einen API-Schlüssel eines Anbieters;
- eine unterstützte Abonnementanmeldung;
- einen laufenden Ollama- oder LM-Studio-Server; oder
- einen OpenAI- oder Anthropic-kompatiblen Endpunkt.
Starten Sie den Assistenten aus dem zu konfigurierenden Profil:
anyy setup
Verwenden Sie --profile NAME vor oder --home PATH nach dem Befehl, wenn Sie nicht das Standardprofil möchten:
anyy --profile work setup
anyy setup --home /path/to/anyy-home
Einen Einrichtungsmodus wählen
Der erste Bildschirm bietet zwei Wege:
| Modus | Konfiguriert |
|---|---|
| Schnelleinrichtung | Anbieter, Authentifizierung, Hauptmodell, optionale Modellausweichroute und Nachrichtenkanäle |
| Vollständige Einrichtung | Alles aus der Schnelleinrichtung, anschließend optional Bild, Video, Sprache, Websuche und MCP |
Beide Wege enden mit einer einzigen Prüfung. Die erfasste Konfiguration wird erst festgeschrieben, nachdem Sie Diese Änderungen schreiben? bestätigen. Eine ausdrücklich gestartete Anmeldung kann den Authentifizierungsdienst schon vor dieser Bestätigung kontaktieren.
Das Hauptmodell konfigurieren
Der Abschnitt Anbieter und Modell fragt nach:
- einem Anbieter;
- einer für diesen Anbieter angebotenen Authentifizierungsmethode;
- gegebenenfalls erforderlichem Endpunkt oder Zugangsdaten; und
- dem Hauptmodell.
Bietet der Anbieter einen Modellkatalog, ruft Anyy ihn ab und lässt Sie ein Modell auswählen. Kompatible oder lokale Anbieter können auch eine manuell eingegebene Modell-ID verlangen.
Häufige Wege sind:
| Verbindung | Einrichtungsoption |
|---|---|
| OpenAI-API-Schlüssel | OpenAI → OpenAI-API-Schlüssel |
| ChatGPT-Abonnement | OpenAI → ChatGPT-Abonnement (Codex) |
| Anthropic-API-Schlüssel | Anthropic → Anthropic API |
| Claude-Code-Abonnement | Anthropic → Claude-Code-Abonnement |
| Lokales Modell | Ollama oder LM Studio |
| Kompatibler Dienst | OpenAI-kompatibel oder Anthropic-kompatibel |
Der installierte Assistent ist der maßgebliche Anbieterkatalog. Er zeigt nur Authentifizierungsmethoden, die diese Anyy-Version implementiert.
Ein kompatibler Endpunkt erhält Ihre Prompts, Anhänge und Modellanfrage-Metadaten. Verwenden Sie einen Endpunkt, den Sie betreiben oder dem Sie vertrauen.
Nur das Modell konfigurieren
Um Anbieteranmeldung oder Hauptmodell ohne Nachrichtenkanäle und optionale Werkzeuge zu ändern, führen Sie Folgendes aus:
anyy setup model
Ist bereits ein Gateway erreichbar, lädt Anyy nach dem bestätigten Schreiben die Anbieterkonfiguration neu. Andernfalls wird die gespeicherte Konfiguration beim nächsten Laufzeitstart wirksam.
Modellausweichrouten hinzufügen
Während der vollständigen oder schnellen Einrichtung fragt Anyy, ob Ausweichrouting konfiguriert werden soll. Überspringen Sie dies beim ersten Durchlauf, sofern Sie nicht bereits ein zweites getestetes Anbieter-/Modellpaar haben.
Sie können die geordnete Ausweichkette später verwalten:
anyy setup model fallback
Ein Hauptmodell muss bereits konfiguriert sein. Ausweichmodelle werden in gespeicherter Reihenfolge versucht, wenn das Routing ein nicht verfügbares Hauptziel überspringen kann; sie ersetzen weder gültige Zugangsdaten noch einen funktionsfähigen Anbieter.
Nachrichtenkanäle verbinden
Im Abschnitt Nachrichtenkanäle können Sie eine unterstützte Plattform verbinden oder den Schritt überspringen. Für einen gezielten Durchlauf nur für Nachrichtenkanäle verwenden Sie:
anyy setup channel
Die Kanaleinrichtung kann nach Kontokennungen, Zugriffsrichtlinien, Webhook-Details und Zugangsdaten fragen. Nach Bestätigung einer Kanaländerung installiert und startet Anyy den residenten Gateway-Dienst, damit die Verbindung nach dem Schließen des Terminals verfügbar bleibt.
Webhook-Zustellung benötigt zusätzlich den Webhook-Listener des Gateways. Er ist standardmäßig deaktiviert; aktivieren Sie channel_webhooks.enabled, wählen Sie eine erreichbare Adresse für channel_webhooks.listen und starten Sie Gateway neu, bevor Sie den Plattform-Callback konfigurieren. Das Speichern oder Neuladen eines Kontos allein aktiviert diesen Listener nicht. Die Plattformanleitung beschreibt Authentifizierung und Anforderungen an öffentliches HTTPS.
Unter Nachrichtenplattformen finden Sie unterstützte Plattformen, Kopplung, Zustandsprüfungen und Neuladebefehle.
Optionale Fähigkeiten
Die vollständige Einrichtung kann außerdem konfigurieren:
- Bildverständnis;
- Videoverständnis;
- Bilderzeugung;
- Text-zu-Sprache und Sprache-zu-Text;
- Websuche; und
- einen oder mehrere MCP-Server.
Jeder Punkt ist optional. Wählen Sie nur benötigte Fähigkeiten; jedes externe Backend kann eigene Zugangsdaten, Datenverarbeitung und Nutzungsgebühren haben.
Prüfen Sie Medien über die unterstützte Eingabeoberfläche: Der Dashboard-Uploader stuft PNG/JPEG als Bilder und andere Uploads als Dateien ein. Das bloße Hochladen einer Audio- oder Videodatei dort ruft keine Sprach- oder Videoverarbeitung auf. Siehe Medienverständnis.
Prüfen und schreiben
Vor dem Schreiben zeigt der Assistent Änderungen prüfen. Prüfen Sie Anbieter, Modell, Endpunkt, Anzahl der Zugangsdaten, Ausweichroute, Kanäle, optionale Fähigkeiten und MCP-Einträge.
Bestätigen Sie:
Write these changes? [Y/n]
Bei Erfolg gibt Anyy setup complete aus und schlägt Folgendes vor:
anyy status
anyy config
anyy
Ein Abbruch vor der letzten Bestätigung lässt erfasste lokale Einstellungen ungeschrieben und übermittelt keine erfassten Kanalaktionen. Nach der Bestätigung werden Kanalaktionen direkt über das residente Gateway ausgeführt; der Assistent prüft ihre lokalen Belege und meldet Verbindungsdiagnosen gesondert.
Wo die Einrichtung Daten speichert
Für das ausgewählte Profil-Home:
| Daten | Speicherort |
|---|---|
| Anbieter-, Modell-, Routing- und Fähigkeitseinstellungen | <PROFILE_HOME>/config.yaml |
| Anbieter-/MCP-Zugangsdaten-Dateien | <PROFILE_HOME>/secrets/ |
| Kanalkonten und geschützte verschlüsselte Zugangsdaten | <PROFILE_HOME>/state.db |
| Sitzungen und Laufzeitzustand | <PROFILE_HOME>/state.db |
Zugangsdaten-Dateien und verschlüsselte Kanalbindungen sind von config.yaml getrennt und werden mit Dateimodus 0600 geschrieben. Mit anyy config sehen Sie aufgelöste Pfade und Zugangsdatenstatus, ohne geheime Werte auszugeben.
Gezielte Einrichtungsbefehle
anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
[--set INPUT=VALUE] \
[--sensitive-fd INPUT=FD] \
[--external-locator-fd INPUT=FD]
Die letzte Form ist der nicht interaktive Kanalweg. Vertrauliche Werte werden aus Dateideskriptoren gelesen, damit sie nicht im Befehlsverlauf oder in Prozessargumenten erscheinen müssen.
Fehlerbehebung
| Problem | Lösung |
|---|---|
requires an interactive terminal | Führen Sie anyy setup, anyy setup model oder das interaktive anyy setup channel direkt in einem Terminal aus |
| Leere API-Schlüsseleingabe bricht die Einrichtung ab | Führen Sie anyy setup model erneut aus und geben Sie einen gültigen Schlüssel ein oder wählen Sie eine andere Authentifizierungsmethode |
| Keine lokalen Modelle erscheinen | Starten Sie Ollama oder LM Studio, prüfen Sie den Endpunkt und wiederholen Sie die Modelleinrichtung |
| Die Abonnementanmeldung wird nicht fertig | Schließen Sie den Browser-/Geräteablauf ab und wiederholen Sie die Einrichtung, falls die Terminalsitzung abgelaufen ist |
| Gespeicherte Einstellungen sind nicht sichtbar | Vergleichen Sie aktives Profil und Home mit anyy config; möglicherweise haben Sie ein anderes Profil konfiguriert |
| Ein Kanal verbindet nicht | Führen Sie anyy channel doctor CHANNEL und nach Korrektur der Einstellungen anyy channel reload aus |
Weiter geht es mit Dashboard-Übersicht oder Modelle konfigurieren.