Grok

Der Grok-Provider steuert die Grok CLI auf dem Rechner des Relays. Es gibt keinen API-Key, den du in OAR eingibst: Grok verwendet das Konto, bei dem die CLI angemeldet ist, und du kannst die CLI aus dem Browser installieren und dich dort anmelden.

Grok hat keine Rückfrage-Karten, kein Nachsteuern und keinen Plan-Modus, den OAR durchsetzen kann. Die Tabelle aller Provider steht unter Provider im Überblick.

Was du brauchst #

• Die Grok CLI (grok) auf dem Rechner, auf dem das Relay läuft. OAR kann sie für dich installieren (siehe Die Zeile Grok CLI).
• Ein Grok-Konto, auf diesem Rechner angemeldet. Du kannst dich aus dem Browser anmelden (siehe Anmelden) oder grok login auf dem Rechner ausführen. Das Relay speichert kein Grok-Geheimnis: Die CLI hält die Anmeldung in ~/.grok/auth.json.

Die Zeile Grok CLI sucht grok im PATH des Relays, dann in ~/.grok/bin, ~/.local/bin und /usr/local/bin. Sessions, Anmeldung und Modellerkennung starten grok aus dem PATH, oder die Binary, die in GROK_CLI_COMMAND genannt ist (siehe Umgebungsvariablen).

Die Zeile Grok CLI #

Oben in Settings → Providers → Grok (Einstellungen → Provider → Grok) zeigt eine Zeile Grok CLI, ob die CLI installiert ist. Ist sie es, zeigt die Zeile die Version, wo sie liegt, wie sie installiert wurde und ob sie aktuell ist, z. B. 1.0.13 · ~/.grok/bin/grok · native · up to date, oder update available (…), wenn es eine neuere Version gibt. Ihre Buttons hängen vom Zustand ab:

Die Ausgabe läuft als Install log (Installationslog) ins Panel, auch auf anderen Geräten. Auf dem Relay läuft immer nur eine Installation, und eine, die länger als 10 Minuten läuft, wird gestoppt. Die Befehle sind im Relay fest vorgegeben und laufen nie mit sudo. Nach einer Installation oder einem Update verwenden neue Sessions sofort die neue Binary, und das Relay merkt sie sich über Neustarts hinweg; laufende Sessions behalten die, mit der sie gestartet sind. Siehe auch Die CLI eines Providers installieren oder aktualisieren.

Einschalten #

Grok ist standardmäßig aus. Öffne Settings → Providers → Grok. Unter Grok:

Eine Zeile unter den Elementen sagt, in welchem Zustand Grok ist. Grok auszuschalten lässt Konversationen, die noch keine Nachricht gesendet haben, zurück zu Copilot wechseln. Konversationen, die schon begonnen haben, behalten Grok. Siehe Eine Konversation starten.

Weiter unten im selben Panel steht Grok monthly plan allowance (Monatliches Grok-Plankontingent) (siehe Verbrauch).

Anmelden #

Unter der CLI-Zeile nennt die Kontozeile den Zustand des Kontos. Angemeldet zeigt sie, was die Abrechnungsinformationen der CLI hergeben, z. B. 70% of weekly quota used, mit einem Produktnamen davor, wenn es genau einen gibt. Abgemeldet zeigt sie Not signed in. Ein abgelaufenes Token zeigt token expired, may need a new sign-in; die CLI erneuert es normalerweise selbst. Die Zeile erkennt nur eine Anmeldung, die mit der CLI gemacht wurde.

Anmelden #

1. Drück Sign in (Anmelden). Das Relay führt grok login --device-auth auf seinem Rechner aus.
2. Das Panel sagt Starting the Grok sign-in on the relay host… und zeigt dann den x.ai-Anmeldelink mit einem Button Copy link (Link kopieren) und daneben den Code in der Form XXXX-XXXX.
3. Öffne den Link auf einem beliebigen Gerät, z. B. einem Handy, und bestätige im Browser. Prüf, dass der Code, den der Browser zeigt, der aus dem Panel ist. Der Code ist schon Teil des Links, du tippst also nichts ein.
4. Das Panel wechselt von selbst zu Signed in to Grok., und einen Moment später klappt der Anmeldebereich zu. Nichts wird in OAR zurückkopiert: Die CLI wartet auf x.ai und schließt von allein ab. Eine neue Modellerkennung läuft, du startest das Relay also nicht neu.

Cancel bricht die Anmeldung ab. Eine nicht abgeschlossene Anmeldung endet nach 10 Minuten mit Grok login timed out after 600s. Auf einem Relay läuft immer nur eine, und jeder offene Browser sieht sie, du kannst sie also auf einem Gerät starten und auf einem anderen abschließen. Schlägt sie fehl, zeigt das Panel den Fehler und einen Button Dismiss.

