Keural Duo

Duo ist ein ständig aktiver Agent, den die Desktop-App auf diesem Computer (oder auf einem verbundenen DGX Spark) installiert. Er läuft in einer isolierten Sandbox. Sie chatten über Duo in der Seitenleiste oder über Telegram mit ihm, und er führt die Routinen aus, die Sie eingerichtet haben. Grundlage sind NVIDIA NemoClaw und OpenClaw.

InstallierenAnkerlink kopieren

Wählen Sie unter Einstellungen → Duo → Laufzeitumgebung ein Modell und klicken Sie in der Zeile des Orts, an dem Duo laufen soll, auf Installieren. Die Schaltfläche Installieren ist deaktiviert, wenn kein Modell ausgewählt ist oder der Speicherplatz nicht ausreicht.

Ausführungsort und VoraussetzungenAnkerlink kopieren

Duo benötigt mindestens 20 GB Speicherplatz; empfohlen werden 40 GB oder mehr. Ist der Platz zu knapp, ist die Schaltfläche Installieren gesperrt und „{need} GB benötigt · {free} GB frei“ wird angezeigt.

ModellAnkerlink kopieren

Nach der Installation ändern Sie das Modell in der Zeile Modell. Innerhalb derselben Art erfolgt der Wechsel sofort über „Wechseln“. Wechseln Sie zwischen lokal, Cloud und Gateway, müssen Sie neu installieren. Beim Neuinstallieren bleiben die Routinen erhalten. Um Duo an einen anderen Ort zu verschieben, löschen Sie es zuerst und installieren es dann am neuen Ort.

InstallationsschritteAnkerlink kopieren

Die Schritte laufen in dieser Reihenfolge ab: Gerät prüfen → Container-Laufzeit vorbereiten → NemoClaw installieren → Modell starten (bei Cloud und Gateway den Modellzugang vorbereiten) → Sandbox erstellen → Duo einrichten → Funktion prüfen. Der aktuelle Schritt wird auf der Schaltfläche und in der Fortschrittskarte angezeigt. Dauert es länger, erscheint „Das dauert etwas länger als üblich. Bitte lassen Sie die App geöffnet.“ Schließen Sie die App trotzdem nicht.

Wenn die Installation stoppt, prüfen Sie die Ursache anhand der Meldung auf dem Bildschirm unter Wenn die Installation fehlschlägt.

Duo eines anderen Kontos oder ArbeitsbereichsAnkerlink kopieren

Pro Gerät gibt es nur ein Duo, das zu dem Konto und Arbeitsbereich gehört, in dem es installiert wurde. Melden Sie sich mit einem anderen Konto an oder wechseln Sie den Arbeitsbereich, zeigen die Einstellungen das Duo als „Nicht installiert“ an, und das Duo in der Seitenleiste sowie Mate & Morph werden ausgeblendet. Klicken Sie in diesem Zustand auf Installieren, erscheint eine Bestätigung, dass das vorhandene Duo samt Unterhaltungen und Routinen gelöscht wird. Mit Neu installieren wird das vorhandene Duo gelöscht und ein neues erstellt. Kehren Sie zum ursprünglichen Konto oder Arbeitsbereich zurück, wird das Duo wieder angezeigt.

Ist ein früher installiertes Duo noch vorhanden, wird es ohne Rückfrage bereinigt, bevor die Installation weiterläuft. Schlägt die Bereinigung fehl, bricht der Vorgang mit „Das vorherige Duo konnte nicht entfernt werden. Erneut installieren.“ ab.

Wenn die Installation fehlschlägtAnkerlink kopieren

Wenn die Installation stoppt, zeigt Einstellungen → Duo eine Fehlermeldung an. Steht in der Meldung ein Code in Klammern, prüfen Sie auch diesen Code. Nachdem Sie die Ursache behoben haben, klicken Sie erneut auf Installieren.

