← 返回 Skills 市场
lunaviva211-sketch

Colmena Manager

作者 lunaviva211-sketch · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
224
总下载
0
收藏
1
当前安装
3
版本数
在 OpenClaw 中安装
/install colmena-manager
功能描述
Manage and monitor multiple OpenClaw agents simultaneously, including status checks, messaging, logs, pausing, resuming, and workspace management.
使用说明 (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
安全使用建议
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.
功能分析
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.
能力评估
ℹ 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.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install colmena-manager
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /colmena-manager 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
Slug colmena-manager
版本 1.0.2
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 3
常见问题

Colmena Manager 是什么？

Manage and monitor multiple OpenClaw agents simultaneously, including status checks, messaging, logs, pausing, resuming, and workspace management. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 224 次。

如何安装 Colmena Manager？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install colmena-manager」即可一键安装，无需额外配置。

Colmena Manager 是免费的吗？

是的，Colmena Manager 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Colmena Manager 支持哪些平台？

Colmena Manager 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Colmena Manager？

由 lunaviva211-sketch（@lunaviva211-sketch）开发并维护，当前版本 v1.0.2。

推荐 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.
⬇ 191113 · 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

💬 留言讨论