📱Telegram
Habla con tus sesiones desde el móvil. Harness Maxxing incluye su propia pasarela de Telegram: no hay que instalar ningún programa adicional.
- Un bot, vinculado únicamente a tu chat privado.
- Un hilo por sesión abierta - el chat de Telegram refleja la página de Sesiones - más Crons (informes de tareas), Alertas (alertas de inicio de sesión) y Notificaciones (el feed de notificaciones: ventas, pedidos, tus scripts… según las reglas que definas, publicadas por el propio bot, con un botón Ask Harness). Un hilo se llama
<proyecto>/<tema> · <título de la sesión>, con el emoji del proyecto delante si lo tiene (menú … del proyecto en Sesiones -> Poner un emoji…), por ejemplo🛒 acme/blog · Launch plan. Si cambias el emoji, los hilos se renombran. - Un hilo es la propia sesión: lo que escribes en el móvil aparece en la interfaz web y puedes continuar allí, y al revés.
- Escribe en el chat principal (o crea un hilo) para empezar una sesión nueva: el bot te pregunta en qué tema.
Configuración (Ajustes -> Telegram)
- En Telegram, abre @BotFather, envía
/newbot, elige un nombre y un nombre de usuario que termine enbot. Copia el token que te da (123456789:AA...). - En BotFather, abre los ajustes de tu bot y activa los temas (hilos) para los chats privados, de modo que cada sesión abierta tenga su propio hilo. Sin esto, todo funciona en el chat principal (usa
/topicpara elegir con qué tema habla). - Pega el token en Ajustes -> Telegram. El servidor lo comprueba.
- Haz clic en Vincular, abre en tu móvil el enlace
t.me/<bot>?start=<code>y pulsa Start. El código es válido durante 15 minutos. A partir de ese momento, los mensajes de cualquier otro chat se ignoran. - Haz clic en Sincronizar hilos (después es automático: mira más abajo).
- Elige las opciones: informes de crons, alertas de inicio de sesión, inicio de sesión en dos pasos, modo de respuesta (progreso en vivo, el predeterminado = un único mensaje de estado que se actualiza mientras Claude trabaja, con su lista de tareas y cada paso, y que se reduce a un resumen al final; respuesta final = solo la respuesta). Pulsa Enviar prueba.
Hilos = sesiones abiertas
| Tú haces | Telegram |
|---|---|
| Abrir o iniciar una sesión en la interfaz web | su hilo aparece (unos segundos después) |
| Renombrar una sesión | su hilo se renombra |
Archivar una sesión (menú de la sesión -> Archivar), o enviar /close en su hilo |
su hilo se elimina - la conversación permanece en la interfaz web (Archivadas) |
| Desarchivarla | el hilo vuelve (nuevo, vacío) |
| Escribir en el chat principal | el bot pregunta dónde (botones de temas); la sesión se crea allí con su propio hilo y tu mensaje va a ella. Si no respondes en 5 minutos: general/inbox |
| Crear tú mismo un hilo | la misma pregunta; ese hilo pasa a ser el hilo de la sesión |
| Eliminar un hilo a mano en Telegram | la sesión sigue abierta (Telegram no avisa a los bots) y recibe un hilo nuevo la próxima vez que se use - por ejemplo, si escribes en ella desde la interfaz web. Para cerrarla de verdad: /close |
| Escribir en una sesión desde la interfaz web | opcional (desactivado por defecto): Ajustes -> Telegram -> Mostrar las conversaciones web en Telegram copia tu mensaje ("🖥 …") y la respuesta de Claude en su hilo, en silencio; la campana de la sesión hace que sus respuestas suenen en el móvil |
Sesiones reflejadas: aquellas con las que hablas (no las iniciadas por tareas programadas - sus informes van a Crons), no archivadas, activas en los últimos 30 días (Ajustes -> Telegram -> Mantener un hilo durante: 7, 14, 30 o 90 días), como máximo 50. Una sesión más antigua recupera su hilo simplemente cuando se vuelve a usar. La sincronización se ejecuta unos segundos después de cualquier cambio y cada 10 minutos; no hay nada que programar. Si Telegram se niega a eliminar un hilo por un momento (demasiadas solicitudes, sin conexión), la siguiente sincronización lo elimina. Al renombrar una sesión se renombra su hilo: Telegram muestra una pequeña línea "tema renombrado" en el hilo.
Uso
- Escribe en el hilo de una sesión: Claude responde en ese hilo. Mientras trabaja ves "escribiendo…" y, para tareas más largas, el mensaje de estado en vivo.
- Envía fotos y archivos: se guardan en
<topic>/attachments/telegram/YYYY-MM/y se pasan a Claude con tu comentario. - Comandos:
| Comando | Efecto |
|---|---|
/new [title] |
nueva sesión en el mismo tema, con su propio hilo (en el chat principal: pregunta el tema) |
/sessions |
lista las sesiones abiertas |
/stop |
detiene el turno en curso |
/close |
cierra esta sesión: se archiva (se conserva en la interfaz web) y se elimina su hilo |
/model [id] |
muestra o cambia el modelo de la sesión |
/status |
estado, modelo, coste, cola, enlace a la interfaz web |
/topic |
(chat principal, hilos desactivados) elige el tema |
/help |
lista los comandos |
- La campana de una sesión (interfaz web, junto a su título): con el espejo desactivado (por defecto) publica un breve mensaje de "terminado" en el hilo de la sesión cuando termina un turno; con el espejo activado hace que las respuestas reflejadas suenen.
Inicio de sesión en dos pasos
Ajustes -> Telegram (o Ajustes -> Seguridad) -> Inicio de sesión en dos pasos: tras introducir la contraseña correcta, un navegador que aún no es de confianza espera tu aprobación en Telegram. El hilo de Alertas recibe un mensaje con la IP, el navegador, un código de 6 dígitos y dos botones:
- Permitir: la página de inicio de sesión se abre sola;
- Denegar: se rechaza el inicio de sesión - y como se escribió la contraseña correcta, cámbiala (Ajustes -> Seguridad).
Cuando los botones no responden, escribe el código del mensaje en la página de inicio de sesión. Una solicitud caduca a los 2 minutos; 5 códigos erróneos la cancelan, y tras 20 códigos erróneos en una hora en todo el servidor, los códigos se pausan durante esa hora (el botón Permitir sigue funcionando) - alguien que conozca la contraseña no puede probar códigos desde muchas direcciones. Una página de inicio de sesión abierta de nuevo sustituye a su solicitud anterior. Confiar en este navegador durante 30 días (marcado por defecto) omite el segundo paso en ese navegador; Olvidar navegadores de confianza hace que todos los demás navegadores vuelvan a preguntar (cambiar la contraseña también lo hace). Cambiar la contraseña, olvidar los navegadores o desactivar el inicio de sesión en dos pasos también cancela todas las solicitudes que sigan esperando, incluso una que hayas permitido por error.
Al activarlo se envía una primera solicitud: solo se activa una vez que la apruebas, así que un bot que no responde no puede dejarte fuera. Desvincular Telegram lo desactiva.
Telegram no responde (bot eliminado, Telegram caído, móvil perdido): en el servidor, por SSH,
maxxing 2fa off # password only again (every trusted browser is forgotten)
maxxing 2fa status # on / off
Solución de problemas
maxxing telegram status # bot, chat, threads, settings, last error
maxxing telegram test # sends a test message
| Problema | Solución |
|---|---|
| Token rechazado | revocado o mal escrito: obtén uno nuevo en BotFather (/token) y pégalo de nuevo |
| "Conflict: terminated by other getUpdates" | otro programa (un bot antiguo, otro servidor) usa el mismo bot: detenlo o crea un bot nuevo |
| Nada responde | el mensaje viene de un chat distinto al vinculado: vuelve a vincular |
| Todo cae en un solo chat | los temas no están activados para el bot en BotFather; actívalos y luego Sincronizar hilos |
| Una sesión desapareció de Telegram | archivada (en la interfaz web: árbol de Sesiones -> tema -> Archivadas), o inactiva durante más tiempo que Mantener un hilo durante - vuelve cuando la usas |
| Se eliminó un hilo especial (Crons, Alertas) | Sincronizar hilos lo vuelve a crear |
| Inicio de sesión en dos pasos: no llega ningún mensaje y no puedes iniciar sesión | en el servidor: maxxing 2fa off, y luego inicia sesión con la contraseña |
Para desconectar: Ajustes -> Telegram -> Desvincular (olvida el token y el chat).