Referencia de Ajustes

Gestionar servidores

#

Abre Ajustes → Gestionar servidores para añadir, renombrar, editar o eliminar perfiles. La conexión, OpenClaw, los tiempos de espera, la comprobación de estado, los trabajos y la UI pertenecen a cada servidor. Puedes añadir un emoji o dejarlo vacío para usar el icono habitual. Un servidor es gratis, incluido el alta por QR; varios requieren Pro. Configuración, migración y almacenamiento.

Sincronización

#

Activa Sincronizar este servidor con iCloud para compartir nombre, emoji, fondo del chat, colores y opacidad de las burbujas, ajustes de conexión, mensajes entregados y enlaces guardados. En los otros equipos aparecerá en Disponibles en iCloud: tú eliges dónde añadirlo y su historial solo se descarga al hacerlo. Déjalo desactivado para un servidor exclusivo de un dispositivo. El servidor activo, los borradores y los envíos pendientes son independientes en cada equipo. Los tokens se sincronizan de forma segura a través del Llavero de iCloud cuando activas la sincronización del servidor. Activa el Llavero de iCloud en ambos dispositivos con la misma cuenta de Apple; las credenciales pueden llegar después del perfil. No necesitas copiar el token obtenido por QR. La conversación original conserva su sincronización anterior con iCloud.

Gestionar servidores consulta iCloud al abrirse. Actualizar iCloud permite repetir la consulta y muestra su progreso y la última comprobación. La entrega del perfil, su historial y el token puede tardar; un perfil sin credenciales indica que está esperando al Llavero antes de permitir el envío.

Apariencia y navegación

#

Abre Ajustes → Gestionar servidores → tu servidor → Apariencia → Estilos. Puedes elegir una imagen desde Fotos o Archivos, quitarla, cambiar el color de tus mensajes y de las respuestas y ajustar la opacidad de las burbujas. La vista previa permite ver el resultado. El texto y las imágenes no pierden opacidad. Restablecer colores de las burbujas recupera los colores automáticos.

Aplicar fondo a todos los servidores aparece cuando hay varios perfiles y copia solo la imagen a los servidores añadidos en este dispositivo. Conserva los colores, la opacidad y la opción de sincronización de cada uno. El fondo y los colores no se envían al servidor; se comparten por iCloud únicamente cuando el perfil tiene la sincronización activada. Estas opciones son gratuitas.

Mac y iPad con ventanas amplias permiten alternar entre navegación superior y lateral; iPhone conserva las pestañas inferiores. Los controles Liquid Glass siguen los ajustes del sistema. Reducir transparencia tiene prioridad sobre la opacidad elegida para las burbujas. Las opciones de respuesta se presentan en una tarjeta, una por fila, con el color de las respuestas del servidor.

Fotos

#

Los enlaces a la fototeca son gratis. Actívalos en este dispositivo para abrir consultas de fotos desde el chat. iOS sigue solicitando el permiso de fototeca necesario; abrir un enlace de fotos no sube imágenes. Enviar una imagen adjunta la envía al servidor seleccionado.

Configuración del Servidor

#

Los ajustes principales de conexión con tu servidor PocketHook.

URL del Servidor

#

El endpoint HTTPS donde PocketHook envía tus mensajes del chat. Solo se aceptan URLs HTTPS — las HTTP se rechazan por seguridad. Este es el endpoint principal en el que tu servidor escucha.

Token de Autenticación

#

Token Bearer enviado en la cabecera Authorization con cada petición. Tu servidor puede usarlo para verificar que las peticiones vienen de tu dispositivo. Se almacena de forma segura en el iOS Keychain — nunca en texto plano.

Compatible con OpenClaw

#

Activa si tu servidor usa la plataforma OpenClaw o cualquier API compatible con OpenAI Chat Completions. Cuando está activo, PocketHook envía mensajes en formato chat de OpenAI y parsea marcadores de atajos en línea ([SHORTCUT:nombre], [DATA:{...}], [URL:...]) de la respuesta. Se incluye la cabecera x-openclaw-agent-id en las peticiones.

Probar Conexión

#

Botón que envía una petición de prueba a tu servidor configurado. Muestra:

• Tiempo de respuesta en milisegundos
• Resultado del health check (si está habilitado)
• Detalles del error si la conexión falla

Úsalo después de cambiar la URL del Servidor o el Token de Autenticación para verificar que todo funciona.

Red

#

Ajusta el comportamiento de los tiempos de espera para diferentes tipos de operaciones.

Timeout de Petición

#

Cuánto tiempo espera PocketHook a que el servidor empiece a responder a una petición. Si tu servidor hace procesamiento pesado (como llamar a un modelo de IA), aumenta este valor. El valor por defecto es de 60 segundos.

Timeout de Recurso

#

Tiempo máximo para que la respuesta completa se transfiera, incluyendo datos. Debe ser mayor que el Timeout de Petición. Aumenta si tu servidor devuelve payloads grandes o tiene velocidades de subida lentas.

Health Check

#

Activa la monitorización de salud del servidor. Cuando está activo, PocketHook envía una petición GET a la URL de Health Check durante las pruebas de conexión y muestra si tu servidor reporta estar operativo.

URL de Health Check

#

Un endpoint HTTPS separado que devuelve texto plano true o false. Esta URL se consulta durante las pruebas de conexión para verificar que tu servidor está operativo. Útil cuando tu endpoint principal de API está detrás de autenticación pero quieres una verificación de estado simple.

