Grok

El proveedor Grok controla la CLI de Grok en la máquina del relay. No hay clave de API que introducir en OAR: Grok usa la cuenta con la que la CLI ha iniciado sesión, y puedes instalar la CLI e iniciar sesión desde el navegador.

Grok no tiene tarjetas de pregunta, ni corrección del rumbo, ni un modo plan que OAR pueda hacer cumplir. La tabla de todos los proveedores está en Los proveedores de un vistazo.

Lo que necesitas #

• La CLI de Grok (grok) en la máquina en la que corre el relay. OAR puede instalarla por ti (consulta La fila Grok CLI).
• Una cuenta de Grok, con la sesión iniciada en esa máquina. Puedes iniciar sesión desde el navegador (consulta Iniciar sesión) o ejecutando grok login en la máquina. El relay no guarda ningún secreto de Grok: la CLI guarda el inicio de sesión en ~/.grok/auth.json.

La fila Grok CLI busca grok en el PATH del relay y después en ~/.grok/bin, ~/.local/bin y /usr/local/bin. Las sesiones, el inicio de sesión y la detección de modelos arrancan grok desde el PATH, o el binario indicado en GROK_CLI_COMMAND (consulta Variables de entorno).

La fila Grok CLI #

Arriba del todo en Settings → Providers → Grok (Ajustes → Proveedores → Grok), una fila Grok CLI muestra si la CLI está instalada. Cuando lo está, la fila muestra la versión, dónde está, cómo se instaló y si está al día, por ejemplo 1.0.13 · ~/.grok/bin/grok · native · up to date, o update available (…) cuando hay una versión más nueva. Sus botones dependen del estado:

La salida aparece en el panel como Install log (Registro de instalación), también en otros dispositivos. En el relay solo se ejecuta una instalación a la vez, y una que dura más de 10 minutos se detiene. Los comandos están fijados en el relay y nunca se ejecutan con sudo. Después de una instalación o actualización, las sesiones nuevas usan el binario nuevo de inmediato, y el relay lo recuerda entre reinicios; las sesiones en curso conservan el binario con el que empezaron. Consulta también Instalar o actualizar la CLI de un proveedor.

Activarlo #

Grok está desactivado por defecto. Abre Settings → Providers → Grok. En Grok:

Una línea bajo los controles dice en qué estado está Grok. Desactivar Grok devuelve a Copilot las conversaciones que aún no han enviado ningún mensaje. Las conversaciones que ya han empezado conservan Grok. Consulta Iniciar una conversación.

Más abajo en el mismo panel está Grok monthly plan allowance (Asignación mensual del plan de Grok) (consulta Consumo).

Iniciar sesión #

Debajo de la fila de la CLI, la fila de la cuenta indica el estado de la cuenta. Con la sesión iniciada, muestra lo que da la información de facturación de la CLI, por ejemplo 70% of weekly quota used, con un nombre de producto delante cuando hay exactamente uno. Sin sesión, dice Not signed in. Un token caducado muestra token expired, may need a new sign-in; la CLI normalmente lo renueva por su cuenta. La fila solo reconoce un inicio de sesión hecho con la CLI.

Iniciar sesión #

1. Pulsa Sign in (Iniciar sesión). El relay ejecuta grok login --device-auth en su máquina.
2. El panel dice Starting the Grok sign-in on the relay host… y luego muestra el enlace de inicio de sesión de x.ai con un botón Copy link (Copiar enlace), y a su lado el código con la forma XXXX-XXXX.
3. Abre el enlace en cualquier dispositivo, por ejemplo un teléfono, y confirma en el navegador. Comprueba que el código que muestra el navegador es el del panel. El código ya forma parte del enlace, así que no escribes nada.
4. El panel cambia por sí solo a Signed in to Grok. y, un momento después, la zona de inicio de sesión se pliega. No se pega nada de vuelta en OAR: la CLI espera a x.ai y termina por su cuenta. Se ejecuta una nueva detección de modelos, así que no hace falta reiniciar el relay.

