Grok

Le fournisseur Grok pilote la Grok CLI sur la machine du relais. Il n’y a pas de clé d’API à saisir dans OAR : Grok utilise le compte sur lequel la CLI est connectée, et vous pouvez installer la CLI et vous connecter depuis le navigateur.

Grok n’a ni cartes de question, ni pilotage, ni mode plan qu’OAR puisse faire respecter. Le tableau de tous les fournisseurs se trouve dans Les fournisseurs en un coup d’œil.

Ce qu’il vous faut #

• La Grok CLI (grok) sur la machine où tourne le relais. OAR peut l’installer pour vous (voir La ligne de la Grok CLI).
• Un compte Grok, connecté sur cette machine. Vous pouvez vous connecter depuis le navigateur (voir La connexion) ou en lançant grok login sur la machine. Le relais n’enregistre aucun secret Grok : la CLI garde la connexion dans ~/.grok/auth.json.

La ligne Grok CLI cherche grok dans le PATH du relais, puis dans ~/.grok/bin, ~/.local/bin et /usr/local/bin. Les sessions, la connexion et la découverte des modèles lancent grok depuis le PATH, ou le binaire indiqué dans GROK_CLI_COMMAND (voir Variables d’environnement).

La ligne de la Grok CLI #

En haut de Settings → Providers → Grok (Réglages → Fournisseurs → Grok), une ligne Grok CLI indique si la CLI est installée. Si c’est le cas, la ligne affiche la version, son emplacement, la façon dont elle a été installée et si elle est à jour, par exemple 1.0.13 · ~/.grok/bin/grok · native · up to date, ou update available (…) quand une version plus récente existe. Ses boutons dépendent de l’état :

La sortie s’affiche en continu dans le panneau sous Install log (Journal d’installation), y compris sur les autres appareils. Une seule installation tourne à la fois sur le relais, et une installation qui dure plus de 10 minutes est arrêtée. Les commandes sont figées dans le relais et ne tournent jamais avec sudo. Après une installation ou une mise à jour, les nouvelles sessions utilisent aussitôt le nouveau binaire, et le relais s’en souvient d’un redémarrage à l’autre ; les sessions en cours gardent celui avec lequel elles ont démarré. Voir aussi Installer ou mettre à jour la CLI d’un fournisseur.

L’activer #

Grok est désactivé par défaut. Ouvrez Settings → Providers → Grok. Sous Grok :

Une ligne sous les contrôles indique dans quel état se trouve Grok. Désactiver Grok renvoie vers Copilot les conversations qui n’ont pas encore envoyé de message. Les conversations déjà commencées gardent Grok. Voir Démarrer une conversation.

Plus bas dans le même panneau se trouve Grok monthly plan allowance (Allocation mensuelle du forfait Grok) (voir Consommation).

La connexion #

Sous la ligne de la CLI, la ligne du compte indique l’état du compte. Une fois connectée, elle affiche ce que donnent les informations de facturation de la CLI, par exemple 70% of weekly quota used, précédé d’un nom de produit quand il y en a exactement un. Déconnectée, elle affiche Not signed in. Un token arrivé à expiration affiche token expired, may need a new sign-in ; la CLI le renouvelle normalement d’elle-même. La ligne ne reconnaît qu’une connexion faite avec la CLI.

Sign in (Se connecter) #

1. Appuyez sur Sign in. Le relais lance grok login --device-auth sur sa machine.
2. Le panneau indique Starting the Grok sign-in on the relay host…, puis affiche le lien de connexion x.ai avec un bouton Copy link (Copier le lien), et à côté le code, sous la forme XXXX-XXXX.
3. Ouvrez le lien sur n’importe quel appareil, par exemple un téléphone, et confirmez dans le navigateur. Vérifiez que le code affiché par le navigateur est bien celui du panneau. Le code fait déjà partie du lien : vous ne tapez rien.
4. Le panneau passe de lui-même à Signed in to Grok. et, un instant plus tard, la zone de connexion se replie. Rien n’est recollé dans OAR : la CLI attend x.ai et termine d’elle-même. Une nouvelle découverte des modèles est lancée : vous n’avez donc pas à redémarrer le relais.

