TinyClaw: Equipos de IA multiagente para Discord, WhatsApp y Telegram

TinyClaw: Un Marco Multia​gesto de Agentes IA

1. ¿Qué es TinyClaw?

TinyClaw es una herramienta impulsada por la comunidad, con licencia MIT que convierte unos pocos proveedores IA (Claude, OpenAI, etc.) en un equipo de agentes. Cada agente funciona en su propio espacio de trabajo aislado, mantiene su propio historial de conversación y puede delegar tareas a compañeros de trabajo mediante un sencillo sistema de comandos basado en prefijos. El nombre TinyClaw refleja la idea de que el código pequeño aún puede gestionar una colaboración compleja.

Conceptos clave: - Agente – una única instancia IA con un rol definido. - Equipo – un grupo de agentes encadenados o que se bifurcan al procesar una consulta. - Canal – donde los agentes reciben mensajes (Discord, WhatsApp, Telegram, heartbeat).

Todo el trabajo pesado lo hace la CLI y archivos de configuración JSON simples, para que puedas ejecutar TinyClaw en macOS, Linux o Windows con WSL‑2.

2. Características principales

3. Visión general de la arquitectura

La arquitectura de TinyClaw es intencionadamente simple, lo que facilita depurar o extenderla:

1. Canales – Los bots escuchan mensajes entrantes y escriben un archivo JSON en ~/.tinyclaw/queue/incoming/.
2. Procesador de cola – Un watchdog que mueve cada archivo a processing/, luego lo despacha al agente correspondiente.
3. Agentes – Cada agente opera en su propio directorio aislado bajo ~/tinyclaw-workspace/<agent_id>/. El agente usa el CLI del proveedor configurado (el claude de Claude o el codex de OpenAI).
4. Persistencia – Las conversaciones y estado del agente viven dentro del directorio de trabajo. Al apagar, la cola basada en archivos se limpia, pero los logs permanecen.
5. Visualización – tinyclaw team visualize <id> abre una UI estilo curses que muestra el historial de mensajes en vivo y el estado del agente.

Este flujo mantiene el sistema determinista mientras permite un alto rendimiento.

4. Guía rápida de inicio

Abajo tienes una configuración paso a paso que pone en marcha una instancia TinyClaw en minutos.

Requisitos previos – macOS/Linux/WSL2 con Node v18+, tmux, jq, un Bash 4.0+ (macOS: brew install bash), CLI de Claude Code y Codex CLI.

4.1 Instalación de una sola línea (recomendado)

curl -fsSL https://raw.githubusercontent.com/jlia0/tinyclaw/main/scripts/remote-install.sh | bash

4.2 Construcción manual desde fuente

git clone https://github.com/jlia0/tinyclaw.git
cd tinyclaw
npm install
./scripts/install.sh

4.3 Primer ejecución y asistente de configuración

tinyclaw start   # Inicia la sesión Tmux y el asistente interactivo

Al terminar, TinyClaw arrancará su demonio y podrás interactuar desde cualquier canal conectado.

5. Configuración de agentes y equipos

La configuración de agentes y equipos se guarda en ~/.tinyclaw/settings.json.

5.1 Ejemplo de configuración

{
  "channels": {
    "enabled": ["discord", "telegram", "whatsapp"],
    "discord": { "bot_token": "YOUR_DISCORD_TOKEN" },
    "telegram": { "bot_token": "YOUR_TELEGRAM_TOKEN" },
    "whatsapp": {}
  },
  "workspace": {
    "path": "/Users/me/tinyclaw-workspace",
    "name": "tinyclaw-workspace"
  },
  "agents": {
    "assistant": {
      "name": "Assistant",
      "provider": "anthropic",
      "model": "sonnet",
      "working_directory": "/Users/me/tinyclaw-workspace/assistant"
    },
    "coder": {
      "name": "Code Assistant",
      "provider": "anthropic",
      "model": "sonnet",
      "working_directory": "/Users/me/tinyclaw-workspace/coder"
    }
  },
  "teams": {
    "dev": {
      "name": "Development Team",
      "agents": ["coder", "reviewer"],
      "leader_agent": "coder"
    }
  },
  "monitoring": {
    "heartbeat_interval": 3600
  }
}