Cancel abandona el inicio de sesión. Un inicio de sesión sin terminar acaba a los 10 minutos con Grok login timed out after 600s. En un relay solo se ejecuta uno a la vez, y todos los navegadores abiertos lo ven, así que puedes empezarlo en un dispositivo y terminarlo en otro. Si falla, el panel muestra el error y un botón Dismiss.

Cerrar sesión #

Sign out (Cerrar sesión) abre una confirmación que nombra la cuenta y dice cuántos workers de Grok están en marcha. Confirma con Sign out. A partir de ahí, los turns nuevos de Grok fallan hasta que vuelvas a iniciar sesión. El botón está desactivado mientras hay un inicio de sesión en curso o cuando no hay ninguna cuenta con la sesión iniciada.

Las sesiones de Grok en curso conservan la cuenta anterior hasta que termina el proceso de su worker. Las sesiones nuevas usan la cuenta nueva.

En una respuesta de error #

Cuando un turn falla porque falta la CLI o no ha iniciado sesión, la respuesta de error lleva botones que llevan a la solución:

Vuelve a enviar el mensaje cuando haya terminado la instalación o el inicio de sesión.

Modelos #

Al activar Grok se detectan los modelos que ofrece la CLI y se añaden a los selectores. El relay pregunta a la CLI cuando activas Grok, cuando cambias el ID de modelo, después de un inicio de sesión y después de una instalación desde el panel. Si la CLI no informa de ninguno, solo se ofrecen grok-4.5 y tu ID de modelo. En Select Models (Seleccionar modelos), la pestaña Grok elige cuáles de ellos aparecen en el área de redacción; luego pulsa 💾 Save enabled models (Guardar los modelos activados). El modelo predeterminado siempre queda activado.

El modelo es fijo #

Una conversación de Grok conserva un solo modelo. El modelo que eliges en New Chat se pasa a la CLI cuando arranca la sesión, y la CLI no puede cambiar de modelo dentro de una sesión. Una vez enviado el primer mensaje, el área de redacción fija el selector, y el relay rechaza otro modelo con Grok model switching requires creating a new Grok conversation. Para usar otro modelo, inicia otra conversación. Consulta Iniciar una conversación.

Reasoning effort #

El selector de reasoning effort ofrece none, low, medium y high, más cualquier otro nivel que la CLI informe para el modelo. OAR envía el nivel elegido (salvo none) con cada mensaje como sugerencia. Una compilación de la CLI que no lo admite lo ignora, así que no cuentes con él para cambiar la respuesta.

Qué funciona y qué no #