Cancel abandonne la connexion. Une connexion inachevée prend fin au bout de 10 minutes avec Grok login timed out after 600s. Une seule tourne à la fois sur un relais, et chaque navigateur ouvert la voit : vous pouvez donc la commencer sur un appareil et la terminer sur un autre. En cas d’échec, le panneau affiche l’erreur et un bouton Dismiss.

Sign out (Se déconnecter) #

Sign out ouvre une confirmation qui nomme le compte et indique combien de workers Grok tournent. Confirmez avec Sign out. Les nouveaux turns Grok échouent alors jusqu’à ce que vous vous reconnectiez. Le bouton est désactivé pendant une connexion en cours ou quand aucun compte n’est connecté.

Les sessions Grok en cours gardent l’ancien compte jusqu’à ce que leur processus worker se termine. Les nouvelles sessions utilisent le nouveau compte.

Sur une réponse en échec #

Quand un turn échoue parce que la CLI manque ou n’est pas connectée, la réponse en échec porte des boutons qui mènent à la solution :

Renvoyez le message une fois l’installation ou la connexion terminée.

Modèles #

Activer Grok découvre les modèles que propose la CLI et les ajoute aux sélecteurs. Le relais interroge la CLI quand vous activez Grok, quand vous changez l’ID de modèle, après une connexion et après une installation depuis le panneau. Si la CLI n’en annonce aucun, seuls grok-4.5 et votre ID de modèle sont proposés. Dans Select Models (Sélectionner des modèles), l’onglet Grok choisit lesquels apparaissent dans la zone de saisie, et 💾 Save enabled models (Enregistrer les modèles activés) enregistre ce choix ; le modèle par défaut reste toujours activé.

Le modèle est fixe #

Une conversation Grok garde un seul modèle. Le modèle que vous choisissez dans New Chat est transmis à la CLI au démarrage de la session, et la CLI ne peut pas changer de modèle en cours de session. Une fois le premier message envoyé, la zone de saisie épingle le sélecteur, et le relais refuse un autre modèle avec Grok model switching requires creating a new Grok conversation. Pour utiliser un autre modèle, démarrez une autre conversation. Voir Démarrer une conversation.

Effort de raisonnement #

Le sélecteur d’effort de raisonnement propose none, low, medium et high, plus tout autre niveau que la CLI annonce pour le modèle. OAR envoie le niveau choisi (sauf none) avec chaque message, à titre d’indication. Un build de la CLI qui ne le prend pas en charge l’ignore : ne comptez donc pas sur lui pour changer la réponse.

Ce qui marche et ce qui ne marche pas #

