FAQ
Produktversion
Wie ist das Verhältnis zwischen Kimi WebBridge und Kimi Browsererweiterung?
Kimi WebBridge wurde in Kimi Browsererweiterung umbenannt und bietet neue Funktionen, darunter einen Einstieg über die Browser-Seitenleiste, das Aufzeichnen von Webvorgängen und das Zerlegen von Webseiten in Anweisungen. Die Art und Weise, wie Local Agents die Erweiterung aufrufen, bleibt unverändert und kann weiterhin genutzt werden; der neue Einstieg über die Seitenleiste erfordert die Anmeldung mit Ihrem Kimi-Konto.
Die Seitenleiste verwenden
Wird der Verlauf mit kimi.com und Kimi Desktop synchronisiert?
Nein. Der Verlauf der Seitenleiste wird nur im aktuellen Browser gespeichert; jedes Konto behält standardmäßig die 10 neuesten Chats. Zum dauerhaften Speichern klicke unter einer Antwort auf „Export“, um den Inhalt als Markdown-Datei (.md) zu speichern.
Installation und Konfiguration
Welche Browser werden unterstützt?
Derzeit werden Chrome und Edge unterstützt. Für das beste Erlebnis empfehlen wir die Verwendung der neuesten Version.
Beim Installieren der Erweiterung erscheint „Cannot add apps from this website“?
Bitte installieren Sie unbedingt über den offiziellen Web Store (Chrome Web Store oder Edge Add-ons). Falls Sie auf den Web Store nicht zugreifen können, nutzen Sie die manuelle Installationsmethode, die auf der offiziellen Website angeboten wird.
Unter Windows schlägt die Installation von Kimi Browsererweiterung mit dem Fehler „Installation failed“ fehl
Kimi Browsererweiterung unterstützt das Betriebssystem Windows, und der Installationsbefehl kann in PowerShell ausgeführt werden:
Nach der Installation zeigt Kimi Browsererweiterung eine Chrome-Kompatibilitätswarnung an. Was bedeutet das?
Wenn Kimi Browsererweiterung Seiten zwar normal öffnen kann, Aktionen wie snapshot, evaluate, screenshot oder click jedoch immer wieder fehlschlagen, liegt die häufigere Ursache in einem Konflikt mit anderen Browser-Erweiterungen.
Besonders häufig tritt dies bei Scraping-Tools, Website-Hilfserweiterungen, Bildschirmaufnahme-Erweiterungen und KI-Assistenten-Erweiterungen auf.
Wir empfehlen folgende Schritte zur Fehlersuche:
- Öffnen Sie die Verwaltungsseite für Erweiterungen Ihres Browsers
- Deaktivieren Sie andere Erweiterungen vorübergehend
- Lassen Sie nur Kimi Browsererweiterung aktiviert
- Starten Sie den Browser neu und versuchen Sie es erneut
- Wenn Kimi Browsererweiterung normal funktioniert, aktivieren Sie die anderen Erweiterungen nacheinander wieder, um die konfliktverursachende Erweiterung zu ermitteln
Nach Ausführen des Verbindungsbefehls passiert nichts?
Bitte überprüfen Sie Ihre Internetverbindung. Falls das Problem weiterhin besteht, starten Sie Kimi Claw Desktop neu und führen Sie den Befehl erneut aus.
Kann ich es auf mehreren Computern verwenden?
Ja, aber jeder Computer muss separat installiert und konfiguriert werden.
Ich kann Kimi Claw Desktop nicht finden?
Kimi Claw Desktop ist ein Kimi Claw, der auf Ihrem lokalen Computer bereitgestellt wird. Öffnen Sie Kimi Desktop, suchen Sie Kimi Claw in der linken Seitenleiste, erstellen Sie einen neuen Claw und wählen Sie „Auf meinem Computer bereitstellen“.
Verbindung und Nutzung
Wie prüfe ich den Verbindungsstatus? Was tun, wenn mein lokaler Agent den Browser nicht nutzen kann?
- Öffne in der Browser-Seitenleiste „Settings“ → „Local agent remote control“ und prüfe „Connection“: Wird „Not connected“ angezeigt, klicke auf „Connect“, um es erneut zu versuchen.
- In Kimi Work kannst du den Status von „Dienst verbinden“ unter „Einstellungen“ → „Automatisierung“ → „Browser use“ prüfen und auf „Verbinden“ klicken, um es erneut zu versuchen.
Hinweis: Wenn sich die Seitenleiste öffnen lässt, bedeutet das nicht, dass die Verbindung des lokalen Agents eingerichtet ist.
Wenn Kimi Work oder ein anderer lokaler Agent den Browser nicht aufrufen kann, prüfe zunächst den ursprünglichen Fehler, den das Tool zurückgibt. Häufige Felder oder Fragmente entsprechen unterschiedlichen Prüfrichtungen:
| Fehlerfeld oder Meldung | Bedeutung und Prüfung |
|---|---|
error.code ist extension_not_connected | Der lokale Dienst hat die Anfrage erhalten, aber die Erweiterung ist nicht verbunden. Prüfe Browser und Erweiterung in Schritt 1 sowie die Adresse in Schritt 4 |
Connection refused oder Failed to connect beim Zugriff auf die lokale Dienstadresse | Der lokale Dienst wurde nicht erreicht. Prüfe Installation und Start in Schritt 2 und 3 sowie die Adresse in Schritt 4 |
Beim Start erscheinen daemon did not come up und Port … is most likely held by another program | Der Dienst konnte nicht starten, möglicherweise wegen eines belegten Ports. Prüfe Schritt 5 und die zugehörigen Protokolle |
Gehe diese Prüfungen der Reihe nach durch:
1. Ist der Browser geöffnet und die Erweiterung aktiviert?
Öffne Chrome oder Edge mit installierter Kimi Browsererweiterung und prüfe auf der Erweiterungsseite, ob sie aktiviert ist. Klicke anschließend in Kimi Work auf „Verbinden“ oder in den Erweiterungseinstellungen auf „Connect“.
2. Ist nur die Browsererweiterung installiert, der lokale Agent aber noch nicht eingerichtet?
Du benötigst sowohl die Browsererweiterung als auch die Verbindungskomponenten für den lokalen Agent. Installiere in Kimi Work das Plugin Kimi Browser Extension aus dem Plugin-Marktplatz und folge den Anweisungen zur Installation und Verbindung.
Bei einem anderen lokalen Agent oder einem noch nicht eingerichteten lokalen Dienst klicke in den Erweiterungseinstellungen auf „Connect“ und sende dem Agent die Installationsanweisung aus dem Dialog. Alternativ kopiere die folgende Anweisung für dein Betriebssystem:
macOS oder Linux
Windows
Prüfe, ob Installation und Dienststart erfolgreich waren, und kontrolliere danach erneut „Connection“.
3. Läuft der installierte lokale Dienst tatsächlich?
Eine abgeschlossene Installation bedeutet nicht, dass der Dienst dauerhaft läuft. Klicke in Kimi Work zunächst auf „Verbinden“ in den oben genannten Einstellungen. Bei anderen lokalen Agents bitte den Agent, den lokalen Dienst der Kimi Browsererweiterung zu prüfen und gegebenenfalls zu starten. Klicke danach in den Erweiterungseinstellungen auf „Connect“. Scheitert der Start, prüfe auf einen Portkonflikt.
4. Stimmen die Adressen von Erweiterung und lokalem Dienst überein?
Prüfe in der Erweiterung „Settings“ → „Local agent remote control“ → „Connection address“. Der Standard lautet ws://127.0.0.1:10086/ws. Wurde der Dienstport geändert, muss die Erweiterung denselben Port verwenden. Eine einseitige Änderung verhindert die Verbindung.
5. Nennt der Fehler einen möglichen Portkonflikt?
Bei Port … is most likely held by another program bitte den lokalen Agent, den genannten Port, das belegende Programm und die beigefügten Protokolle zu prüfen. Die Meldung weist nur auf eine mögliche Ursache hin. Ist der Konflikt bestätigt, folge der Anleitung unten.
Falls die Verbindung weiterhin scheitert, sende über „Settings“ → „Feedback“ in der Erweiterung die Versionen von Kimi Work bzw. deinem lokalen Agent, Browser und Erweiterung, einen Screenshot des Verbindungsstatus, den vollständigen Fehler und die bereits versuchten Schritte.
Was tun, wenn der Port belegt ist? Wie ändere ich den Verbindungsport?
Der lokale Verbindungsdienst verwendet standardmäßig Port 10086. Ermittle zuerst das Programm, das den Port belegt. Kannst du es schließen, beende es und versuche die Verbindung erneut. Muss es weiterlaufen, ändere den Port mit den folgenden Schritten.
Kimi Work 3.2.18 und andere lokale Agents können dieselben Schritte zum Portwechsel verwenden. Aktualisiere ältere Work-Versionen zuerst auf 3.2.18 oder neuer. Der lokale Dienst der Kimi Browsererweiterung muss mindestens v2.0.22 sein.
Du kannst den Port des lokalen Dienstes und der Browsererweiterung gemeinsam ändern. Das Beispiel verwendet 12086; lass den lokalen Agent zunächst prüfen, ob dieser Port frei ist. Warte, bis laufende Browseraufgaben beendet sind, da ein Neustart die aktuelle Verbindung unterbricht.
1. Bearbeite die Konfiguration des lokalen Dienstes.
Öffne die folgende Datei oder erstelle sie, falls sie fehlt. Behalte bestehende Felder bei und ändere nur addr. Prüfe bei einem Konfigurationsfehler die JSON-Syntax und ob addr dem folgenden Adressformat entspricht. Korrigiere den Fehler und versuche es erneut:
- macOS / Linux:
~/.kimi-webbridge/config.json - Windows:
%USERPROFILE%\.kimi-webbridge\config.json
2. Starte den lokalen Dienst neu und prüfe seinen Status.
Führe die Befehle für dein Betriebssystem aus oder bitte deinen lokalen Agent darum:
Prüfe, ob running: true und port gleich 12086 sind. Wird noch der alte Port angezeigt oder schlägt der Start fehl, behebe zuerst den Dienstfehler. Work verwendet einen gesunden laufenden Dienst weiter. Das Speichern der Konfiguration oder erneutes Öffnen von Work verschiebt ihn nicht automatisch auf den neuen Port.
3. Ändere die Verbindungsadresse der Erweiterung.
Öffne in der Seitenleiste „Settings“ → „Local agent remote control“ → „Connection address“, trage ws://127.0.0.1:12086/ws ein und klicke auf „Test“. Nach erfolgreichem Test klicke auf „Save“. Prüfe anschließend, ob unter „Connection“ der Status „Connected“ erscheint.
4. Lass deinen lokalen Agent die neue Adresse verwenden.
Öffne Kimi Work nach den obigen Schritten erneut und klicke unter „Einstellungen“ → „Automatisierung“ → „Browser use“ auf „Verbinden“. Teile anderen lokalen Agents mit, dass der Dienst jetzt 127.0.0.1:12086 verwendet und sie den von status gemeldeten tatsächlichen Port nutzen sollen. extension_connected: true bedeutet, dass die Erweiterung verbunden ist. Bei false prüfe, ob der Browser geöffnet, die Erweiterung aktiviert und die Adresse mit Schritt 3 identisch ist.
Zum Zurücksetzen ändere addr auf 127.0.0.1:10086, starte den Dienst neu und klicke auf der Seite „Connection address“ auf „Reset to default“. Prüfe vorher, ob kein anderes Programm 10086 belegt.
Gibt Kimi Browsererweiterung meine Anmeldedaten preis?
Nein. Sämtliche Ausführung erfolgt lokal auf Ihrem Gerät – Anmeldestatus und Seiteninhalte verlassen Ihren Rechner nie. Der Agent kann nur auf die von Ihnen autorisierten Ergebnisse der Operationen zugreifen.
Warum schlagen Operationen fehl?
Komplexe Seitenstrukturen oder dynamisches Laden können dazu führen, dass Operationen fehlschlagen. Vereinfachen Sie Ihre Anweisungen oder bitten Sie den Agent, zunächst einen Screenshot zu erstellen, um den Seitenzustand vor der Ausführung zu bestätigen.
Zusammenarbeit mit anderen Agents
Welche anderen Agents werden unterstützt?
Kimi Browsererweiterung unterstützt alle Local Agents, darunter Claude Code, Codex, Cursor, Kimi Code, Hermes Claw und weitere.
Ist die Konfiguration für verschiedene Agents identisch?
Der Einrichtungsbefehl ist für alle gleich – führen Sie einen einzigen curl-Befehl aus, um zu installieren. Einzelheiten finden Sie in der Skill-Konfiguration des jeweiligen Agents.
War dieser Artikel hilfreich?