Gateway de Telegram hacia Claude Code, Gemini CLI y OpenAI Codex CLI. Mandá mensajes, archivos o notas de voz; elegí un agente, creá agentes propios o dejá que el Root Agent orqueste equipos multi-agente.
Tres pasos. Sin configuración adicional.
Desde Telegram con @menciones, o via HTTP API desde n8n, iOS Shortcuts o cualquier script.
KrakBot enruta el mensaje al agente elegido — Claude, Gemini o Codex — en tu máquina local.
De vuelta a tu chat de Telegram, o como JSON en la respuesta HTTP — con contexto de la sesión.
Elegí el mejor para cada tarea, o creá los tuyos y dejá que el Root Agent los enrute.
Código, análisis, razonamiento complejo y edición de archivos. El más capaz para tareas de ingeniería profunda.
CLI nativoBúsquedas en tiempo real, síntesis de información y procesamiento multimodal. Ideal para investigación y resúmenes.
CLI nativoEspecializado en código y refactors quirúrgicos. Rápido y preciso para tareas de transformación de código.
CLI nativoCreá especialistas con nombre, descripción, system prompt, voz propia y CLI base. Se activan con /setagent o @mención.
/newagentArmá equipos con wizard IA, asigná modelos por rol y ejecutá tareas con revisión automática, manual o sin revisión.
/buildteamLo último de KrakBot.
Desde Telegram o via HTTP API — KrakBot arma contexto, respeta políticas, enruta al agente correcto y devuelve la respuesta donde la pediste.
Cambiá entre Claude, Gemini y Codex con /claude, /gemini, /codex o /default. También podés usar @menciones por mensaje.
Usá @claude, @gem o @codex para dirigir cada mensaje al agente exacto.
Ventana activa configurable, memoria persistente y compactación automática en LTM para conversaciones largas.
Cargá un SOUL.md como personalidad del bot, recargalo con /reloadsoul o saltalo una vez con /skip.
Guardá notas y el bot las recuerda entre sesiones. Tu contexto siempre disponible.
Corre en tu máquina. Tus datos nunca salen de tu entorno. Control total, zero vendor lock-in.
Mandá un audio por Telegram. KrakBot lo transcribe y se lo pasa a tu agente.
Creá agentes especializados con system prompt, descripción, voz TTS y CLI base. Editalos con /editagent cuando cambie el trabajo.
El Root Agent lee tus agentes y equipos, después elige el mejor destino con /auto o con /automode activado.
Organizá agentes en equipos con roles: coordinator, worker y reviewer. Creá el equipo con /buildteam y el wizard IA arma la estructura por vos.
Activá "Ver diálogo interno" al lanzar una tarea y mirá en tiempo real la conversación entre coordinator, worker y reviewer.
Historial completo con estados: pendiente, en curso, en revisión, completada, fallida. Consultá cualquier tarea con /taskstatus <id>.
Usá /cost para ver el consumo estimado de tokens de la sesión cuando trabajás con Claude.
El bot puede responder en audio. /voicemode para respuestas solo voz, /ttsbutton para un botón 🔊 al pie de cada mensaje.
24 voces Neural en 12 idiomas via /ttsvoice. Selector en 2 pasos: idioma → voz. Cada agente custom puede tener la suya.
Adjuntá imágenes, PDFs, texto o código. Los binarios van a Claude; Gemini y Codex aceptan archivos de texto.
Exponé una API REST local para que n8n, iOS Shortcuts o cualquier script llamen a KrakBot directamente. Fire-and-poll o streaming SSE. Opt-in: solo arranca si configurás HTTP_PORT.
Importá el atajo oficial de KrakBot en tu iPhone o iPad. Configuralo con tu IP y API Key en segundos — hablale a tus agentes de IA desde cualquier pantalla.
Accedé al gateway desde cualquier dispositivo de tu red privada sin abrir puertos. Tailscale actúa como proxy seguro entre tu iPhone, n8n y el servidor donde corre KrakBot.
API REST local para n8n, iOS Shortcuts y scripts. Opt-in, sin cloud.
El HTTP Gateway expone una API REST en tu máquina local. Otros procesos — n8n, scripts, iOS Shortcuts — pueden enviar mensajes a tus agentes de IA sin pasar por Telegram. Es completamente opt-in: si no configurás HTTP_PORT en el .env, el gateway no arranca.
O configuralo directamente desde Telegram con /config_gateway.
| Método | Ruta | Descripción |
|---|---|---|
GET | /health | Health check — sin auth requerida |
POST | /session | Crear sesión persistente |
POST | /message | Enviar mensaje al agente → devuelve task_id |
GET | /task/:id | Consultar estado de una tarea |
GET | /task/:id/stream | Streaming en tiempo real (SSE) |
Incluí el header X-API-Key en cada request. Es requerido solo cuando HTTP_API_KEY está definido en el .env. Sin esa variable, el gateway corre sin auth — recomendado solo para localhost.
Importá el atajo oficial de KrakBot en tu iPhone o iPad y reemplazá las dos variables:
| Variable | Valor |
|---|---|
TU_IP_AQUI | http://<tailscale-ip>:3000 |
TU_API_KEY_AQUI | La API Key configurada en .env |
En la acción Get contents of URL, configurá el método POST, agregá el header X-API-Key y el body JSON con agent y message.
Podés configurar el gateway sin tocar el .env directamente desde el bot:
/config_gateway al bot.env y reinicia automáticamenteConstruido para entornos reales. Sin compromisos.
Los procesos CLI hijo solo reciben las variables estrictamente necesarias. TELEGRAM_TOKEN y claves del bot nunca llegan a los agentes.
CHILD_ENV_EXTRA
Límite configurable de requests por ventana de tiempo. Evita abusos sin bloquear usuarios legítimos.
RATE_LIMIT_MAX · RATE_LIMIT_WINDOW_SECONDS
Todos los eventos de seguridad se registran en data/logs/audit.log como JSON lines — autenticación, rate limit, path traversal y más.
data/logs/audit.log
Los adjuntos de Telegram se verifican contra el directorio de uploads antes de escribirse al disco. Cualquier intento de escape queda bloqueado y logueado.
path.resolve() · uploads/
Sesiones y memorias se guardan cifradas con AES-256-GCM. Se activa con SESSION_SECRET. Retrocompatible — los archivos existentes se migran automáticamente.
SESSION_SECRET · AES-256-GCM
Archivos Markdown en data/policies/ inyectados en el contexto de cada agente. Soporta política global y por agente. Editables con /policy desde Telegram.
/policy · data/policies/
Cada agente soporta sus propios módulos. Elegí el tuyo y expandí las capacidades de KrakBot.
Un comando. Un wizard. Sin tocar código.
Abre un wizard visual en el browser — no hace falta saber de programación.
Te guía paso a paso para configurar tu bot de Telegram y los agentes.
bootstrap.ps1
Descargá el ZIP desde GitHub y ejecutá el script de PowerShell.
npm run setup
Cloná el repo y ejecutá el setup directamente desde la raíz del proyecto.
cp .env.example .env
Editá el token y la config, instalá dependencias con npm install y arrancá con npm start.
Copiá esto en BotFather → /mybots → Edit Bot → Edit Commands