Lässt sich das Problem nicht lösen, wenden Sie sich unter Einstellungen → Support an uns. Nennen Sie die Meldung auf dem Bildschirm, den Code in Klammern und die Gerätart (macOS, Windows oder Spark).

Bereich Einstellungen → DuoAnkerlink kopieren

Während Installieren, Modellwechsel, Übernehmen in den Chat-Apps oder Löschen laufen, sind die anderen Bereiche gesperrt. Beim Aktivieren der Computernutzung oder beim Erweitern ihrer Regeln erscheint ein Bestätigungsdialog des Betriebssystems.

UnterhaltungAnkerlink kopieren

Klicken Sie in der Seitenleiste auf Duo (im Code-Modus wird es nicht angezeigt). Während die Verbindung unterbrochen ist, werden Nachrichten als „{n} wartet auf Versand“ angezeigt und nach der Wiederverbindung zugestellt. Wenn Sie /new senden, werden Sie gefragt, ob Sie ein neues Gespräch beginnen möchten.

Aktivieren Sie oben Duo-Infos, werden im Seitenbereich folgende Karten angezeigt.

Mit der Schaltfläche Hintergrundaufgaben sehen Sie die Liste der Unteragenten, die Duo gerade ausführt.

GesprächsgedächtnisAnkerlink kopieren

Unter Einstellungen → Duo → Gesprächsgedächtnis sehen Sie den „Verwendeten Kontext“ als Anzahl der Token und als Prozentwert. Mit Verdichten kürzen Sie das Gespräch, mit Neu starten öffnen Sie ein neues Gespräch. Das bisherige Gespräch bleibt erhalten. Während Duo arbeitet, können Sie dies erst nach Abschluss der Aufgabe tun. Erscheint „Das Gespräch ist für das Modell zu lang, und Duo konnte nicht antworten.“, verdichten Sie das Gespräch oder starten Sie ein neues.

RoutinenAnkerlink kopieren

Sagen Sie Duo etwas wie „Jeden Morgen um 9 Uhr: …“, dann wird die Karte Diese Routine erstellen? (Aufgabe · Zeitplan · Ort) angezeigt. Mit Routine erstellen wird sie gespeichert. Änderungen und Löschungen bestätigen Sie mit derselben Karte.

Im Bereich Duo-Infos schalten Sie Routinen auf der Karte Routinen ein und aus. Über Mehr wählen Sie Jetzt ausführen oder Löschen. In jeder Zeile sehen Sie den nächsten Lauf und den Status (Gesendet · Verpasst · Fehlgeschlagen · Pausiert · Abgelaufen). Ergebnisse werden in das Duo-Gespräch oder an Telegram zugestellt, zusätzlich erscheint eine Desktop-Benachrichtigung. Bei Jetzt ausführen erscheint keine Benachrichtigung. Routinen werden nur ausgeführt, während die App geöffnet ist.

Chat-Apps (Telegram)Ankerlink kopieren

Folgen Sie den Schritten unter Einstellungen → Duo → Chat-Apps → Telegram → Verbinden.

1. Öffnen Sie in Telegram @BotFather, senden Sie /newbot und wählen Sie einen Namen und einen Benutzernamen für Ihren Bot.
2. Fügen Sie das Bot-Token ein, das BotFather Ihnen gegeben hat, und klicken Sie auf Prüfen. Veröffentlichen Sie das Token nicht. Wer es kennt, kann den Bot steuern.
3. Scannen Sie den QR-Code mit dem Handy, um den Bot zu öffnen, und klicken Sie auf Starten. Erhalten Sie keine Antwort, senden Sie den auf dem Bildschirm angezeigten Code an den Bot.
4. Wird „Nur {name} kann per Direktnachricht mit Duo sprechen.“ angezeigt, klicken Sie auf Hinzufügen und danach auf Übernehmen.

