Tu primera tarea de automatización en Android.

Antes de empezar

• Un equipo con Windows o Linux (también sirve una Raspberry Pi de 64 bits) con una versión de Talos disponible para su arquitectura.
• Herramientas de la plataforma Android: adb debe estar disponible para la cuenta que ejecuta Talos, en el PATH o configurado como Tools:AdbPath.
• Un emulador Android o un teléfono con la depuración USB activada. Un teléfono bloqueado con PIN, patrón o contraseña debe desbloquearse antes de una ejecución.
• Una clave de API de un proveedor de modelos (Claude de Anthropic, OpenAI, Google Gemini u OpenRouter) o un endpoint HTTP que implemente el protocolo de proveedor personalizado de Talos.
• Una clave de licencia o de prueba cuando la versión instalada la pida. Las instalaciones con licencia necesitan acceso al servidor de licencias.

FFmpeg es opcional y se usa para la transmisión de pantalla en directo (configura Tools:FfmpegPath si no está en el PATH). Appium no es necesario. El uso del proveedor de IA es independiente de la licencia de Talos.

1. Instala Talos, define una contraseña y actívalo

Elige un instalador disponible para tu equipo. Las versiones de Windows se ejecutan como aplicación en la bandeja del sistema; el paquete .deb de Linux instala un servicio systemd. Sigue las instrucciones del paquete publicado y comprueba su arquitectura.

Abre el panel, normalmente en http://localhost:7700. En el primer inicio, define una contraseña para el panel de al menos 8 caracteres; protege la API, las actualizaciones en directo y las vistas previas de pantalla. Después pega tu clave de licencia si se pide la activación. ¿No tienes clave? Solicita una licencia de prueba gratuita y guarda la clave que aparece en pantalla.

¿Actualizas desde una versión anterior? Conserva el directorio de datos. El primer inicio de 0.4.0 actualiza una sola vez la base de datos local y puede tardar más si el historial de ejecuciones es largo; se conservan las tareas, los ajustes y las claves de API guardadas.

2. Conecta un dispositivo Android

Inicia tu emulador o activa la depuración USB en el teléfono y conéctalo al equipo. Acepta la solicitud de autorización en el teléfono. Comprueba la conexión desde una terminal:

adb devices

El dispositivo debe aparecer con el estado device, no unauthorized ni offline. Abre Dispositivos en Talos y comprueba la vista previa de la pantalla. Antes de cada ejecución, Talos enciende la pantalla y quita un bloqueo sin seguridad; si el teléfono usa PIN, patrón o contraseña, desbloquéalo tú, o la ejecución se omitirá sin llamar al modelo.

Un emulador que requiera una conexión ADB explícita debe conectarse primero con la dirección que indique su documentación. Lee las indicaciones de compatibilidad.

3. Elige tu proveedor de IA

En Ajustes, elige un proveedor, introduce su clave de API, elige un modelo y guarda. Las claves se quedan en tu equipo y solo se muestran sus últimos caracteres. El agente envía al proveedor el objetivo, las observaciones de la interfaz y las capturas relevantes; el generador opcional de etapas usa el mismo proveedor y solo se ejecuta cuando lo pides.

Claude, OpenAI y Gemini

Elige Anthropic Claude, OpenAI o Google Gemini y un modelo de la lista, o escribe el nombre de otro modelo. Talos estima el coste de cada llamada con los precios del proveedor; para un modelo fuera de la lista usa las tarifas más caras del proveedor, de modo que los presupuestos detengan el trabajo antes y no después.

OpenRouter

Introduce una clave de OpenRouter y elige un modelo del catálogo en directo. Solo los modelos con llamadas a herramientas pueden ejecutar tareas, y los modelos sin entrada de imagen no reciben capturas. OpenRouter informa del coste real de cada llamada y Talos suma exactamente ese importe al presupuesto.

Esfuerzo y modelos por tarea

El esfuerzo (effort: bajo, medio, alto o muy alto) equilibra el coste de cada llamada con la minuciosidad; un esfuerzo menor puede necesitar más pasos, así que compara el coste de las tareas completadas. Cada tarea puede sustituir el modelo y el esfuerzo predeterminados, por ejemplo con un modelo más barato para una comprobación frecuente, y cada ejecución registra qué modelo y esfuerzo usó.

Endpoint HTTP propio

Elige el proveedor personalizado e introduce su URL. Talos envía una petición POST con system, tools, history, observation y un screenshot_base64 opcional, y espera como respuesta una decisión de herramienta. El texto del campo de instrucciones para el modelo de Ajustes se añade al final de system. Es un protocolo propio de Talos, no una opción que funcione con cualquier API de chat.

Una respuesta mínima tiene esta forma:

{
  "tool": "tap",
  "args": { "element": 8 },
  "reasoning": "Open the visible form",
  "input_tokens": 0,
  "output_tokens": 0
}

El número de elemento debe referirse a la observación actual. En lugar de un único tool, la respuesta puede devolver una lista calls con pares de herramienta y argumentos. Las respuestas HTTP 408, 429 y 5xx cuentan como fallos temporales. Talos no calcula los cargos del proveedor personalizado; contrólalos en tu endpoint.

4. Crea una tarea pequeña con un resultado visible

Abre Tareas, elige Nueva tarea, ponle un nombre y selecciona un dispositivo conectado. Un dispositivo puede tener varias tareas; se ejecutan de una en una. Escribe un objetivo y elige el modo de una sola vez. Añade etapas opcionales a mano o deja que la IA las proponga.