• Streaming, raisonnement et Stop. La réponse et le raisonnement de l’agent s’affichent en direct. Stop (Arrêter) annule le turn.
• Permissions. OAR répond à chaque demande de permission de l’agent par allow once (autoriser une fois), dans tous les modes. On ne vous demande rien.
• Cartes de question. Il n’y en a pas : le protocole de Grok n’a aucun moyen de vous poser une question. L’agent ne peut que demander dans le texte de sa réponse et attendre votre message suivant. Voir ask_user.
• Modes du relais. ask, autopilot et plan parviennent à l’agent sous la forme d’une ligne [Relay mode: ...] devant votre message, ajoutée quand le mode change. Rien ne les fait respecter. Voir Modes du relais.
• Tableau de plan. En mode plan, un tableau Plan ready for review (Plan prêt à relire) apparaît quand la réponse finale contient au moins deux lignes qui ressemblent à des étapes de plan. Il n’y a pas d’outil de plan à attendre.
• Pas de pilotage. Un message envoyé pendant un turn attend derrière lui, et le bouton d’envoi affiche Queue (Mettre en file). Voir Les turns et la queue.
• Les outils d’agent d’OAR. Grok reçoit preview et, quand un relais est associé ou que les sessions d’agent sont activées, relay_tool, d’un petit serveur MCP qu’OAR attache à chaque session Grok. Avec OAR_MCP_SERVER=0, le serveur n’est pas attaché : il n’y a pas de relay_tool, et l’agent apprend à la place comment appeler l’API d’aperçu. Voir Outils d’agent → Par fournisseur. Une conversation Grok peut aussi être surveillée par un autre agent.
• Pièces jointes. Les fichiers parviennent à l’agent sous la forme d’une ligne [Attached file: <path>] après votre texte, pas sous forme de contenu. L’agent doit lire le fichier lui-même.
• Subagents. Un appel d’outil task ou agent de Grok s’affiche comme une puce de subagent avec son état. Le texte imbriqué d’un subagent n’est pas enregistré.
• Tâches de fond. Ajouté en 0.9.12 Le panneau des tâches liste chaque terminal que l’agent ouvre et qui tourne plus de deux secondes, sous forme de ligne Bash avec Stop et une console de sa sortie. La ligne quitte le panneau quand l’agent en a fini avec le terminal ou que la commande se termine. Background task timeout (Délai des tâches de fond) ne s’applique pas à Grok.
• Contexte. Le bouton 🧠 affiche les tokens du dernier turn (entrée, cache, sortie). Il ajoute un pourcentage de la fenêtre quand la taille de la fenêtre du modèle est connue. Il n’y a pas de catégories.
• Compactage. OAR ne règle ni n’affiche de compactage automatique et n’a pas de réglage de fenêtre pour Grok. Voir Compacter une conversation.
• Le silence et le plafond par turn. Un turn qui reste silencieux trop longtemps échoue : 120 s quand rien n’est en cours, 300 s pendant une requête au modèle, 30 min pendant qu’un outil tourne. Le silence n’est pas compté tant que l’agent attend un appel relay_tool, ou une commande que le relais exécute pour lui et qui a affiché quelque chose au cours des 5 dernières minutes. Le turn est aussi plafonné par Max turn duration (Durée maximale d’un turn), compté à partir du début du prompt, et un turn Grok qui l’atteint échoue au lieu de retourner dans la queue. Les fenêtres, comment les changer et le plafond sont décrits dans Les turns et la queue.
• Après un redémarrage. Le relais enregistre l’id de session Grok et charge cette session quand le worker redémarre. Si la CLI ne peut pas la charger, une note le signale et le turn démarre une nouvelle session sans le contexte antérieur. Voir Redémarrages et reprise.
• Consommation. Les réponses Grok n’ont pas de ligne de consommation ; voir Consommation.

Consommation #

📊 Check Usage (Vérifier la consommation) a une carte Grok tant que Grok est activé. Elle affiche :

• Weekly plan usage (Consommation hebdomadaire du forfait), une barre de pourcentage en direct avec la date de réinitialisation, lue avec la connexion de la CLI. Sans connexion CLI, la barre manque et la carte affiche les estimations ci-dessous.
• Latest turn (Dernier turn) : le coût (une estimation), le modèle, les tokens en entrée, en sortie, en cache et de raisonnement, le temps passé dans l’API et le nombre de turns de l’agent, ainsi qu’une ventilation By model (last turn) (Par modèle, dernier turn).
• Current cycle (local) (Cycle en cours, local) : dépenses estimées, turns suivis et tokens depuis la dernière réinitialisation de la facturation, additionnés à partir des turns Grok de ce relais.

La carte renvoie vers la console xAI. Les coûts proviennent du propre rapport de l’agent et sont indiqués comme des estimations.

Allocation mensuelle #

Grok ne communique pas les crédits restants à OAR : OAR peut donc comparer sa propre estimation à un budget que vous lui donnez. Sous Grok monthly plan allowance :

Variables d’environnement #

Définissez-les dans l’environnement dans lequel démarre le relais.

Les fenêtres de silence ont leurs propres variables, listées dans Les turns et la queue.

XAI_API_KEY est nommée dans le texte de l’erreur de connexion et lue par la CLI, mais OAR ne la transmet pas aux sessions, et la ligne du compte comme la barre hebdomadaire l’ignorent. Connectez-vous plutôt avec la CLI.

Limites #

• Le modèle est fixe par conversation, et un autre compte ne s’applique qu’aux nouvelles sessions.
• La connexion utilise uniquement le flux par code d’appareil ; les connexions de la CLI par rappel dans le navigateur et pour entreprise ne sont pas proposées.
• Il n’y a pas de bouton de désinstallation ni de moyen d’épingler une version de la CLI.

Dépannage #

Une réponse en échec se termine par Error code: relay.<code>. ; les codes ci-dessous en sont la partie stable.