# Antigravity Remote Control: Agenten vom Smartphone steuern
> So aktivierst du Remote Control in Google Antigravity auf dem Desktop und in der CLI: der Schalter, der agy remote-control-Daemon und was du bei Verbindungsproblemen tun kannst.
Source: https://ailoot.ai/blog/de/antigravity-remote-control-phone/
Canonical: https://ailoot.ai/blog/de/antigravity-remote-control-phone/
Language: de
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-009
Revision: sha256-23b1cd7e75163b0cde8ed31e5b4b3603c7bedf7d4a84c01c2355a0047342919e
[Ailoot-Dokumentation](https://ailoot.ai/docs/) — Referenzmaterial zur Nutzung des Dienstes.
Höhepunkte
In Antigravity 2.0 für den Desktop wird Remote Control über einen Schalter unter Einstellungen → App aktiviert. Du kannst unter antigravity.google.com über dasselbe Google-Konto eine Verbindung zu einer Sitzung herstellen. Antigravity CLI hat zwei Modi: `/remote-control` (oder das Flag `--remote-control`) öffnet einen Tunnel für die Dauer der Terminalsitzung, während `agy remote-control start` einen Hintergrund-Daemon ohne geöffnetes Terminal startet. Unter Linux läuft der Daemon nach dem Abmelden weiter und startet nach einem Neustart; unter Windows ist dafür eine Installation durch einen Administrator erforderlich; unter macOS und bei einer Standardinstallation von Windows wird er bei der nächsten Anmeldung wieder aufgenommen. Der Computer muss eingeschaltet und mit dem Internet verbunden sein. Die Funktion ist möglicherweise aufgrund von Konto- oder Organisationsrichtlinien oder Tarifbedingungen nicht verfügbar.
Wenn du Antigravity noch nicht installiert hast, beginne mit einem Überblick darüber, [was Google Antigravity ist und wie du es installierst](https://ailoot.ai/blog/de/google-antigravity/). Diese Anleitung richtet sich an Situationen, in denen ein Agent bereits eine längere Aufgabe bearbeitet (Refactoring, Tests ausführen, Abhängigkeiten migrieren) und du deinen Schreibtisch verlassen musst, während du die Sitzung weiterhin kontrollierst.
## Was ist Remote Control in Google Antigravity?
Remote Control ist eine Google-Antigravity-Funktion, mit der du sicher eine Verbindung zu Desktop- und CLI-Sitzungen auf deinen Rechnern herstellen und diese über jeden Webbrowser steuern kannst. Laut der offiziellen Beschreibung können große Aufgaben – zum Beispiel ein vollständiges Refactoring eines Subsystems, ein langer Testlauf oder eine komplexe Migration von Abhängigkeiten – viel Zeit in Anspruch nehmen. Mit Remote Control kannst du eine Sitzung verwalten, während du nicht an deinem Computer bist, und deine gesamte Entwicklungsumgebung bleibt lokal.
Die Funktion ist sowohl in der Desktop-App 2.0 als auch in der CLI verfügbar, der Terminalversion von Antigravity (`agy`), wird aber in beiden unterschiedlich aktiviert und verhält sich unterschiedlich.
## Remote Control in Antigravity 2.0 für den Desktop aktivieren
Du kannst Remote Control in den App-Einstellungen aktivieren:
1. Öffne das Bedienfeld **Einstellungen** mit `Cmd + ,` (oder `Ctrl + ,` unter Linux und Windows) oder klicke unten im linken Bereich auf die Schaltfläche **Einstellungen**.
2. Gehe zum Abschnitt **App**.
3. Stelle **Enable Remote Control** auf **On**.
4. *(Optional)* Lege einen **Nickname** fest, zum Beispiel `workstation-primary` oder `server-machine`, damit du diesen Rechner in der Liste der verbundenen Geräte leicht erkennst.
### Von einem Smartphone oder einem anderen Browser aus verbinden
So öffnest du eine Remote-Sitzung:
1. Öffne auf einem beliebigen Gerät einen Browser und rufe das [Antigravity Remote Control-Dashboard](https://antigravity.google.com) auf. Auf einem Smartphone kannst du die Web-App auch auf dem Startbildschirm installieren, um Push-Benachrichtigungen zu erhalten, wenn der Agent eine Aufgabe abgeschlossen hat oder eine Antwort von dir benötigt.
2. Melde dich mit demselben Google-Konto an, das du auf dem Desktop verwendest.
3. Wähle im Gerätewechsler den gewünschten Rechner aus.
4. Nach der Verbindung kannst du aktive Unterhaltungen sehen, neue Aufgaben für den Agenten starten und Implementierungspläne sowie Artefakte anzeigen.
Wenn der Rechner nicht in der Weboberfläche erscheint, empfehlen die offiziellen Anweisungen, drei Dinge zu überprüfen: ob der Schalter **Enable Remote Control** auf dem Computer, auf dem Antigravity läuft, eingeschaltet ist; ob dieser Computer eine Internetverbindung hat und nicht in den Ruhezustand gewechselt ist; und ob Desktop-App und Browser dasselbe Google-Konto verwenden.
Wenn die Netzwerkverbindung auf dem Gerät, das du zum Verbinden verwendest, vorübergehend unterbrochen wird, versucht die Weboberfläche automatisch, die Verbindung wiederherzustellen. Die Hintergrundaufgaben des Agenten und die im Terminal gestarteten Befehle laufen auf dem Computer mit Antigravity ununterbrochen weiter, solange er mit dem Internet verbunden bleibt.
Diagramm: Der Remote-Control-Schalter auf einem Laptop überträgt die Steuerung auf ein Smartphone, wenn du mit demselben Konto angemeldet bist
So funktioniert Remote Control auf dem Desktop: Schalte den Schalter am Computer ein und melde dich anschließend auf dem Smartphone mit demselben Google-Konto an.
## Zwei Remote-Control-Modi in Antigravity CLI
Die CLI hat zwei Modi: einen interaktiven Modus, der an einen bestimmten Terminalprozess gebunden ist, und einen Headless-Hintergrund-Daemon, der ohne geöffnetes Terminal läuft.
### Interaktiver Modus: `/remote-control`
Du kannst Remote Control in der aktuellen interaktiven `agy`-Sitzung aktivieren, ohne die CLI neu zu starten. Führe dies in der Eingabezeile aus:
```
/remote-control
```
Laut der offiziellen Beschreibung öffnet die CLI für die aktuelle Sitzung eine Verbindung – einen Reverse-Tunnel – und gibt den Hostnamen sowie einen Link zur aktiven Unterhaltung aus, den du auf einem anderen Gerät verwenden kannst:
```
Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/?p=c%2F on another device to continue this conversation.
```
Öffne diesen Link in einem Browser auf einem Laptop, Tablet oder Smartphone, melde dich mit demselben Google-Konto an, das du in der CLI verwendest, und setze die Arbeit in der Sitzung über die Antigravity-Weboberfläche fort.
So deaktivierst du den Tunnel, ohne die lokale Terminalsitzung zu beenden:
```
/remote-control off
```
Du kannst die CLI mit bereits aktiviertem Remote Control starten, indem du beim Start ein Flag verwendest:
```
agy --remote-control
```
Der interaktive Modus ist an den `agy`-Prozess gebunden: Wenn du die CLI beendest (`/exit`, `Ctrl+C`, `Ctrl+D`) oder das Terminalfenster schließt, wird der Remote-Control-Tunnel automatisch beendet und der Sitzungseintrag verschwindet aus dem Dashboard. Jeder interaktive CLI-Prozess hat eine eigene Sitzungs-ID und einen eigenen Hostnamen. Daher kannst du `agy --remote-control` gleichzeitig in mehreren Terminal-Tabs oder Arbeitsverzeichnissen ausführen.
Wenn du dich über einen Browser mit einer interaktiven CLI-Sitzung verbindest, werden beide Seiten in Echtzeit synchronisiert. Anfragen vom Remote-Gerät gehen direkt an das lokale Terminal, während die Schlussfolgerungen des Agenten, Tool-Aufrufe und Codeänderungen in der Remote-Oberfläche sichtbar sind. Wenn der Agent anhält, um eine Bestätigung (`y`/`n`) einzuholen oder eine Rückfrage zu stellen, kannst du von deinem Smartphone oder dem lokalen Terminal aus antworten. Einstellungen sind die Ausnahme: Du kannst sie nicht über die Remote-Weboberfläche ändern, sondern nur direkt in der CLI.
### Headless-Daemon: `agy remote-control start`
Der zweite Modus ist ein dauerhaft laufender Hintergrund-Daemon, der als OS-Dienst registriert wird. Er ist verfügbar, solange der Rechner eingeschaltet und mit dem Internet verbunden ist; das Verhalten nach dem Abmelden und einem Neustart hängt von der Plattform ab.
```
agy remote-control start
```
Der Daemon wird als OS-Dienst registriert (als systemd-Benutzerdienst unter Linux, LaunchAgent unter macOS oder Scheduled Task unter Windows) und startet sofort, ohne geöffnetes Terminalfenster.
Verwende `agy remote-control status`, um den Namen des Eintrags anzuzeigen. Wähle anschließend diesen Rechner im [Antigravity Remote Control-Dashboard](https://antigravity.google.com) aus und setze die Arbeit über die Antigravity-Weboberfläche fort.
Drei Befehle steuern den Daemon:
```
agy remote-control start Register and start the daemon
agy remote-control status Show the daemon's status and instance name
agy remote-control stop Stop the daemon and unregister it
```
Der Daemon verwendet die Anmeldedaten, mit denen du dich bei der CLI angemeldet hast. Die Anmeldung bei der CLI ist getrennt von der Anmeldung beim Antigravity-Desktopeditor auf demselben Rechner; verwende im Browser dasselbe Google-Konto wie in der CLI.
Du kannst den Rechnernamen des Headless-Daemons beim Start mit dem Flag `--name` festlegen:
```
agy remote-control start --name "my-workstation"
```
Wenn du `start --name` erneut mit einem neuen Wert ausführst, wird der Rechner umbenannt.
Wenn du keinen Namen festlegst, erzeugt der Daemon bei seinem ersten Start einen einprägsamen Namen (zum Beispiel `my-machine-distant-plume`); `agy remote-control status` zeigt den aktuellen Namen an. Du kannst ihn auch in der Einstellungsdatei ändern: Öffne unter Linux/macOS `~/.gemini/config/config.json` oder unter Windows `%USERPROFILE%\.gemini\config\config.json`, ändere den Wert von `cliRemoteControlHostname`, speichere die Datei und führe `agy remote-control start` erneut aus, um den Daemon neu zu starten. Der neue Name erscheint nach dem Neustart des Dienstes im Dashboard; Änderungen an der Datei werden nicht übernommen, solange der Daemon läuft.
In der Datei gibt es zwei ähnliche Felder. `cliRemoteControlHostname` ist der hier beschriebene Name des CLI-Daemons. `remoteControlHostname` ist ein separates Feld für den Antigravity-Desktopeditor auf demselben Rechner; in Antigravity 2.0 kannst du es unter **Einstellungen → App** ändern.
### Verhalten des Daemons nach dem Abmelden und einem Neustart
Das Verhalten hängt vom OS ab:
| Verhalten | Linux | macOS | Windows |
|----|----|----|----|
| Start | Beim Systemstart; keine Anmeldung erforderlich | Bei der Anmeldung | Beim Systemstart (wenn ein Administrator den Daemon installiert hat); andernfalls bei der Anmeldung |
| Läuft nach dem Abmelden weiter | Ja | Nein; wird bei der nächsten Anmeldung fortgesetzt | Ja, wenn der Start beim Systemstart konfiguriert ist |
| Stellt sich nach einem Fehler automatisch wieder her | Ja | Ja | Ja, bis zu drei Neustartversuche, danach beim nächsten Systemstart oder wenn `agy remote-control start` erneut ausgeführt wird |
### Besonderheiten unter Windows
Um den Daemon für den automatischen Start **beim Systemstart** zu registrieren, musst du als Administrator arbeiten. Du kannst dafür PowerShell oder die normale Eingabeaufforderung verwenden. Der Befehl `start` funktioniert auch in einem normalen Fenster, aber nach dem Abmelden oder einem Neustart wird der Daemon erst bei der nächsten Anmeldung und nicht beim Systemstart fortgesetzt. Die Befehle `status` und `stop` funktionieren in einem normalen Fenster ohne erhöhte Rechte.
### Welchen Modus solltest du wählen?
| Kriterium | Interaktiv (`/remote-control` / `agy --remote-control`) | Headless-Daemon (`agy remote-control start`) |
|----|----|----|
| Umfang | Eine interaktive Terminalsitzung | Der gesamte Rechner (OS-Hintergrunddienst) |
| Lebenszyklus | Aktiv, solange Remote Control eingeschaltet ist und die Terminalsitzung läuft | Übersteht Abmeldungen und Neustarts unter Linux sowie unter Windows, wenn ein Administrator ihn installiert hat; unter macOS und bei einer Standardinstallation von Windows wird er bei der nächsten Anmeldung fortgesetzt |
| Name des Eintrags | Für jede Sitzung neu (zum Beispiel `host-swift-falcon`) | Ein dauerhafter Rechnername (`--name` oder `cliRemoteControlHostname`) |
| Gleichzeitigkeit | Mehrere Terminalsitzungen gleichzeitig auf einem Rechner | Ein Daemon-Dienst pro Rechner |
| Direkter Link | Die CLI gibt einen Link zur aktiven Unterhaltung aus | Zugriff über den Gerätewechsler auf antigravity.google.com |
| Am besten geeignet für | Eine aktive Terminalaufgabe verlassen und von einem Smartphone oder Browser aus fortsetzen | Dauerhafter Fernzugriff auf eine Arbeitsstation oder einen Server, solange der Rechner eingeschaltet und mit dem Internet verbunden ist, abhängig von den OS-Bedingungen |
Der interaktive Modus reicht aus, um eine aktuelle Aufgabe von deinem Smartphone aus zu verwalten. Wenn du Fernzugriff ohne geöffnetes Terminal brauchst, verwende den Headless-Daemon, abhängig von den Bedingungen deines OS.
Diagramm: Der Sitzungstunnel verschwindet, wenn das Terminal geschlossen wird; der Hintergrund-Daemon läuft ohne geöffnetes Terminal
Unterschied zwischen den CLI-Modi: Der interaktive Tunnel läuft nur, solange das Terminal geöffnet ist; der Headless-Daemon läuft ohne geöffnetes Terminal (abhängig von den OS-Bedingungen in der Tabelle oben).
## Was du bei Verbindungsproblemen tun kannst
Probleme und Lösungen aus der offiziellen Dokumentation:
| Was du siehst | Warum | Was du tun kannst |
|----|----|----|
| `Remote control is not enabled for your account` | Remote Control wurde für dein Konto oder durch die Organisationsrichtlinien nicht aktiviert | Wende dich an den Administrator deines Arbeitsbereichs oder prüfe, ob dein Tarif Remote Control unterstützt |
| Der Eintrag verschwindet aus dem Dashboard (CLI) | `/remote-control` und `agy --remote-control` erstellen Tunnel, die automatisch getrennt werden, wenn du die interaktive Sitzung beendest (`/exit`, `Ctrl+C`) oder `/remote-control off` ausführst | Wenn der Rechner ohne geöffnetes Terminal verfügbar bleiben soll, installiere den Headless-Daemon mit `agy remote-control start` |
| Im Dashboard erscheinen mehrere CLI-Einträge desselben Rechners | Jede interaktive CLI-Sitzung hat einen eigenen Hostnamen; das ist normal, wenn mehrere Terminals geöffnet sind | Es ist nichts zu tun; dieses Verhalten ist normal |
| Der Rechner erscheint nicht im Dashboard (Daemon) | Möglicherweise gibt es ein Problem mit der Anmeldung bei der CLI | Führe `agy remote-control status` aus; wenn ein Anmeldeproblem gemeldet wird, führe `agy` aus, melde dich erneut an und führe dann nochmals `agy remote-control start` aus |
| Die Umbenennung wurde nicht übernommen | Der Name wird beim Start des Daemons ausgelesen | Führe `agy remote-control start` erneut aus, um den Daemon neu zu starten |
| Unter Windows startet der Daemon nur bei der Anmeldung, nicht beim Systemstart | Der Befehl `start` wurde ohne Administratorrechte ausgeführt | Führe `agy remote-control start` erneut in einem Fenster mit erhöhten Rechten aus |
| Die Verbindung bricht immer wieder ab und wird neu hergestellt | Möglicherweise ist noch ein alter Daemon registriert, der über das Installationsskript eingerichtet wurde und mit dem neuen um die Verbindung konkurriert | Führe `agy remote-control start` erneut aus; der alte Dienst wird automatisch entfernt |
| Im Dashboard erscheinen zwei ähnliche Einträge für einen Rechner | Ein Eintrag gehört zum Editor, der andere zum CLI-Daemon; sie sind absichtlich getrennt | Benenne den Eintrag um, den du unterscheiden möchtest |
| Der Rechner erscheint nicht im Web-Dashboard (Desktop) | Möglicherweise ist der Schalter ausgeschaltet, es besteht keine Internetverbindung, der Computer befindet sich im Ruhezustand oder es werden unterschiedliche Google-Konten verwendet | Prüfe den Schalter **Enable Remote Control**, die Internetverbindung des Computers, dass er nicht im Ruhezustand ist, und ob auf beiden Seiten dasselbe Konto verwendet wird |
Für eine ausführlichere Diagnose kannst du die Daemon-Protokolle prüfen: Führe unter Linux `journalctl --user -u antigravity-cli-daemon -n 50` aus; prüfe unter macOS `~/Library/Logs/antigravity-cli-daemon.log`; und prüfe unter Windows die neueste `cli-*.log`-Datei in `%USERPROFILE%\.gemini\antigravity-cli\log`.
Der Headless-Daemon ermöglicht den Zugriff ohne geöffnetes Terminal, auch wenn du nicht am Rechner bist, abhängig von den Betriebsbedingungen des Computers und des OS. Wenn du keinen dauerhaften Zugriff mehr brauchst, stoppe den Daemon mit `agy remote-control stop`.
Es gibt einen separaten Artikel über [Remote Control in Claude Code](https://ailoot.ai/blog/de/claude-code-remote-control-phone/). Wenn du einen anderen Agenten über Telegram steuern möchtest, findest du weitere Informationen unter [Hermes Agent in Telegram einrichten](https://ailoot.ai/blog/de/hermes-agent-telegram-setup/).
## Wie geht es weiter?
Wenn du in der CLI arbeitest und dich von der aktuellen Aufgabe entfernen möchtest, beginne mit dem interaktiven Modus. Lass das Terminal geöffnet: Wenn du es schließt, wird der Tunnel getrennt und der Sitzungseintrag verschwindet aus dem Dashboard. Für den Zugriff auf den Rechner ohne geöffnetes Terminal verwendest du den Daemon, abhängig von den Einschränkungen deines OS.
### Quellen
- [Antigravity Remote Control: offizielle Dokumentation](https://antigravity.google/docs/remote-control.md)
- [Antigravity Features: Überblick über die Funktionen von 2.0](https://antigravity.google/docs/features.md)
- [Antigravity Getting Started: CLI-Installation](https://antigravity.google/docs/getting-started.md)
Weitere Materialien findest du auf [Ailoot](https://ailoot.ai/).
## Fragen und Antworten
### Warum verschwindet die Fernsitzung beim Schließen des Terminals?
Interactive Remote Control gehört zum laufenden agy-Prozess. Dessen Ende schließt den Tunnel. Nutze für Zugriff ohne offenes Terminal den Headless-Daemon und prüfe seine Startbedingungen unter deinem Betriebssystem.
### Was prüfe ich, wenn mein Rechner im Dashboard fehlt?
Prüfe, ob er wach und online ist, Remote Control aktiviert ist und der Browser dasselbe Google-Konto wie Desktop oder CLI verwendet. Prüfe bei einer Daemon-Sitzung mit agy remote-control status Anmeldung und Dienstzustand.
## Ailoot · Das Unternehmen und sein Projektportfolio
Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.
Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.
Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.