Empieza con los límites predeterminados o ajusta las iteraciones, el tiempo y el coste estimado de la ejecución. El presupuesto se comprueba tras cada respuesta del modelo, así que la última llamada puede superar tu umbral. Un presupuesto diario para la tarea y otro global en Ajustes limitan el gasto entre ejecuciones.

Las tareas se pueden duplicar o exportar a un archivo .talos-task.json e importar en otro teléfono u otra instalación. El archivo contiene la definición, con etapas, límites, modelo y horario de trabajo, pero no el dispositivo ni el historial de ejecuciones.

El panel arranca en inglés y puede cambiarse a Deutsch, Español, Français, 简体中文 o Polski. Las capturas de este sitio muestran la interfaz en polaco: Dispositivos es «Urządzenia», Tareas es «Zadania», Nueva tarea es «Nowe zadanie» y Ajustes es «Ustawienia».

5. Inicia la tarea y revisa su línea de tiempo

Las tareas nuevas se crean detenidas. Inicia la tarea desde su tarjeta. Abre la vista previa del dispositivo para seguir la pantalla o usa Detener para interrumpir la ejecución. Mientras no haya ninguna ejecución en curso en el dispositivo, puedes tocar la vista previa, escribir texto y usar Atrás, Inicio, Aplicaciones recientes o Activar pantalla para corregir su estado a mano.

Abre el historial de ejecuciones para revisar las observaciones, las explicaciones que da el modelo, las herramientas y sus argumentos, los resultados, el consumo de tokens, el coste y las capturas disponibles; los registros de la ejecución están a un clic. Talos conserva las 10 últimas ejecuciones de cada tarea y guarda aparte los totales de coste diarios. Comprueba la pantalla final antes de dar por bueno el resultado.

Repite un flujo en modo continuo

Elige el modo continuo y define una pausa de 10 a 86.400 segundos. Tras un ciclo correcto, Talos guarda un resumen y programa el siguiente ciclo. Ese resumen ayuda al agente a continuar con contexto.

El horario de trabajo limita los ciclos a los días elegidos y a una franja horaria, por ejemplo de lunes a viernes de 9:00 a 17:00, en la hora local del servidor. Fuera de esa franja la tarea espera sin ejecuciones ni costes; un ciclo ya iniciado termina con normalidad.

Los problemas temporales, como una API saturada o inaccesible, un teléfono que se desconecta o una pantalla bloqueada, se reintentan hasta cuatro veces con una pausa creciente, desde la pausa del ciclo hasta 30 minutos. Detener, un límite alcanzado, un error de configuración o una tarea que el modelo declara imposible detienen la tarea. Si se agota el presupuesto diario, la tarea espera en cambio al día siguiente.

Los límites se aplican a cada ciclo y los costes se acumulan. Detener también cancela el siguiente ciclo programado. Detén una tarea en curso y deja que termine antes de editar su definición. La memoria es un resumen generado por el modelo, no un registro exacto de eventos. Ver un ejemplo de comprobación de estado recurrente.

Recibe avisos cuando una tarea necesite atención

En Ajustes → Notificaciones, elige un canal: un webhook (POST con JSON), Discord, Telegram, ntfy o correo por SMTP. Después elige los eventos: tarea detenida por un error (también tras agotar sus reintentos), detenida por un límite, presupuesto diario agotado, teléfono desconectado con su tarea activada o tarea única terminada.

Los reintentos en curso y tus propias detenciones no generan avisos, y el mismo evento de la misma tarea se envía como máximo una vez cada 10 minutos. Enviar prueba comprueba la configuración guardada. Por ahora, los textos de las notificaciones están en polaco; los webhooks incluyen además un código de evento independiente del idioma.

Si la primera ejecución no funciona

Talos no muestra ningún dispositivo

Comprueba adb devices con la cuenta que ejecuta Talos. Autoriza la depuración USB y comprueba el cable o la conexión del emulador. El servicio de Linux puede ejecutarse con una cuenta distinta de la de tu terminal. Si adb no está en el PATH, configura Tools:AdbPath.

El agente no llega a una pantalla

Desbloquea un teléfono que use PIN o patrón, revisa los permisos de la app y consulta la línea de tiempo. Prueba con un objetivo más corto y un único criterio de éxito visible.

Una tarea se detiene en un límite

Revisa el resultado registrado antes de subir los límites. Busca una pantalla que se repite, una opción no disponible o instrucciones ambiguas. Una tarea que ha agotado su presupuesto diario continúa al día siguiente.

La vista previa no se transmite

Comprueba FFmpeg y el ajuste de vista previa en directo. Usa la vista previa normal del dispositivo para diagnosticar la conexión.

Has olvidado la contraseña del panel

Inicia Talos una vez con Talos__Auth__ResetPassword=true, define una contraseña nueva en el navegador y quita la opción. En el panel, Instrucciones → Contraseña del panel muestra los comandos exactos para el servicio systemd.

Falla una comprobación de licencia

Revisa tu clave, las activaciones disponibles y la conexión con el servidor de licencias. Una instalación en marcha sigue funcionando hasta 72 horas después de la última comprobación correcta, y detener tareas siempre es posible.

La página Diagnóstico del panel muestra la versión, el estado de adb y FFmpeg, los dispositivos, el directorio de datos, la licencia y los problemas recientes. Si necesitas ayuda, escribe al desarrollador de Talos con el texto de Copiar informe y una descripción del paso que falló. Elimina el contenido privado de la pantalla y las claves de todo lo que compartas.