• Streaming, pensamientos y Stop. La respuesta y los pensamientos del agente se transmiten en vivo. Stop (Detener) cancela el turn.
• Permisos. OAR responde a todas las solicitudes de permiso del agente con allow once (permitir una vez), en todos los modos. No se te pregunta.
• Tarjetas de pregunta. No hay: el protocolo de Grok no tiene forma de preguntarte. El agente solo puede preguntar en el texto de su respuesta y esperar tu siguiente mensaje. Consulta ask_user.
• Modos del relay. ask, autopilot y plan llegan al agente como una línea [Relay mode: ...] delante de tu mensaje, añadida cuando cambia el modo. Nada los hace cumplir. Consulta Modos del relay.
• Tablero del plan. En el modo plan, un tablero Plan ready for review (Plan listo para revisar) aparece cuando la respuesta final tiene al menos dos líneas que parecen pasos de un plan. No hay herramienta de plan a la que esperar.
• Sin corrección del rumbo. Un mensaje enviado durante un turn espera detrás de él, y el botón de enviar dice Queue (Poner en cola). Consulta Los turns y la queue.
• Las herramientas de agente de OAR. Grok recibe preview y, cuando hay un relay emparejado o las sesiones de agente están activadas, relay_tool, de un pequeño servidor MCP que OAR conecta a cada sesión de Grok. Con OAR_MCP_SERVER=0 el servidor no se conecta: no hay relay_tool, y en su lugar se le indica al agente cómo llamar a la API de vistas previas. Consulta Herramientas de agente → Por proveedor. Otro agente también puede vigilar una conversación de Grok.
• Adjuntos. Los archivos llegan al agente como una línea [Attached file: <path>] después de tu texto, no como contenido. El agente tiene que leer el archivo por su cuenta.
• Subagents. Una llamada a la herramienta task o agent de Grok aparece como un chip de subagent con su estado. El texto anidado de un subagent no se registra.
• Tareas en segundo plano. Nuevo en 0.9.12 El panel de tareas lista todas las terminales que abre el agente y que corren más de dos segundos, como una fila Bash con Stop y una consola con su salida. Sale del panel cuando el agente termina con la terminal o el comando acaba. Background task timeout (Tiempo límite de las tareas en segundo plano) no se aplica a Grok.
• Contexto. El botón 🧠 muestra los tokens del último turn (entrada, caché, salida). Añade un porcentaje de la ventana cuando se conoce el tamaño de la ventana del modelo. No hay categorías.
• Compactación. OAR no fija ni muestra ninguna compactación automática y no tiene ajuste de ventana para Grok. Consulta Compactar una conversación.
• El silencio y el tope por turn. Un turn que pasa demasiado tiempo en silencio falla: 120 s sin nada en curso, 300 s durante una petición al modelo, 30 min mientras corre una herramienta. El silencio no cuenta mientras el agente espera una llamada a relay_tool, ni un comando que el relay ejecuta por él y que ha impreso algo en los últimos 5 minutos. El turn también está limitado por Max turn duration (Duración máxima del turn), contada desde el inicio del prompt, y un turn de Grok que la alcanza falla en lugar de volver a la queue. Las ventanas, cómo cambiarlas y el tope están en Los turns y la queue.
• Tras un reinicio. El relay guarda el id de sesión de Grok y carga esa sesión cuando el worker vuelve a arrancar. Si la CLI no puede cargarla, una nota lo dice y el turn empieza una sesión nueva sin el contexto anterior. Consulta Reinicios y reanudación.
• Consumo. Las respuestas de Grok no tienen línea de consumo; consulta Consumo.

Consumo #

📊 Check Usage (Ver consumo) tiene una tarjeta Grok mientras Grok está activado. Muestra:

• Weekly plan usage (Consumo semanal del plan), una barra de porcentaje en vivo con la fecha de reinicio, leída con el inicio de sesión de la CLI. Sin inicio de sesión de la CLI, la barra no aparece y la tarjeta muestra las estimaciones de abajo.
• Latest turn (Último turn): el coste (una estimación), el modelo, los tokens de entrada, de salida, en caché y de razonamiento, el tiempo pasado en la API y el número de turns del agente, y un desglose By model (last turn) (Por modelo, último turn).
• Current cycle (local) (Ciclo actual, local): el gasto estimado, los turns registrados y los tokens desde el último reinicio de la facturación, sumados a partir de los turns de Grok de este relay.

La tarjeta enlaza a la consola de xAI. Los costes salen del propio informe del agente y se indican como estimaciones.

Asignación mensual #

Grok no informa a OAR de los créditos que quedan, así que OAR puede comparar su propia estimación con un presupuesto que tú le das. En Grok monthly plan allowance:

Variables de entorno #

Defínelas en el entorno en el que arranca el relay.

Las ventanas de silencio tienen sus propias variables, que se listan en Los turns y la queue.

XAI_API_KEY aparece en el texto del error de inicio de sesión y la CLI lo lee, pero OAR no lo pasa a las sesiones, y la fila de la cuenta y la barra semanal lo ignoran. Inicia sesión con la CLI en su lugar.

Límites #

• El modelo es fijo por conversación, y una cuenta distinta solo se aplica a las sesiones nuevas.
• El inicio de sesión solo usa el flujo de código de dispositivo; no se ofrecen el inicio de sesión con retorno al navegador ni el empresarial de la CLI.
• No hay botón de desinstalar ni forma de fijar una versión de la CLI.

Solución de problemas #

Una respuesta de error termina con Error code: relay.<code>.; los códigos de abajo son la parte estable.