Abmelden #

Sign out (Abmelden) öffnet eine Bestätigung, die das Konto nennt und sagt, wie viele Grok-Worker laufen. Bestätige mit Sign out. Neue Grok-Turns schlagen dann fehl, bis du dich wieder anmeldest. Der Button ist deaktiviert, während eine Anmeldung läuft oder wenn kein Konto angemeldet ist.

Laufende Grok-Sessions behalten das vorherige Konto, bis ihr Worker-Prozess endet. Neue Sessions verwenden das neue Konto.

Bei einer fehlgeschlagenen Antwort #

Schlägt ein Turn fehl, weil die CLI fehlt oder nicht angemeldet ist, trägt die fehlgeschlagene Antwort Buttons, die zur Lösung führen:

Sende die Nachricht erneut, sobald Installation oder Anmeldung abgeschlossen sind.

Modelle #

Das Einschalten von Grok findet die Modelle, die die CLI anbietet, und fügt sie den Auswahlen hinzu. Das Relay fragt die CLI, wenn du Grok einschaltest, wenn du die Modell-ID änderst, nach einer Anmeldung und nach einer Installation aus dem Panel. Meldet die CLI keine, werden nur grok-4.5 und deine Modell-ID angeboten. In Select Models (Modelle auswählen) legt der Tab Grok fest, welche davon im Eingabebereich erscheinen, gespeichert mit 💾 Save enabled models (Aktivierte Modelle speichern); das Standardmodell bleibt immer aktiviert.

Das Modell steht fest #

Eine Grok-Konversation behält ein Modell. Das Modell, das du in New Chat wählst, wird der CLI beim Start der Session übergeben, und die CLI kann innerhalb einer Session kein Modell wechseln. Sobald die erste Nachricht gesendet ist, fixiert der Eingabebereich die Auswahl, und das Relay lehnt ein anderes Modell mit Grok model switching requires creating a new Grok conversation ab. Um ein anderes Modell zu verwenden, starte eine andere Konversation. Siehe Eine Konversation starten.

Reasoning-Effort #

Die Auswahl für den Reasoning-Effort bietet none, low, medium und high an, plus alle weiteren Stufen, die die CLI für das Modell meldet. OAR sendet die gewählte Stufe (außer none) mit jeder Nachricht als Hinweis. Ein CLI-Build, der das nicht unterstützt, ignoriert ihn; verlass dich also nicht darauf, dass er die Antwort ändert.

Was funktioniert und was nicht #

