Conectar una API de modelo de IA en Android con FoneClaw
Configura proveedor, URL base, clave e ID del modelo en FoneClaw. Prueba texto, imágenes y herramientas Android por separado y distingue fallos de API y permisos.
- Puedes empezar con el modelo predeterminado gratuito de FoneClaw o configurar un proveedor en línea compatible. Una suscripción a una app de chat no equivale a acceso ni facturación de API.
- El preajuste del proveedor facilita la configuración, pero debes comprobar la URL base, la clave y el ID exacto del modelo. Los controles de imágenes y herramientas deben coincidir con sus capacidades reales.
- Verifica tres resultados distintos: una respuesta de texto, la interpretación de una imagen seleccionada y una consulta Android mediante una herramienta habilitada. Superar una prueba no garantiza las otras.
- Un modelo declarado obsoleto no implica permisos Android rotos. Comprueba su calendario de retirada, valida la configuración tras cambiarlo y revisa las acciones pendientes antes de repetirlas.
Usar el modelo predeterminado o conectar tu propia API
Si quieres conectar una API de modelo de IA en Android, la primera decisión en FoneClaw es si necesitas hacerlo. Incluimos un modelo predeterminado gratuito para empezar sin credenciales externas. También puedes configurar un modelo en línea compatible dentro de FoneClaw cuando quieras usar tu propio proveedor.
La ruta predeterminada sirve para probar el flujo de agente, entender permisos, revisar herramientas y ejecutar acciones Android compatibles sin empezar por una configuración técnica. La ruta de API propia encaja cuando necesitas un proveedor concreto, un modelo específico, una política de coste distinta o un endpoint de empresa. Para esta segunda opción necesitas acceso de API: pagar una suscripción a la aplicación de chat del proveedor no garantiza credenciales, saldo ni acceso a sus modelos por API.
| Ruta | Cuándo usarla | Qué debes comprobar |
|---|---|---|
| Modelo predeterminado gratuito | Primeras pruebas y validación del flujo Android. | Herramienta compatible, permisos necesarios y resultado verificable. |
| Modelo compatible configurado | Proveedor propio, modelo elegido o endpoint corporativo. | Credenciales, URL base, ID del modelo, formato y soporte de imágenes y herramientas. |
La arquitectura no cambia: el modelo seleccionado interpreta y planifica dentro de FoneClaw; nuestras herramientas habilitadas ejecutan los pasos compatibles con los permisos necesarios y la política de aprobación vigente. Una API correcta no controla Android por sí sola. Para entender esa capa de ejecución, Controlar un teléfono Android con agente de IA: de intención a acción verificada explica cómo comprobar el paso de una petición a un resultado real.
Entender el proveedor, la URL base, la clave y el ID del modelo
La configuración suele fallar cuando se mezclan campos que hacen trabajos distintos. El preajuste del proveedor facilita introducir la configuración, pero no crea una cuenta, concede acceso a modelos ni demuestra por sí solo que el endpoint sea compatible.
La URL base no es la página de inicio del proveedor. Debe corresponder al endpoint y al formato de solicitudes compatibles. La documentación sobre compatibilidad de Gemini API con clientes OpenAI ilustra por qué conviene usar la ruta específica documentada en vez de asumir que todos los servicios comparten la misma interfaz.
| Campo o control | Qué representa | Error que debes evitar |
|---|---|---|
| Preajuste del proveedor | Una ayuda para configurar el servicio elegido. | Confundirlo con acceso autorizado o compatibilidad garantizada. |
| URL base de API | Endpoint compatible al que se envían las solicitudes. | Pegar la web general o una ruta incompleta. |
| Clave de API | Credencial que autentica la solicitud. | Usar una clave inválida, de otra cuenta o expuesta públicamente. |
| ID del modelo | Identificador exacto disponible en ese endpoint y cuenta. | Introducir un nombre comercial en lugar del identificador aceptado. |
| Soporte de imágenes y herramientas | Controles que deben reflejar las capacidades documentadas. | Activarlos suponiendo que añaden capacidades al modelo. |
Trata la clave como una contraseña: no la publiques ni la incluyas en capturas de soporte. La referencia de autenticación de la API de OpenAI describe el uso de credenciales en su servicio; cada proveedor puede tener requisitos propios. Revoca o rota una clave si se ha expuesto.
Para profundizar en criterios de selección entre familias de modelos, Kimi K3, DeepSeek V4 y GLM-5.2 para phone agents: cómo elegir modelo amplía la elección sin sustituir la comprobación del ID aceptado por tu proveedor.
Configurar el proveedor y sus capacidades en FoneClaw
Antes de modificar la configuración, prepara desde tu proveedor la URL base, la clave de API y el ID del modelo. Comprueba también el formato admitido, el acceso de tu cuenta y las capacidades que necesitas. Si puedes crear una clave con permisos acotados, utiliza una dedicada y revócala cuando deje de hacer falta.
- Abre la configuración del modelo en FoneClaw y decide si mantienes el predeterminado o añades uno compatible.
- Selecciona un preajuste del proveedor cuando corresponda y revisa sus valores.
- Introduce la URL base documentada para el endpoint compatible.
- Añade la clave de API sin espacios adicionales y el ID exacto disponible para tu cuenta.
- Ajusta el soporte de imágenes y de llamadas a herramientas según lo que admitan el modelo y el endpoint.
- Guarda la configuración y selecciona ese modelo.
- Valida texto, una imagen si admite visión y una herramienta Android de bajo riesgo, por separado.
Los preajustes y los controles de capacidades forman parte de la configuración disponible en FoneClaw. Activar el soporte de imágenes no convierte un modelo de texto en uno visual; habilitar las llamadas a herramientas tampoco añade esa capacidad a un endpoint que no la admite.
Cambiar de modelo modifica la capa de interpretación, no los permisos de Android. Una clave válida no concede acceso a contactos, ubicación ni otros recursos del teléfono. Las herramientas siguen sujetas a su habilitación, los permisos aplicables, el estado de la app y la política de aprobación efectiva.
Probar texto, imágenes y herramientas por separado
La primera prueba debe aislar la conexión. Pide algo inocuo, como “resume esta frase de prueba”, sin imágenes ni acciones del teléfono. Una respuesta coherente confirma que esa solicitud de texto pudo completarse; no demuestra visión ni ejecución Android.
Después, si el modelo y el endpoint admiten imágenes, adjunta deliberadamente una foto sencilla sin información sensible. Pide que describa un objeto o un detalle visible y compara la respuesta con la imagen. En FoneClaw optimizamos las imágenes grandes seleccionadas y corregimos su orientación, pero su interpretación sigue dependiendo de un modelo compatible con visión. Esa preparación no sustituye el soporte visual ni convierte la imagen en un PDF con OCR.
La tercera prueba debe utilizar una herramienta habilitada de bajo riesgo, por ejemplo consultar el volumen o el estado Bluetooth del teléfono. Comprueba que se ejecutó la herramienta correspondiente y que devolvió datos del dispositivo. Una frase como “el volumen está bien” sin un resultado de herramienta no confirma la consulta.
| Prueba | Resultado que debes observar | Lo que todavía no demuestra |
|---|---|---|
| Texto sin herramientas | Respuesta a la petición enviada. | Soporte de imágenes o herramientas. |
| Imagen seleccionada | Descripción que coincide con el contenido visible. | Acceso a recursos Android o ejecución de acciones. |
| Consulta Android | Herramienta ejecutada y datos devueltos del teléfono. | Disponibilidad de otras herramientas o permisos. |
Observa la herramienta elegida, el permiso si hace falta, la aprobación cuando la política la exija y el resultado final. No empieces con envíos, borrado de datos ni cambios sensibles: una consulta pequeña permite separar compatibilidad del modelo y ejecución local.
Resolver errores de API, capacidades y permisos
Un fallo de API y un permiso Android denegado necesitan soluciones distintas. Además, el texto puede funcionar mientras una imagen o una llamada a herramientas falla. Identifica la solicitud que falló antes de cambiar toda la configuración.
| Síntoma | Causa probable | Qué revisar |
|---|---|---|
| 401 o no autorizado | Clave incorrecta, revocada, mal copiada o sin acceso. | Credenciales y autorización de la cuenta en el proveedor. |
| 404 o ruta no encontrada | URL, ruta o modelo no disponible. | Endpoint documentado e ID exacto aceptado por esa cuenta. |
| Modelo no encontrado o retirado | ID incorrecto, acceso ausente o retirada del modelo. | Lista de modelos disponibles y calendario del proveedor. |
| Tiempo de espera agotado | Red, servicio saturado o solicitud que tarda demasiado. | Conectividad y una prueba de texto más corta antes de repetir. |
| Texto funciona, imagen falla | Visión no admitida o configuración/formato incompatible. | Modelo visual, endpoint, control de imágenes y archivo adjunto. |
| Texto funciona, llamada a herramientas falla | Modelo o endpoint sin soporte compatible. | Capacidad documentada y control de herramientas. |
| Herramienta Android no ejecuta | Herramienta deshabilitada, permiso, política o estado de la app. | Requisito local concreto y resultado de ejecución. |
| Permiso Android denegado | No se concedió acceso al recurso necesario. | Concederlo solo si confías en la tarea o elegir otra ruta. |
Los códigos son pistas, no diagnósticos universales: un 404 puede representar una ruta incorrecta o un modelo inexistente, según el proveedor. Si el problema es una interrupción temporal del servicio, Caída del modelo del asistente IA en Android: reintentar, cambiar modelo y reanudar tareas explica cómo separar la espera y el cambio de modelo de la recuperación de una tarea.
Para comparar la función del modelo con la de una app de consumo, los casos de DeepSeek como agente de IA para controlar teléfonos Android: qué puede y qué no puede hacer y ¿Puede Grok controlar un teléfono Android? Llamadas, asistente principal y FoneClaw ayudan a entender por qué una respuesta del asistente no equivale a control del teléfono.
Elegir un modelo y comprobar su ciclo de vida
No hay un modelo universalmente mejor para un agente móvil. Importan el coste, la latencia, la claridad de las instrucciones, el soporte visual cuando lo necesitas y la compatibilidad con herramientas. La red, los permisos, el estado de las apps y las aprobaciones también influyen en el tiempo de una tarea.
Comprueba además su ciclo de vida. Como ejemplo fechado de mantenimiento de API, la documentación oficial de retirada de modelos de Anthropic indica que claude-sonnet-4-5-20250929 se declaró obsoleto el 30 de septiembre de 2026, con retirada prevista para el 30 de noviembre de 2026 y claude-sonnet-5-5 como sustituto recomendado. Declarado obsoleto no significa retirado: durante esa fase sigue funcionando; tras la retirada, las solicitudes fallan.
Ese calendario corresponde a las plataformas operadas por Anthropic. Los proveedores asociados pueden aplicar otras fechas e identificadores. La recomendación de sustitución tampoco demuestra que la API nativa de Anthropic Messages sea intercambiable con un endpoint de formato OpenAI configurado en FoneClaw. Verifica el protocolo compatible y el modelo disponible en tu servicio antes de modificar los campos.
La privacidad también cuenta. El modelo en línea puede recibir el texto o las imágenes que proporciones. Revisa las condiciones del proveedor y limita el contexto sensible. Tras migrar, repite las pruebas de texto, imagen y herramienta que correspondan; no des por heredadas las capacidades del modelo anterior.
Verificar la ejecución y reanudar acciones pendientes
Una vez validada la configuración, el flujo útil es: petición, interpretación del modelo, selección de herramienta, permisos necesarios, aprobación según la política vigente, ejecución y comprobación del resultado. La página de funciones de FoneClaw reúne nuestras capacidades de modelos y herramientas Android. Para preparar la aplicación en tu teléfono, puedes consultar la página de descarga de FoneClaw.
Empieza con la misma consulta inocua de estado que utilizaste antes del cambio. Después retoma una tarea propia solo tras comprobar su estado en el destino previsto. Si creaste una tarea personal o un evento, ábrelo; si hubo un envío de correo mediante una cuenta configurada, verifica el resultado en esa cuenta. Una respuesta redactada en la conversación no prueba que se haya guardado un borrador ni enviado un mensaje.
Cuando una ejecución se interrumpe, el efecto puede haberse producido antes del último mensaje del modelo. Revisa lo existente y solicita únicamente el paso pendiente para evitar envíos o registros duplicados. Cómo depurar y recuperar fallos de un agente móvil Android sin repetir acciones peligrosas desarrolla esa recuperación a partir del último resultado confirmado.
Conectar la API tiene sentido cuando puedes distinguir una respuesta del modelo, una herramienta ejecutada y una acción terminada. Mantener esas tres pruebas separadas permite corregir la capa que falla sin alterar permisos válidos ni repetir efectos externos.