Auto Responder

SKILL.md

# 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:

```json
{
  "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):
   ```bash
   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:

```yaml
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