Automatización

#

Controla cómo PocketHook ejecuta los Atajos de iOS activados por respuestas del servidor.

Atajos de iOS

#

Interruptor principal para la ejecución de Atajos. Cuando está OFF, PocketHook sigue mostrando los mensajes del servidor pero ignora cualquier campo shortcut en las respuestas. Útil para depurar o deshabilitar automatizaciones temporalmente.

Retraso Entre Atajos

#

Tiempo de espera entre la ejecución de atajos consecutivos cuando el servidor devuelve múltiples automatizaciones en una sola respuesta. Aumenta si tus atajos dependen uno del otro (por ejemplo, el primero crea un archivo que el segundo lee).

Timeout de Atajo

#

Tiempo máximo de espera para que cada atajo individual termine antes de que PocketHook lo considere agotado. Atajos de larga duración (como los que procesan multimedia o hacen múltiples llamadas API) pueden necesitar los 5 minutos completos.

Interfaz Personal

#

Inserta una interfaz web personalizada directamente en PocketHook.

Interfaz Personal

#

Muestra una pestaña dedicada con una vista web integrada. Cuando está activo, aparece una nueva pestaña en la navegación principal donde se muestra tu página web personalizada. La página se precarga para mostrarse al instante y soporta pull-to-refresh.

URL de Interfaz Personal

#

La URL a mostrar en la pestaña de Interfaz Personal. Se aceptan HTTP y HTTPS (se recomienda HTTPS). Puede ser un dashboard, panel de administración o cualquier página web a la que quieras acceder rápidamente junto a tu chat.

Enlaces

#

Configura cómo PocketHook gestiona las URLs de las respuestas del servidor.

Pestaña de Enlaces

#

Muestra u oculta la pestaña de Enlaces en la navegación principal. Cuando está activo, todas las URLs recibidas de las respuestas del servidor se guardan y muestran en una pestaña dedicada con previsualizaciones enriquecidas, búsqueda y eliminación.

Abrir URLs Automáticamente

#

Cuando está activo, PocketHook abre automáticamente las URLs de las respuestas del servidor en tu navegador predeterminado. Cuando está desactivado, las URLs se guardan en la pestaña de Enlaces (si está habilitada) pero no se abren automáticamente.

Este ajuste es por dispositivo a propósito: puede que quieras que los enlaces se abran solos en el iPhone pero no en el Mac. Tocar el enlace debajo de un mensaje siempre lo abre, sin importar este ajuste.

Idioma

#

Personaliza el idioma de la app y del dictado.

Idioma de la App

#

Cambia el idioma de la interfaz de la app independientemente del idioma de tu dispositivo. Cuando está en “Por defecto del sistema”, PocketHook sigue el ajuste de idioma de iOS.

Idioma de Dictado

#

Idioma usado para el dictado por voz (speech-to-text) en la entrada del chat. Idiomas disponibles:

Tareas en Segundo Plano

#

Comprueba periódicamente si hay tareas pendientes incluso cuando la app está en segundo plano.

Tareas en Segundo Plano

#

Activa el polling en segundo plano. Cuando está activo, PocketHook envía periódicamente una petición GET a la URL de Polling. Si la respuesta es true, envía el Mensaje de Consulta a tu servidor principal cuando la app se abre. Requiere permiso de notificaciones para alertarte de tareas pendientes.

Intervalo de Comprobación

#

Con qué frecuencia PocketHook consulta la URL de Polling en segundo plano. Intervalos más cortos significan detección más rápida de tareas pendientes pero consumen más batería. iOS puede ajustar la frecuencia real según los patrones de uso del dispositivo.

URL de Polling

#

Endpoint HTTPS que PocketHook consulta en el intervalo configurado. Debe devolver texto plano true (tareas pendientes) o false (sin tareas). Esta es una comprobación ligera — tu servidor debe responder rápido sin procesamiento pesado.

Agent Server: Usa https://tu-host/jobs (ajusta host y puerto según tu configuración).

Mensaje de Consulta

#

El mensaje enviado a tu servidor principal cuando una comprobación en segundo plano encuentra tareas pendientes y la app se abre. La respuesta del servidor aparece en el chat como cualquier otro mensaje. Personaliza esto para activar un comportamiento específico en tu servidor.

Gestión de Datos

#

Monitorea y gestiona tus mensajes almacenados.

Mensajes Almacenados

#

Muestra cuántos mensajes están almacenados actualmente. El indicador tiene código de colores:

• Verde — Menos del 70% de capacidad
• Naranja — 70–90% de capacidad
• Rojo — Más del 90% de capacidad

Cuando se alcanza el límite de 500 mensajes, los más antiguos se eliminan automáticamente para hacer espacio a los nuevos.

Exportar Conversación

#

Botón que exporta todos los mensajes almacenados como un archivo JSON a través del menú compartir de iOS. Puedes guardar el archivo, enviarlo por AirDrop o compartirlo con cualquier app. Útil para hacer copias de seguridad o analizar el historial de mensajes.

Eliminar Todos los Mensajes

#

Botón destructivo que elimina permanentemente todos los mensajes almacenados. Requiere confirmación antes de ejecutarse. Esta acción no se puede deshacer.

Acerca de

#

Información de solo lectura sobre tu instalación de PocketHook.