Agent kann keine Verbindung herstellen
- Überprüfe deine Internetverbindung
- Überprüfe, ob das Relay erreichbar ist:
curl https://coding.btelo.com/ping - Überprüfe, ob eine Firewall ausgehende WebSocket-Verbindungen blockiert (Port 443)
iOS-App findet den Agenten nicht
- Stelle sicher, dass der Agent läuft — die Desktop-App ist geöffnet, oder der CLI-Agent zeigt Cloud: running an.
- Der QR-Code / Verbindungslink kann abgelaufen sein — aktualisiere ihn (öffne das Connect-Panel in der Desktop-App erneut oder drücke r im CLI-TUI) und scanne erneut.
- Wenn du den Connector neu konfiguriert hast, koppele erneut, indem du den neuen QR-Code scannst.
Kein AI-Anbieter gefunden
Installiere mindestens einen Anbieter auf der Agenten-Maschine:
npm install -g @anthropic-ai/claude-code
Stelle sicher, dass die CLI in deinem PATH ist — führe claude --version aus, um dies zu überprüfen. In der Desktop-App verwende Einstellungen → Einrichtungsanleitung → Erneut prüfen, um Anbieter neu zu erkennen. Oder wähle den integrierten Btelo Agent mit deinem eigenen DeepSeek- / MiniMax-Schlüssel.
Port-Konflikt
Der Agent verwendet standardmäßig Port 24385. Wenn er belegt ist, wählt er automatisch einen zufälligen Port. Einen benutzerdefinierten Port für den CLI-Agenten festlegen:
PORT=8080 vibe-remote
Auf die neueste Version zwangsaktualisieren
Desktop-App: öffne Einstellungen → Nach Updates suchen, dann Neu starten & aktualisieren. Wenn sie noch feststeckt, lade das neueste Paket von der Download-Seite herunter und installiere es über die vorhandene App.
CLI-Agent: wenn er auf einer alten Version feststeckt oder das automatische Update nicht angewendet wurde, führe den Installationsbefehl erneut aus, um die neueste Version zu holen:
Linux / macOS
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows (PowerShell)
irm https://coding.btelo.com/install.ps1 | iex
Nach Abschluss den Agenten neu starten, damit die neue Binärdatei geladen wird.
Logs
In der Desktop-App sind Logs über das App-Fenster verfügbar. Für den CLI-Agenten erscheinen Logs im TUI-Viewport (oder an stdout im Headless-Modus). Logdateien werden in ~/.vibe-remote/logs/ gespeichert.
Hilfe erhalten
Reiche ein Issue ein unter github.com/btelolabs/btelo-coding-release/issues.