Un marco estandarizado basado en eventos para que los agentes de AI comuniquen el progreso de la construcción y soliciten comentarios del usuario sin jerga técnica.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install communication-protocol
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar communication-protocol usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es Protocolo de Comunicación?
El Protocolo de Comunicación es un marco crítico diseñado para agilizar la interacción entre los agentes de AI y los usuarios dentro del ecosistema de Openclaw Skills. Reemplaza los chats desordenados y de formato libre con eventos de pasos estructurados y transiciones de ciclo de vida claras, asegurando que la interfaz de usuario se mantenga limpia y profesional. Al imponer una preferencia de baja verbosidad, el protocolo oculta los detalles de orquestación interna y se centra en ofrecer información de alto valor y procesable al desarrollador.
Esta skill es esencial para cualquier persona que cree Openclaw Skills sofisticados que requieran tareas de larga duración, seguimiento del progreso en varios pasos o bucles complejos de entrada del usuario. Define un contrato estricto para la entrega de mensajes, el manejo de errores y la gestión de sesiones, lo que permite que el frontend renderice una línea de tiempo hermosa y predecible del trabajo del agente.
Casos de uso de Protocolo de Comunicación
- Implementación de un stepper de progreso de UI profesional para tareas de generación de código impulsadas por AI.
- Gestión de conversaciones complejas de varios turnos donde el agente necesita datos estructurados específicos del usuario.
- Estandarización de informes de errores y resúmenes de éxito en diferentes Openclaw Skills.
- Reducción de la fatiga por notificaciones al pasar de actualizaciones basadas en chat a actualizaciones de eventos legibles por máquina.
Cómo funciona Protocolo de Comunicación
- El backend inicia una sesión pasando IDs únicos de build y sesión al agente a través de variables de entorno.
- El agente recibe solicitudes de usuario envueltas en encabezados de transporte, que analiza en busca de metadatos sin repetirlos al usuario.
- A medida que el agente trabaja, emite eventos progress.step.started y progress.step.completed estructurados para controlar el stepper de la UI.
- Cuando se bloquea por falta de información, el agente emite un evento question.requested o questions.requested para pausar por la entrada del usuario.
- El agente sigue una política de frecuencia estricta para garantizar que los mensajes solo se envíen cuando sean realmente útiles, concluyendo con un evento status.changed.
Configuración de Protocolo de Comunicación
Para implementar este protocolo en su desarrollo de Openclaw Skills, asegúrese de que sus variables de entorno estén correctamente mapeadas:
# Required session identifiers
export TIDY_BUILD_ID="uuid"
export TIDY_BUILD_PROMPT="User prompt text"
export TIDY_SESSION_ID="uuid"
Integre el contrato JSON de evento estándar en la lógica de salida de su agente para garantizar la compatibilidad con el wrapper de transporte del frontend.
Esquema de datos y taxonomía de Protocolo de Comunicación
El protocolo utiliza una estructura JSON canónica para todos los eventos dentro de Openclaw Skills para mantener la consistencia.
| Tipo de Evento | Descripción | Campos Clave |
|---|---|---|
| assistant.message.created | Mensaje de chat directo | text, source |
| progress.step.started | Actualiza la línea de tiempo de la UI | step_id, title, description, index |
| status.changed | Estado del ciclo de vida | status (running/complete/failed), output |
| question.requested | Bloque de entrada único | question_id, prompt, input, options |
| session.completed | Evento terminal | source |
Los step_ids estandarizados incluyen build_record, parse, research, design, assemble, validate, y finalize.
Funciones avanzadas de Protocolo de Comunicación
- Language Guardrails: Aplica automáticamente terminología amigable para el usuario, evitando que jerga técnica como 'spawning workers' aparezca en la UI.
- Cuestionamiento por lotes: Soporte para solicitudes de múltiples preguntas para minimizar la latencia de la sesión y mejorar la experiencia del usuario en Openclaw Skills.
- Reafirmación automática: Política incorporada para enviar actualizaciones de estado cortas durante tareas de larga duración (más de 45 segundos) para evitar el abandono del usuario.
- Manejo de metadados estructurados: Separa los encabezados de transporte de máquina del contenido legible por humanos para un procesamiento de mensajes limpio.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Skill Vetter
Un protocolo de seguridad riguroso diseñado para auditar y verificar la seguridad de las habilidades de los agentes de IA antes de su instalación.
ClawHub Chinese Skill Finder
Una herramienta automatizada para filtrar y resumir las últimas habilidades de AI agent en idioma chino del repositorio ClawHub.
Coze Web Search
Una herramienta de búsqueda web y de imágenes de alto rendimiento para agentes de AI que proporciona resultados estructurados y resúmenes inteligentes.
Habilidad de Gestión de Contenidos de Blog
Un kit de herramientas CLI ligero para gestionar el ciclo de vida completo del contenido de un blog, desde los borradores iniciales hasta la optimización SEO y la distribución en redes sociales.
Generador de Listas de Verificación para Incorporación de Clientes
Una herramienta dinámica que genera listas de verificación de incorporación personalizadas y multifásicas adaptadas a tipos de negocios y modelos de servicio específicos.
OpenClaw Mindcraft Controller
Un controlador REST API de alto rendimiento para gestionar bots de Minecraft mediante la orquestación de sistemas externos.
Presentado*
