🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › Auto Responder
🦀 ClawHub

Auto Responder

by @lunaviva211-sketch

Responde automáticamente a mensajes en topics definidos, usando reglas de palabras clave, reglas de exclusión y cooldowns para evitar spam.

Versionv1.0.0
Downloads577
#clawhub
TERMINAL
clawhub install auto-responder

📖 About This Skill

SKILL.md — Auto Responder

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

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

       auto-responder --once
    4. 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: 1. Verificar que enabled: true 2. Confirmar que el thread_id del topic coincide (se ve en inbound metadata) 3. Revisar cooldown en cache 4. Asegurar que respectRequireMention es false si no mencionan al bot

    📋 Tips & Best Practices

    Si la agente no responde: 1. Verificar que enabled: true 2. Confirmar que el thread_id del topic coincide (se ve en inbound metadata) 3. Revisar cooldown en cache 4. Asegurar que respectRequireMention es false si no mencionan al bot