Nach dem Übernehmen wird Duo neu gestartet (Gespräche und Dateien bleiben erhalten). Danach erscheinen Nachrichten, die Sie vom Handy senden, im Duo-Gespräch mit dem Hinweis „Über Telegram gesendet“. Nur die verbundene Person kann per Direktnachricht mit Duo chatten. Zum Trennen klicken Sie auf Verbindung trennen und danach auf Übernehmen. Ist Telegram verbunden, werden Routinen-Freigaben über Telegram angefragt.

Ein Bot-Token kann pro Konto nur auf einem Gerät (Duo) verwendet werden. Um ein anderes Gerät zu verbinden, heben Sie zuerst die Verbindung des bisherigen Geräts auf und registrieren Sie das Token danach erneut.

Freigaben für App-Aktionen erteilen Sie nur im Fenster der Keural-App, auch bei Gesprächen, die in Telegram begonnen wurden.

VerbindungenAnkerlink kopieren

Einrichten unter Einstellungen → Duo → Verbindungen.

ComputernutzungAnkerlink kopieren

Aktivieren Sie unter Einstellungen → Duo → Computernutzung die Option Duo erlauben, diesen Computer zu nutzen. Danach kann Duo die Apps auf diesem Computer bedienen, die Ordner lesen, die Sie angegeben haben, und Routinen erstellen. Beim Aktivieren startet Duo etwa eine Minute neu.

Auch bei Ohne Rückfrage ausführen oder Immer erlauben fragen heikle Schritte wie Senden, Löschen, Überschreiben, Bezahlen, Absenden, Anmelden, Veröffentlichen und Abbrechen sowie Tasten wie Eingabe, Rücktaste und ⌘Q immer vorher nach.

Wartet Duo auf Ihre Freigabe, erscheint über dem Eingabefeld „Duo wartet auf Ihre Freigabe“. Klicken Sie auf Prüfen, um das Freigabefenster zu öffnen. Zur Auswahl stehen Ablehnen · Einmal erlauben · Immer erlauben. Freigaben können nur in diesem Fenster erteilt werden.

Duo öffnet ohne Freigabe nur die Links aus Suchergebnissen. Adressen, die Duo selbst eingegeben oder geändert hat, zeigt das Freigabefenster vollständig an und fragt vorher nach.

Mate & MorphAnkerlink kopieren

Mate & Morph ist der Desktop-Charakter von Duo. Aktivieren Sie Einstellungen → Duo → Computernutzung → Mate & Morph → Auf dem Desktop anzeigen und wählen Sie den Charakter (Mate · Morph · Beide) und die Größe (Klein · Mittel · Groß).

• Er wird angezeigt, wenn Duo läuft und das Gespräch bereit ist. Wechseln Sie das Konto oder den Arbeitsbereich oder ist Duo in Ihrem Tarif nicht verfügbar, wird er ausgeblendet.
• Ein Klick auf den Charakter öffnet das Eingabefeld, ein Doppelklick öffnet die App. Neben dem Charakter werden der Status (Bereit · Arbeitet · Fertig · Blockiert · Braucht Ihre Eingabe · Wartet auf Freigabe) und der Grund für die letzte fehlgeschlagene Antwort angezeigt.
• Kontextmenü (Rechtsklick): Ausblenden · Als gelesen markieren · Duo öffnen · Duo-Einstellungen. Das Menü der Menüleiste (Tray) enthält außerdem Mate & Morph anzeigen/ausblenden.

WindowsAnkerlink kopieren

Duo unter Windows läuft in einer WSL-Distribution und unterstützt Unterhaltungen, Routinen, Telegram, Freigaben, Mate & Morph und Computernutzung wie unter macOS. Einige Apps sowie Sicherheitsfenster wie Passwortfelder, UAC-Abfragen und Terminals bedient Duo nicht, sondern überlässt sie Ihnen.

Unter Einstellungen → Duo → Neue Funktionen (für Windows-Computer) prüfen Sie die Duo-Verbindung, die Freigegebenen Ordner (Duo liest nur die von Ihnen gewählten Ordner), den App-Zugriff und die Letzten Aufgaben. Unter Windows können Sie außerdem Softwareinstallation (nur mit exakter Paket-ID) und WLAN-Verbindung (nur gespeicherte Profile) nutzen. Senden, Löschen, Überschreiben, Installieren und Netzwerkänderungen fragen immer vorher nach.

