← Back to Skills Marketplace
lunaviva211-sketch

Colmena Manager

by lunaviva211-sketch · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
224
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install colmena-manager
Description
Manage and monitor multiple OpenClaw agents simultaneously, including status checks, messaging, logs, pausing, resuming, and workspace management.
README (SKILL.md)

🐺 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 \x3Cmsg>

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

Ejemplo:

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

logs \x3Cagent> [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 \x3Cagent>

Pausa temporalmente un agente.

Ejemplo:

colmena-manager pause nemotron

resume \x3Cagent>

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 \x3Cname>: Crea un nuevo workspace
  • workspace remove \x3Cname>: 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
Usage Guidance
This skill generally does what its name says (manage a group of OpenClaw agents), but I recommend NOT installing it into production without review. Key concerns: (1) Several exec() shell commands build command lines by concatenating agent IDs or workspace names directly—this can lead to command injection if those values are controlled or malformed. (2) The skill performs destructive filesystem operations (rm -rf on workspaces) and reads files under /home/nvi/.openclaw; verify the hard-coded path and ensure the process runs with least privilege. (3) SKILL.md mentions a HEARTBEAT.md that runs every 30 minutes but that file is not present—verify how periodic checks will actually be scheduled (cron vs. built-in). (4) The source has some runtime/formatting issues (TypeScript-like 'interface' in a JS file and a likely syntax error in the healthCheck repeat line), suggesting it may fail or behave unexpectedly. Before installing: review and sanitize all uses of exec/command construction, remove or protect destructive operations, confirm scheduling behavior, test in an isolated sandbox, and consider requesting a fixed, configurable workspace path instead of /home/nvi. If you lack the ability to audit the code, treat this skill as risky.
Capability Analysis
Type: OpenClaw Skill Name: colmena-manager Version: 1.0.2 The skill provides administrative management for OpenClaw agents but contains multiple critical shell injection vulnerabilities in src/index.js. Specifically, the functions workspaceRemove, workspaceCreate, logs, and checkMemory use unsanitized template literals within exec() calls (e.g., rm -rf /home/nvi/.openclaw/workspace-${name}), allowing for arbitrary command execution if agent IDs or workspace names are manipulated. While these features align with the stated purpose of a management tool, the lack of input validation is a significant security flaw.
Capability Assessment
ℹ Purpose & Capability
The name/description (manage/monitor OpenClaw agents) align with the APIs and operations used (agents_list, sessions_list, sessions_send, message, exec/process). However the implementation uses hard-coded local paths (/home/nvi/.openclaw/...), direct filesystem manipulation (mkdir, rm -rf), and shell commands; those are plausible for workspace management but the hard-coded user path and destructive file operations are surprising and deserve scrutiny.
⚠ Instruction Scope
SKILL.md and the code instruct the agent to run many shell commands (tail, ls, ps, awk, mkdir, rm -rf). Several commands interpolate agent IDs or user-provided workspace names directly into shell commands (possible command injection). SKILL.md also claims a HEARTBEAT.md runs automatically every 30 minutes, but that file is not present in the manifest; the docs suggest scheduling cron jobs, which would make periodic/automatic execution possible — this scheduling and the broad file-system/process checks expand scope beyond one-off management actions.
ℹ Install Mechanism
No install spec in registry (instruction-only), and install instructions are just normal clawhub/npm commands. There are no remote downloads or extract-from-URL steps. This is low installation risk, but the package contains executable JS code that will be installed with the skill (no build or validation step).
⚠ Credentials
The skill declares no required credentials (good), but it performs privileged local actions: reading logs under /home/nvi/.openclaw/sessions/*, listing and removing workspace directories, and running process inspection commands. Those operations are proportionate to agent management but require filesystem and process access; combined with unsanitized shell interpolation they create a path for command injection or accidental destructive operations. The hard-coded /home/nvi path is also brittle and unexpected.
⚠ Persistence & Privilege
always:false (ok). However SKILL.md asserts a HEARTBEAT.md will be executed every 30 minutes (and suggests cron), implying periodic autonomous execution. The repository does not include HEARTBEAT.md in the manifest, so there's an inconsistency: either the skill expects to be scheduled externally (user-added cron) or claims an automatic heartbeat that isn't present. Periodic execution plus unmanaged shell commands and rm -rf increases risk if enabled by the user.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install colmena-manager
  3. After installation, invoke the skill by name or use /colmena-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Documentación CLI mejorada y unificada en SKILL.md, con aclaraciones y ejemplos para cada comando. - Añadidas secciones detalladas sobre integración con APIs de OpenClaw y HEARTBEAT.md. - Nueva guía de instalación, publicación y estructura de proyecto en la documentación. - SKILL.md reorganizado para mayor claridad en compatibilidad, uso y advertencias. - README.md y archivos de manifiesto actualizados para mayor coherencia con las nuevas directrices.
v1.0.1
- Major refactor: streamlined project structure, removed legacy files, and updated documentation. - Added main source entry at src/index.js and project config via claws.json. - Updated and expanded SKILL.md with improved usage examples, API, configuration, and clearer CLI commands. - Removed obsolete build files (TypeScript and dist outputs) for a cleaner, JavaScript-only setup. - Updated dependencies and metadata in package.json to reflect current implementation.
v1.0.0
Initial release of colmena-manager. - Manage and coordinate multiple OpenClaw agents as a hive. - Monitor agent status, view recent logs, pause/resume agents, and send broadcast messages. - Run health checks for all monitored agents, configurable for automatic periodic execution. - Workspace management commands: list, create, and remove. - Optional configuration via ~/.openclaw/config.json. - Automatic integration with HEARTBEAT.md for centralized health monitoring.
Metadata
Slug colmena-manager
Version 1.0.2
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is Colmena Manager?

Manage and monitor multiple OpenClaw agents simultaneously, including status checks, messaging, logs, pausing, resuming, and workspace management. It is an AI Agent Skill for Claude Code / OpenClaw, with 224 downloads so far.

How do I install Colmena Manager?

Run "/install colmena-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Colmena Manager free?

Yes, Colmena Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Colmena Manager support?

Colmena Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Colmena Manager?

It is built and maintained by lunaviva211-sketch (@lunaviva211-sketch); the current version is v1.0.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments