Solución de problemas
Detecta problemas de configuración, reconecta servicios, recupera sesiones y recoge diagnósticos.
Empieza por Doctor
Escribe /doctor si Clarvis se abre pero no puede empezar a trabajar. Distingue fallos obligatorios, mejoras recomendadas e información sobre configuración, proveedores, credenciales, agentes, valores por defecto, seguridad, suscripciones, backend y diagnósticos.
- Selecciona una comprobación fallida y pulsa Intro para abrir la reparación.
- Pulsa
dpara ver detalles. rrepite comprobaciones,creconecta yuactualiza el catálogo de modelos.- Si fallan las teclas, pulsa
ky ejecuta el diagnóstico del teclado.
Doctor puede quitar claves inválidas de un settings.json legible. Si no puede analizarlo, puede ofrecer restablecer ese ámbito a {}. Ambas reparaciones muestran la ruta y piden confirmación. Revisa qué se perdería antes de aceptar.
Entiende la pantalla inicial
La primera pantalla aparece mientras se cargan extensiones, proveedores y sesión. Puedes escribir y enviar una tarea; Clarvis la mantiene en cola hasta que el agente está listo. Si hace falta configurar o reparar algo, vuelve como borrador. Al recuperar una sesión guardada, la entrada permanece desactivada hasta terminar de cargarla.
Una solicitud OAuth de un MCP no bloquea el mensaje ni mantiene la ejecución del modelo esperando. El servidor queda inactivo en esa ejecución y aparece un aviso temporal sin datos sensibles fuera del historial. Completa el navegador y úsalo en una ejecución posterior. Si el diagnóstico conserva el estado anterior, usa /reconnect. Ignorar el navegador no impide usar el resto de la aplicación.
Reconecta después de cambiar ajustes
Usa /reconnect si las credenciales, el proveedor, el perfil, los MCP u otra configuración del backend parecen desactualizados. Reconstruye el backend con el perfil y las claves guardadas actuales; no borra la conversación.
Si sigue fallando, abre /doctor y resuelve la primera comprobación obligatoria antes de cambiar más ajustes.
Recupera sesiones y conversaciones
/sessionsenumera y recupera sesiones del espacio actual./statusmuestra agente, modelo, estado, tokens y coste./exportguarda todo el historial, incluido contenido retirado de la vista de la TUI./cleararchiva la sesión e inicia otra.
Exporta antes de limpiar si contiene pruebas que puedas necesitar.
Recupérate de la presión de memoria
Si se activa el fusible de memoria, Clarvis cancela el trabajo activo y bloquea nuevas tareas en vez de cerrar la TUI. Escribe /recover-memory para reconstruir el backend y espera a que termine el periodo de recuperación. Si una conversación grande sigue siendo el principal consumo, /clear crea una sesión nueva; exporta primero si necesitas el registro.
No envíes tareas repetidamente durante la recuperación. Solo permanecen disponibles recuperar, limpiar y salir hasta que el fusible vuelva al estado normal.
Inspecciona el almacenamiento con seguridad
/storage muestra un inventario de metadatos del estado gestionado por Clarvis. Informa del espacio total y recuperable y de los permisos de credenciales, sin mostrar su contenido.
Pulsa c para revisar una limpieza. Solo ofrece datos temporales antiguos y caché regenerable y pide confirmación antes de borrar. No elimina sesiones, configuración, plugins ni credenciales. Si el inventario limitado está incompleto, no continúa.
Recoge diagnósticos
Usa el nivel mínimo útil:
/debug infoSe admiten error, warn, info y debug. /debug sin argumento elige debug; /debug off cierra la sesión de diagnóstico abierta desde la TUI. Clarvis muestra la ruta exacta al abrirla y Doctor indica si está activa.
Un diagnóstico abierto después del inicio captura la TUI desde ese momento. Para fallos de arranque o del backend, reinicia con --debug=info. Los archivos tienen límites, rotación y permisos exclusivos del propietario en POSIX, y ocultan datos de prompts, herramientas y credenciales. Windows usa los controles de acceso del perfil del usuario. Revisa personalmente cualquier extracto antes de compartirlo.
Al informar de un problema, incluye versión de Clarvis, salida de /status, reproducción mínima, comportamiento esperado y observado y un extracto sin datos sensibles cercano al fallo.