LöschenAnkerlink kopieren

Klicken Sie unter Einstellungen → Duo → Laufzeitumgebung in der Zeile des Orts, an dem Duo installiert ist, auf Löschen, und bestätigen Sie im Dialog mit Löschen. Die Sandbox, der Gesprächsverlauf, die Routinen und die Arbeitsdateien werden gelöscht. Unter macOS wird außerdem die Container-VM von Duo gelöscht. Ein Duo auf einem DGX Spark können Sie nur löschen, solange der Spark verbunden ist.

Häufige MeldungenAnkerlink kopieren

Technische Details für IT-VerantwortlicheAnkerlink kopieren

AnforderungenAnkerlink kopieren

Unter Windows trägt die Installation networkingMode=nat im Abschnitt [wsl2] von %USERPROFILE%\.wslconfig ein. Auf PCs mit gespiegeltem Netzwerk (mirrored) wird Duo nicht installiert.

InstallationsorteAnkerlink kopieren

DownloadsAnkerlink kopieren

Geben Sie in Firewall oder Proxy die folgenden Adressen frei. Die heruntergeladenen Dateien haben feste Versionen und werden per SHA-256 geprüft.

Bei Nutzung der Websuche oder der GitHub-Verbindung müssen zusätzlich api.tavily.com, api.search.brave.com, api.github.com und api.githubcopilot.com freigegeben werden.

Netzwerk und PortsAnkerlink kopieren

Ist die Firewall ufw auf dem Spark aktiv, öffnet die Installation während der Einrichtung zwei Ports (Gateway und Relais). Dabei geben Sie einmalig das Passwort des Spark-Kontos ein.

Die Sandbox greift nicht direkt auf das Internet zu. Websuche und Seitenabruf übernimmt die App für sie, und GitHub wird nur lesend verbunden.

ModelladressenAnkerlink kopieren

Bei https ist jede Gateway-Adresse zulässig. Bei http sind nur private IP-Adressen und interne Namen zulässig (.local, .lan, .internal, .intranet, .home.arpa sowie Namen ohne Punkt). localhost und Adressen mit user:pass@ werden nicht akzeptiert.

TelegramAnkerlink kopieren

• Das Bot-Token erhalten Sie über /newbot bei BotFather. Das Format lautet Zahl:Alphanumerisch.
• Wird ein Verbindungscode erstellt, öffnen Sie den Bot innerhalb von 10 Minuten auf dem Handy und senden innerhalb von 5 Minuten die erste Nachricht. Das Konto, das die erste Nachricht sendet, wird zugelassen.
• In Gruppenunterhaltungen antwortet Duo nicht.

RoutinenAnkerlink kopieren

Regeln für das Hinzufügen von OrdnernAnkerlink kopieren

Die folgenden Ordner können nicht hinzugefügt werden.

Berechtigungen für die ComputernutzungAnkerlink kopieren

Schaltflächen wie Senden, Löschen, Bezahlen, Kaufen, Absenden, Anmelden, Überweisen, Veröffentlichen und Abbrechen sowie Tasten wie Eingabe, Entf, Fenster schließen oder App beenden gelten als heikle Schritte und werden immer bestätigt.

Was beim Löschen entfernt wirdAnkerlink kopieren

Mit Löschen werden die Sandbox, der Duo-Gesprächsverlauf, die Routinen, die Verbindungen zu Telegram, GitHub und Suche sowie das Token des Cloud-Modells gelöscht. Gibt es auf diesem Gerät kein weiteres Duo, entfernt macOS außerdem ~/.keural-runtime/ und die Autostart-Einträge. Die Einstellungen von Mate & Morph und die Spark-Verbindungsdaten bleiben erhalten.