TeleClaude para Claude Code en Telegram

# TeleClaude: Bot de Telegram Autoalojado para Sesiones Aisladas de Claude Code

Tras el cierre de OpenClaw, los desarrolladores perdieron el acceso a Claude Code a través de Telegram. TeleClaude lo soluciona: una app en TypeScript sobre Bun que lanza procesos locales del CLI de Claude Code, enrutan los mensajes de temas de supergrupos a directorios de proyectos aislados. Usa autenticación OAuth de tu propia suscripción a Claude, sin intermediarios.

Arquitectura y Enrutamiento

TeleClaude se integra con la API de Bots de Telegram mediante Grammy. Cada mensaje de un tema de supergrupo genera un proceso dedicado de Claude Code con su propia carpeta de proyecto. Soporta continuidad de sesiones, compresión de contexto y desduplicación de memoria.

API de Bots de Telegram → Enrutador Grammy → Gestor de Procesos → CLI de Claude Code (por tema)

Componentes clave:

• Enrutamiento basado en temas con inyección de contexto.
• Gestor de procesos con TTL, límites de concurrencia y limpieza.
• Memoria basada en archivos: SOUL.md (personalidad), main-memory.md (base de conocimiento compartida), topic-memory.md (historial del proyecto).

Sistema de Memoria y Niveles

La memoria se estructura en tres niveles para preservar el contexto entre sesiones:

project/
├── SOUL.md              # Estilo de comunicación, reglas
├── main-memory.md       # Enlace simbólico a base de conocimiento compartida
├── topic-memory.md      # Historial del proyecto con actualización automática
└── memory/
    ├── people/
    ├── services/
    ├── shared/
    └── projects/

Claude Code actualiza topic-memory.md por sí solo. Al reiniciar o resetear la sesión, el contexto se recarga desde los archivos. La desduplicación elimina periódicamente duplicados entre archivos.

Automatización de Proyectos y Compresión

Un nuevo tema en el supergrupo crea automáticamente un directorio desde plantillas/. El bot enlaza SOUL.md, main-memory.md e inicializa la memoria. El primer mensaje arranca Claude Code con el contexto completo listo.

La compresión se activa cerca de los límites de contexto: hechos clave se guardan en memoria, sesión se resetea. Usa /compact para activarla manualmente.

Funciones de TeleClaude

• Enrutamiento por Temas: Procesos y directorios aislados.
• Memoria Persistente: Tres niveles con acceso entre proyectos.
• Creación Automática de Proyectos: Plantillas para nuevos temas.
• Mensajes de Voz: Transcripción local con Whisper opcional.
• Streaming: Indicador de escritura y actualizaciones incrementales.
• Modelos: Opus, Sonnet, Haiku o locales vía Claude Code.
• Gestión: TTL, límites, terminación de procesos.

Instalación y Configuración

Requisitos: Bun 1.0+, CLI de Claude Code autorizado, bot de Telegram, supergrupo con temas.

git clone https://github.com/devladpopov/teleclaude.git
cd teleclaude
bun install
cp .env.example .env
cp config/settings.example.json config/settings.json
bun run start

En settings.json, configura allowedUsers, ttlMinutes (por defecto 30), maxConcurrent (5), claudePath.

Comandos del Bot

| Comando | Descripción |

|---------|-------------|

| /help | Lista de comandos |

| /status | Procesos activos, estado |

| /ttl N | Tiempo de inactividad (1–1440 min) |

| /name <nombre> | Renombrar tema |

| /reset | Resetear preservando memoria |

| /kill | Detener proceso del tema |

| /memory | Estadísticas de memoria |

TeleClaude vs OpenClaw

| Aspecto | TeleClaude | OpenClaw |

|--------|------------|----------|

| Alojamiento | Autoalojado | Nube |

| Backend | CLI de Claude Code | API |

| Autenticación | Tu suscripción OAuth | Gestionada |

| Coste | Solo suscripción Claude | Tarifas extra |

| Memoria | Basada en archivos, persistente | Integrada |

Aspectos Destacados

• Aislamiento total por temas sin cambiar de ventana.
• Autoalojado, sin costes más allá de la suscripción a Claude.
• Compresión automática y recuperación de contexto.
• Soporte para voz vía Whisper y respuestas en streaming.
• Licencia MIT, plantillas y configuraciones personalizables.

— Editorial Team