📚 Documentación
Cada función, cada ajuste.
Todo lo que hace la app y cada ajuste que tiene — escrito para la versión que estás ejecutando. De la barra de menús al registro de habilidades, este es el manual completo.
En esta página
Inicio rápido La app de la barra de menús Ajustes, explicados Pestaña Modelo Pestaña Telegram Páginas por bot Pestaña App Habilidades y funciones Registro de habilidades Actualizaciones Datos y privacidad Solución de problemasInicio rápido
- Instala. Descarga el .dmg y arrastra Telebot AI a Aplicaciones. El build no está notarizado todavía, así que si macOS muestra un aviso, haz clic derecho (Control-clic) en la app y elige Abrir — una vez.
- Crea un bot. Envía un mensaje a @BotFather en Telegram, ejecuta /newbot y copia el token. Un token por bot — puedes ejecutar varios.
- Añade el token. Abre Telebot AI desde la barra de menús, abre Ajustes y pega el token en el campo Token del bot. Se guarda en cuanto escribes — no hay botón de guardar.
- Conecta un cerebro. En la pestaña Modelo, configura la URL del servidor (http://localhost:11234 para mlx-serve, http://localhost:11434 para Ollama) y el nombre del modelo, o usa cualquier API en la nube compatible con OpenAI. Pulsa Probar para comprobar la conexión.
- Inicia el bot. Vuelve a la barra de menús y elige Iniciar bot. Envía un mensaje a tu bot en Telegram — responde desde ese momento.
¿Nuevo con los modelos locales? Lee la guía — cubre mlx-serve, Ollama y LM Studio, y cuánta RAM necesita cada modelo.
La app de la barra de menús
Telebot AI vive en tu barra de menús (icono ⌘). El menú te da:
- Iniciar / Detener / Reiniciar — por bot o todos a la vez. Los bots corren como LaunchAgents: siempre activos, fuera de tu camino.
- Abrir Ajustes — la ventana de ajustes.
- Registros — sigue el registro del bot para ver qué está haciendo o depurar un problema.
- Salir — detiene todo (y desactiva los LaunchAgents hasta que inicies de nuevo).
Ajustes, explicados
La ventana de ajustes tiene una barra lateral con dos tipos de páginas:
- Valores por defecto — Modelo, Telegram, App, Habilidades y funciones, Registro de habilidades, Acerca de, Actualizaciones. Los valores que hereda cada bot.
- Bots — una página por bot. Cada campo muestra lo que este bot usa realmente: un valor anula el valor por defecto, un campo vacío lo hereda (el explicador bajo cada fila lo dice). Por eso no hay casillas "Usar global" — un campo vacío es "usar global".
Todo se guarda solo mientras escribes o alternas. Los ajustes viven en ~/.mlx-serve/config.json.
Valores por defecto → Modelo
| Ajuste | Qué hace |
|---|---|
| URL del servidor | El endpoint compatible con OpenAI. Los servidores locales no necesitan clave. |
| Clave API | Vacía para servidores locales (mlx-serve, Ollama, LM Studio). El botón del ojo la muestra u oculta. |
| Nombre del modelo | Qué modelo hay en ese servidor, p. ej. deepseek-v4-flash-free. |
| Probar | Comprueba la conexión con los valores actuales — útil antes de guardar nada. |
| Modelos de respaldo | Se prueban en orden cuando el principal falla o limita. Cada uno tiene su propio apodo, URL, clave y modelo, además de Probar, reordenar y eliminar. Añadir está desactivado hasta que la última fila esté completa. |
Valores por defecto → Telegram
| Ajuste | Qué hace |
|---|---|
| IDs de chat permitidos | IDs de usuario/grupo separados por comas que pueden hablar con el bot. Vacío = cualquiera. |
| Hora del resumen diario | Cuándo envía el bot su resumen diario — menús desplegables de hora/minuto en formato 24 h (p. ej. 08:00). |
| Indicación del resumen diario | Qué debe cubrir el resumen — p. ej. "clima, mis recordatorios de hoy y cualquier alerta de precio". |
| Máx. tokens de respuesta | Tope de seguridad para las respuestas; las respuestas largas se dividen en varios mensajes. |
| Contexto por chat | Cuántos mensajes recientes guarda el bot por chat como contexto. |
| Recuerdos por usuario | Recuerdos a largo plazo que el bot recupera por usuario, por cada mensaje que responde. |
| Tamaño de la base de memoria (por usuario) | Máximo de recuerdos almacenados por usuario; los más antiguos se eliminan más allá de esto. |
| Tokens de informes de investigación | Presupuesto para los informes /research y /insiders. |
| Tiempo de espera de API (s) | Segundos antes de abandonar un proveedor lento — las colas gratuitas pueden tardar más de un minuto. |
| Archivo de personalidad | La personalidad con la que corren los bots. Los archivos .md de esta carpeta (soul*.md, *persona*.md) aparecen en el desplegable de Personalidad de cada bot. |
| Palabras de activación del bot | Palabras separadas por comas que hacen que el bot responda en grupos (además de @mención, respuesta o comando) — p. ej. "momo, jarvis, hey bot". |
| Palabras de activación de clips de vídeo/audio | Palabras que hacen que el bot capture un vídeo o audio adjunto como clip — p. ej. "clip this, save this". |
Páginas por bot
Cada bot de la barra lateral tiene su propia página. Los campos vacíos heredan los valores por defecto; el explicador bajo cada fila indica qué hereda.
| Ajuste | Qué hace |
|---|---|
| Token | El token @BotFather del bot (botón de ojo para revelarlo). Cambiarlo renombra la entrada del bot en la barra lateral. |
| Apodo | Se usa en el estado, los registros y la barra lateral — p. ej. "Trading". |
| IDs de chat permitidos / Palabras de activación / Palabras de clip | Las anulaciones de este bot sobre los valores por defecto correspondientes. |
| URL del servidor, clave API, modelo | El desplegable ofrece los proveedores configurados en Valores por defecto → Modelo, además de cualquier valor personalizado. Se pueden añadir modelos de respaldo propios por bot. |
| Hora del resumen diario / Indicación del resumen | Resumen propio del bot, con un botón "Usar global" que borra la anulación. |
| Modo | Investigador, Asistente, Programador, Chef o Ninguno — vacío usa el modo por defecto. |
| Archivo de personalidad | La anulación de personalidad de este bot, elegida entre los archivos soul/persona encontrados en disco. |
| Habilidades | Abre la hoja de habilidades del bot — desactiva habilidades para este bot además de los valores por defecto, o restablece al valor por defecto. |
Valores por defecto → App
| Ajuste | Qué hace |
|---|---|
| Mostrar en el Dock | Si la app de la barra de menús aparece también en el Dock. |
| Iniciar al iniciar sesión | Inicia Telebot AI cuando inicias sesión. |
| Carpeta de datos | Dónde viven la configuración, la memoria, los recordatorios y los registros (por defecto ~/.mlx-serve). |
| Abrir registro / Abrir carpeta de datos | Salta directo al archivo de registro o a la carpeta de datos en Finder. |
| Exportar configuración | Guarda la configuración completa (incluidas las claves API) en un archivo — para copias de seguridad o cambiar de Mac. |
| Importar configuración | Carga un archivo de configuración y lo aplica de inmediato. |
Habilidades y funciones
Las habilidades del bot son destrezas dirigidas por el modelo — instrucciones claras que el modelo sigue con sus herramientas, para que describas lo que quieres en lenguaje natural en lugar de memorizar comandos. Cada grupo tiene un interruptor maestro; las habilidades individuales se pueden activar o desactivar.
| Grupo | Habilidades | Prueba a decir |
|---|---|---|
| Investigación | stock-research, stocks-crypto, insider-trading, currency | "investiga TSLA", "precio de BTC", "operaciones de iniciados de AAPL", "¿cuánto son 50 USD en CAD?" |
| Diario | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | "/briefing", "resume este chat", "recuérdame a las 5pm", "marca el hábito de hoy", "revisión semanal", "/pomodoro 25", "apunta 25 de almuerzo" |
| Multimedia | media, voice, translation, feeds | "analiza este vídeo", "léelo en voz alta", "tradúcelo al español", "¿qué hay de nuevo en mis fuentes?" |
| Herramientas | memory | "¿de qué hablamos ayer?" |
| Del registro | Habilidades que instalas desde el registro | — |
Registro de habilidades
La pestaña Registro te deja instalar habilidades listas del catálogo público anthropics/skills — manejo de PDF y documentos, hojas de cálculo, presentaciones, pruebas de apps web, construcción de servidores MCP, arte y más. Carga el catálogo, elige una habilidad y aparece en la pestaña Habilidades y funciones como cualquier otra.
Actualizaciones
La pestaña Actualizaciones compara el manifiesto del sitio con tu versión instalada y muestra la última versión con un enlace de descarga. Las comprobaciones son silenciosas — offline o inalcanzable solo significa "estás al día". Para actualizar: descarga el nuevo .dmg y arrástralo sobre la app antigua en Aplicaciones. Los ajustes, los bots y los recuerdos viven fuera de la app, así que se conservan intactos.
Datos y privacidad
- Dónde viven las cosas: configuración, memoria de chat, recordatorios, habilidades y registros se quedan en tu carpeta de datos (por defecto ~/.mlx-serve).
- Qué sale de tu Mac: la propia API de Telegram, el servidor de modelos al que apuntes el bot, y estadísticas de uso anónimas (aperturas de la app y acciones de menú). Sin contenido de chat, sin tokens, sin datos personales.
Solución de problemas
- "Apple no puede comprobar si contiene software malicioso" — es normal: haz clic derecho (Control-clic) en la app en Aplicaciones → Abrir → Abrir otra vez. Una vez, y luego funciona con normalidad.
- El bot no responde. Abre Ajustes → la página del bot: ¿está bien el token? Luego Valores por defecto → Modelo → Probar el proveedor. Después revisa el registro (barra de menús → Registros, o pestaña App → Abrir registro).
- Las respuestas son lentas o el bot se calla. Los proveedores gratuitos pueden tardar más de un minuto — sube el tiempo de espera de API y añade modelos de respaldo para que el bot cambie cuando el principal limite.
- El servidor local no responde. Asegúrate de que el servidor está realmente en marcha (mlx-serve, Ollama…) antes de probar en la pestaña Modelo.
- Actualizaciones dice "estás al día" de forma rara. La comprobación es silenciosa a propósito — si el manifiesto no es alcanzable, informa de que estás al día.
- ¿Algo más? Enviar comentarios — cada mensaje llega al Telegram del desarrollador y recibe una respuesta real.
Descargar Telebot AI · ¿Te gusta? Invítame a un café ☕