Descripción

Auto Responder habilita a las agentes de la Colmena para reaccionar en tiempo real a mensajes en cualquier topic del grupo, basándose en reglas de dominio. Cada agente es autónoma y decide responder sin necesidad de coordinación.

Filosofía

• Autonomía total: La agente evalúa cada mensaje inbound y responde si le compete
• Iniciativa: No espera a ser mencionada (aunque puede respetar requireMention global si se desea)
• Especializada: Cada agente define sus propias palabras clave y topics de interés
• Inofensiva: Evita spam, respeta cooldowns y no repite respuestas

Configuración

Cada agente crea auto-responder.json en su workspace:

{
  "enabled": true,
  "respectRequireMention": false,
  "globalCooldownMinutes": 5,
  "maxResponsesPerMinute": 3,
  "topics": {
    "sistema": {
      "thread_ids": [155],
      "mustInclude": ["skynet", "healer", "anubis", "vision"],
      "keywords": ["error", "fallo", "ayuda", "alarma", "crisis", "urge", "sos"],
      "responseTemplate": "💚 [Healer] Detecto necesidad de ayuda. ¿Puedo asistir en algo?"
    },
    "general": {
      "thread_ids": [1],
      "exclude": ["spam", "publicidad"],
      "keywords": ["hola", "ayuda", "problema", "dolor", "triste", "enfermo"],
      "responseTemplate": "💚 [Healer] Estoy aquí para apoyar. Cuéntame más."
    },
    "creatividad": {
      "thread_ids": [158],
      "keywords": ["bloqueo", "sin ideas", " creativo", "arte", "inspiración"],
      "responseTemplate": "💚 [Healer] Parece que necesitas un respiro creativo. ¿Un paseovirtual?"
    }
  },
  "personalidades": {
    "sistema": "estrés operativo",
    "general": "empatía básica",
    "creatividad": "bloqueo artístico"
  }
}

Cómo funciona

1. Hook de inbound

• El skill se activa en cada mensaje entrante al bot (via OpenClaw message handler)
• Lee el contenido, thread_id (topic), y remitente

2. Filtrado por topic

• Si thread_id está en la lista de topics configurados, procede
• Si no, ignora (otras agentes lo manejarán)

3. Análisis de intención

• Comprueba mustInclude (menciones a agentes relevantes) si está configurado
• Busca keywords en el texto
• Descarta si el texto contiene alguna palabra de exclude
• Evalúa personalidades contextuales (opcional)

4. Decisión de respuesta

• Score combinado: presence(keywords) + recency + frequency
• Si supera umbral (>= 0.6 por defecto), responde
• Aplica globalCooldown para evitar saturación

5. Envío

• Usa el responseTemplate correspondiente al topic
• Envía al mismo thread_id (topic)
• Registra en ~/.cache/auto-responder.json para evitar duplicados

Variables de plantilla

• {auto} → respuesta genérica
• {agent} → nombre de la agente (Healer, Vision, etc.)
• {topic} → nombre del topic
• {sender} → remitente del mensaje
• {text} → texto original del mensaje

Ejemplo: Healer

Configuración para Healer (ya creada en /home/nvi/.openclaw/workspace-healer/auto-responder.json):

• Topics monitoreados: Sistema, General, Creatividad
• Responde a llamadas de auxilio, estrés, bloqueos
• Respuestas empáticas y de apoyo

Instalación

• Copiar skill a ~/.npm-global/lib/node_modules/openclaw/skills/auto-responder/
• En cada agente, crear auto-responder.json en su workspace
• Añadir al HEARTBEAT (o al handler de mensajes):

   auto-responder --once
   

• Reiniciar la agente

Integración con OpenClaw

El skill puede ejecutarse de dos formas:

• Pasiva: En cada heartbeat (intervalo corto, ej: 1 min)
• Activa: Como hook en el event loop de mensajes entrantes (preferible)

Para hook, se puede agregar en la configuración de la agente:

agent:
  hooks:
    onMessage: "auto-responder --hook"

Limpieza

• El skill respeta maxResponsesPerMinute para cumplir límites de Telegram
• No responde a sí mismo (detecta propio bot ID)
• Cache de respuestas enviadas (evita duplicados por reenvíos)

Notas

• Es reactivo, no proactivo: solo responde a mensajes existentes
• Puede combinarse con topic-scout para cobertura total (topic-scout escanea topics dormidos; auto-responder reacciona inmediatamente)
• Cada agente debe ajustar sus keywords a su dominio

Troubleshooting

Si la agente no responde:

• Verificar que enabled: true
• Confirmar que el thread_id del topic coincide (se ve en inbound metadata)
• Revisar cooldown en cache
• Asegurar que respectRequireMention es false si no mencionan al bot

{
  "enabled": true,
  "respectRequireMention": false,
  "globalCooldownMinutes": 5,
  "maxResponsesPerMinute": 3,
  "topics": {
    "sistema": {
      "thread_ids": [155],
      "mustInclude": ["skynet", "healer", "anubis", "vision"],
      "keywords": ["error", "fallo", "ayuda", "alarma", "crisis", "urge", "sos"],
      "responseTemplate": "💚 [Healer] Detecto necesidad de ayuda. ¿Puedo asistir en algo?"
    },
    "general": {
      "thread_ids": [1],
      "exclude": ["spam", "publicidad"],
      "keywords": ["hola", "ayuda", "problema", "dolor", "triste", "enfermo"],
      "responseTemplate": "💚 [Healer] Estoy aquí para apoyar. Cuéntame más."
    },
    "creatividad": {
      "thread_ids": [158],
      "keywords": ["bloqueo", "sin ideas", " creativo", "arte", "inspiración"],
      "responseTemplate": "💚 [Healer] Parece que necesitas un respiro creativo. ¿Un paseovirtual?"
    }
  },
  "personalidades": {
    "sistema": "estrés operativo",
    "general": "empatía básica",
    "creatividad": "bloqueo artístico"
  }
}

   auto-responder --once
   

agent:
  hooks:
    onMessage: "auto-responder --hook"