ClawHub

Colmena Manager

Other

Manage and monitor multiple OpenClaw agents simultaneously, including status checks, messaging, logs, pausing, resuming, and workspace management.

Install

openclaw skills install colmena-manager

🐺 Colmena Manager

Skill para gestionar y coordinar agentes de OpenClaw como una colmena.

📋 Descripción

Colmena Manager permite monitorear, comunicar y gestionar todos los agentes de la colmena desde una única interfaz. Ideal para mantener el control de múltiples instancias de OpenClaw corriendo en diferentes workspaces o contextos.

🔧 Comandos CLI

status [agent]

Muestra el estado de todos los agentes o uno específico.

Opciones:

  • agent (opcional): ID del agente específico a consultar

Ejemplo:

colmena-manager status
colmena-manager status main

broadcast <msg>

Envía un mensaje a todos los agentes de la colmena.

Ejemplo:

colmena-manager broadcast "Reunión de sincronización en 10 minutos"

logs <agent> [lines]

Muestra las últimas líneas del log de un agente.

Opciones:

  • agent (requerido): ID del agente
  • lines (opcional, default: 50): Número de líneas a mostrar

Ejemplo:

colmena-manager logs vision --last 100
colmena-manager logs healer 25

pause <agent>

Pausa temporalmente un agente.

Ejemplo:

colmena-manager pause nemotron

resume <agent>

Reanuda un agente previamente pausado.

Ejemplo:

colmena-manager resume vision

health-check

Realiza una verificación completa del estado de salud de todos los agentes (procesos, sesiones, memoria).

Ejemplo:

colmena-manager health-check

workspace

Comandos para gestionar workspaces de agentes:

  • workspace list: Lista todos los workspaces disponibles
  • workspace create <name>: Crea un nuevo workspace
  • workspace remove <name>: Elimina un workspace

Ejemplo:

colmena-manager workspace list
colmena-manager workspace create project-x
colmena-manager workspace remove old-workspace

🔌 Integración con OpenClaw APIs

La skill utiliza las siguientes APIs nativas:

  • agents_list(): Descubre todos los agentes registrados
  • sessions_list(): Consulta sesiones activas por agente
  • sessions_send(): Envía comandos/mensajes a agentes específicos
  • message(): Para broadcasts externos a través de canales
  • exec / process: Para health checks y diagnósticos del sistema

🔄 HEARTBEAT.md

La skill incluye un archivo HEARTBEAT.md que se ejecuta automáticamente cada 30 minutos para:

  • Verificar el estado de todos los agentes
  • Detectar agentes caídos
  • Monitorear uso de memoria
  • Generar reportes de salud

Esto permite mantener la colmena vigilada sin intervención manual.

📦 Instalación

# Instalar desde clawhub
clawhub install colmena-manager

# O desde el directorio fuente
npm install /path/to/colmena-manager

🚀 Publicación

Para publicar una nueva versión en clawhub.com:

cd colmena-manager
clawhub publish

📁 Estructura del proyecto

colmena-manager/
├── package.json
├── claws.json          # Manifiesto para clawhub
├── SKILL.md            # Documentación (este archivo)
├── README.md           # Detalles técnicos
├── src/
│   └── index.js        # Implementación principal
└── HEARTBEAT.md        # Scripts automáticos de monitoreo

🔄 Compatibilidad

  • OpenClaw >= 1.0.0
  • Node.js >= 18
  • Linux/macOS/Windows

📝 Ejemplos de uso

1. Monitorizar toda la colmena

colmena-manager status

2. Ver logs de un agente

colmena-manager logs main 100

3. Broadcast urgente

colmena-manager broadcast "SISTEMA EN MANTENIMIENTO - PAUSA INMINENTE"

4. Health check programado

# Agregar a cron cada 30min
*/30 * * * * colmena-manager health-check >> /var/log/colmena-health.log

⚠️ Consideraciones

  • Los agentes deben estar corriendo y registrados para que los comandos funcionen
  • pause y resume envían señales que cada agente debe manejar individualmente
  • Los workspaces son directorios locales bajo /home/nvi/.openclaw/workspace-*
  • Asegurar permisos de ejecución en el script principal