• Streaming, Überlegungen und Stop. Die Antwort und die Überlegungen des Agents werden live gestreamt. Stop (Stoppen) bricht den Turn ab.
• Berechtigungen. OAR beantwortet jede Berechtigungsanfrage des Agents mit allow once (einmal erlauben), in jedem Modus. Du wirst nicht gefragt.
• Rückfrage-Karten. Es gibt keine: Das Grok-Protokoll hat keinen Weg, dich zu fragen. Der Agent kann nur in seinem Antworttext fragen und auf deine nächste Nachricht warten. Siehe ask_user.
• Relay-Modi. ask, autopilot und plan erreichen den Agent als Zeile [Relay mode: ...] vor deiner Nachricht, hinzugefügt, wenn sich der Modus ändert. Nichts setzt sie durch. Siehe Relay-Modi.
• Plan-Board. Im Modus plan erscheint ein Board Plan ready for review (Plan bereit zur Prüfung), wenn die letzte Antwort mindestens zwei Zeilen hat, die wie Planschritte aussehen. Es gibt kein Plan-Tool, auf das gewartet wird.
• Kein Nachsteuern. Eine während eines Turns gesendete Nachricht wartet dahinter, und der Senden-Button zeigt Queue (Einreihen). Siehe Turns und die Queue.
• OARs Agent-Tools. Grok bekommt preview und, wenn ein Relay gekoppelt ist oder Agent-Sessions eingeschaltet sind, relay_tool, von einem kleinen MCP-Server, den OAR an jede Grok-Session anhängt. Mit OAR_MCP_SERVER=0 wird der Server nicht angehängt: Es gibt kein relay_tool, und der Agent bekommt gesagt, wie er stattdessen die Preview-API aufruft. Siehe Agent-Tools → Nach Provider. Eine Grok-Konversation kann auch von einem anderen Agent beobachtet werden.
• Anhänge. Dateien erreichen den Agent als Zeile [Attached file: <path>] nach deinem Text, nicht als Inhalt. Der Agent muss die Datei selbst lesen.
• Subagents. Ein Task- oder Agent-Tool-Aufruf von Grok erscheint als Subagent-Chip mit seinem Zustand. Der verschachtelte Text eines Subagents wird nicht aufgezeichnet.
• Hintergrund-Tasks. Neu in 0.9.12 Die Task-Leiste listet jedes Terminal, das der Agent öffnet und das länger als zwei Sekunden läuft, als Zeile Bash mit Stop und einer Konsole seiner Ausgabe. Es verlässt die Leiste, wenn der Agent mit dem Terminal fertig ist oder der Befehl endet. Background task timeout (Timeout für Hintergrund-Tasks) gilt nicht für Grok.
• Kontext. Der 🧠-Button zeigt die Tokens des letzten Turns (Eingabe, Cache, Ausgabe). Er fügt einen Prozentsatz des Fensters hinzu, wenn die Fenstergröße des Modells bekannt ist. Es gibt keine Kategorien.
• Kompaktierung. OAR setzt und zeigt keine automatische Kompaktierung und hat keine Fenster-Einstellung für Grok. Siehe Eine Konversation kompaktieren.
• Stille und die Turn-Obergrenze. Ein Turn, der zu lange still ist, schlägt fehl: 120 s, wenn nichts läuft, 300 s während einer Modellanfrage, 30 Minuten, während ein Tool läuft. Die Stille wird nicht gezählt, während der Agent auf einen relay_tool-Aufruf wartet oder auf einen Befehl, den das Relay für ihn ausführt und der in den letzten 5 Minuten etwas ausgegeben hat. Der Turn ist außerdem durch Max turn duration (Maximale Turn-Dauer) begrenzt, gezählt ab dem Start des Prompts, und ein Grok-Turn, der sie erreicht, schlägt fehl, statt in die Queue zurückzukehren. Die Stillefenster, wie du sie änderst, und die Obergrenze stehen unter Turns und die Queue.
• Nach einem Neustart. Das Relay speichert die Grok-Session-ID und lädt diese Session, wenn der Worker wieder startet. Kann die CLI sie nicht laden, sagt eine Notiz das, und der Turn startet eine frische Session ohne den früheren Kontext. Siehe Neustarts und Fortsetzen.
• Verbrauch. Grok-Antworten haben keine Verbrauchszeile; siehe Verbrauch.

Verbrauch #

📊 Check Usage (Verbrauch prüfen) hat eine Grok-Karte, solange Grok eingeschaltet ist. Sie zeigt:

• Weekly plan usage (Wöchentlicher Plan-Verbrauch), einen Live-Prozentbalken mit dem Rücksetzdatum, gelesen mit der Anmeldung der CLI. Ohne CLI-Anmeldung fehlt der Balken, und die Karte zeigt die Schätzungen unten.
• Latest turn (Letzter Turn): die Kosten (eine Schätzung), das Modell, Tokens für Eingabe, Ausgabe, Cache und Reasoning, die in der API verbrachte Zeit und die Zahl der Agent-Turns, sowie eine Aufschlüsselung By model (last turn) (Nach Modell, letzter Turn).
• Current cycle (local) (Aktueller Zyklus, lokal): geschätzte Ausgaben, erfasste Turns und Tokens seit dem letzten Abrechnungs-Reset, summiert aus den Grok-Turns auf diesem Relay.

Die Karte verlinkt auf die xAI-Konsole. Die Kosten kommen aus dem eigenen Bericht des Agents und sind als Schätzungen gekennzeichnet.

Monatliches Kontingent #

Grok meldet OAR kein verbleibendes Guthaben, daher kann OAR seine eigene Schätzung mit einem Budget vergleichen, das du ihm gibst. Unter Grok monthly plan allowance:

Umgebungsvariablen #

Setz diese in der Umgebung, in der das Relay startet.

Die Stillefenster haben eigene Variablen, aufgeführt unter Turns und die Queue.

XAI_API_KEY wird im Fehlertext der Anmeldung genannt und von der CLI gelesen, aber OAR reicht ihn nicht an Sessions weiter, und die Kontozeile und der Wochenbalken ignorieren ihn. Melde dich stattdessen mit der CLI an.

Grenzen #

• Das Modell steht pro Konversation fest, und ein anderes Konto gilt nur für neue Sessions.
• Die Anmeldung verwendet nur den Gerätecode-Verfahren; die Browser-Callback- und Enterprise-Anmeldungen der CLI werden nicht angeboten.
• Es gibt keinen Button zum Deinstallieren und keine Möglichkeit, eine CLI-Version festzuhalten.

Fehlerbehebung #

Eine fehlgeschlagene Antwort endet mit Error code: relay.<code>.; die Codes unten sind der stabile Teil.