5.2 Añadiendo nuevos agentes

tinyclaw agent add

5.3 Eliminando agentes y equipos

tinyclaw agent remove coder
tinyclaw team remove dev

6. Guías de configuración de canales

• Discord – Crea un bot en el Portal de Desarrolladores, habilita Message Content Intent y pega el token.
• Telegram – Usa BotFather para crear un bot y obtener su token.
• WhatsApp – Tras el arranque, escanea el código QR que aparece en la terminal.

Consulta el directorio docs para obtener capturas completas e instrucciones detalladas.

7. Uso de la CLI

La CLI de TinyClaw tiene docenas de comandos. A continuación los más comunes: | Comando | Propósito | |---------|-----------| | tinyclaw start/stop/restart | Controla el daemon. | | tinyclaw status | Muestra procesos y agentes actuales. | | tinyclaw setup | Re‑ejecuta el asistente para cambiar la configuración. | | tinyclaw logs <type> | Muestra logs (discord, whatsapp, queue, etc.). | | tinyclaw attach | Se une a la sesión Tmux en ejecución. | | tinyclaw agent list | Ve los agentes configurados. | | tinyclaw team visualize <id> | Abre el panel en vivo. | | tinyclaw update | Se actualiza automáticamente desde GitHub releases. |

7.1 Comandos en chat

Cuando un usuario envía un mensaje a través de un canal, los siguientes prefijos se aplican: - @agent_id <msg> – dirige a un agente específico. - @team_id <msg> – reenvía al líder del equipo. - /agent y /team – listan agentes o equipos disponibles.

Un mensaje sin prefijo se envía al agente predeterminado.

8. Funcionalidades avanzadas

8.1 Monitorización del heartbeat

Los agentes pueden programarse para realizar “check‑ins” rutinarios editando ~/tinyclaw-workspace/<agent_id>/heartbeat.md. El prompt predeterminado es:

Check for:
1. Pending tasks
2. Errors
3. Unread messages
Take action if needed.

8.2 Emparejamiento de remitentes

Para evitar spam, TinyClaw genera un código de emparejamiento en el primer mensaje de un remitente desconocido. El código debe aprobarse mediante tinyclaw pairing approve <code>.

8.3 Visualización de equipos

Ejecutar tinyclaw team visualize dev abre una UI de curses que muestra los mensajes pendientes de cada agente en tiempo real, lo que facilita la depuración y observación de la conversación IA.

9. Casos de uso

1. Asistente AI personal – Recuerda tareas, gestiona listas de pendientes y agenda eventos.
2. Pipeline de revisión de código – @coder corrige un error, @reviewer verifica el estilo, y el resultado se envía de regreso al usuario.
3. Generador de documentación – @writer crea documentos API a partir de comentarios de código.
4. Presencia multi‑canal – Una conversación accesible simultáneamente desde Discord, WhatsApp o Telegram.

10. Comunidad y contribuciones

TinyClaw está abierto a contribuciones. El repositorio principal en GitHub tiene 2.2k estrellas y 318 forks. Canales comunitarios: - Discord – https://discord.com/invite/jH6AcEChuD - Issues de GitHub – reporta bugs o sugiere funcionalidades.

El proyecto sigue un flujo CI sencillo: las pruebas se ejecutan en cada PR, y el proceso de lanzamiento se automatiza mediante GitHub Actions. Los nuevos colaboradores pueden empezar eligiendo issues abiertos o agregando documentación.

11. Licencia y créditos

Licencia MIT. TinyClaw se inspiró en OpenClaw y aprovecha las CLIs de Claude Code y Codex, además de bibliotecas populares de Node: discord.js, whatsapp-web.js, node-telegram-bot-api.

12. Conclusión

TinyClaw ofrece un entorno plug‑and‑play para experimentar con una orquestación sofisticada de agentes sin la sobrecarga de un stack enorme. Su huella diminuta oculta un rico conjunto de funcionalidades que permiten a los desarrolladores crear flujos de trabajo centrados en chat, integrar múltiples modelos IA y monitorear conversaciones en vivo. Prueba hoy mismo – con una instalación de una sola línea, tendrás un asistente AI multipropósito multiplataforma operando en minutos. ¡Feliz hacking!