Configuracion del bot de Slack

Conecta tu agente de IA de Claw Buff a un espacio de trabajo de Slack. Tu bot respondera a mensajes directos, menciones y el comando de barra /claw. La configuracion tarda unos 10 minutos.

Requisitos previos

• Un espacio de trabajo de Slack donde tengas privilegios de administrador (o permiso para instalar aplicaciones)
• Un agente de Claw Buff desplegado (Primeros pasos)

Paso 1: Crear una aplicacion de Slack

{
  "display_information": {
    "name": "Claw Buff",
    "description": "AI agent powered by Claw Buff"
  },
  "features": {
    "bot_user": {
      "display_name": "Claw Buff",
      "always_online": false
    },
    "assistant_view": {
      "assistant_description": "AI agent powered by Claw Buff"
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "users:read",
        "app_mentions:read",
        "assistant:write"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "assistant_thread_started",
        "message.im"
      ]
    },
    "socket_mode_enabled": true
  }
}

Paso 2: Conectar a Claw Buff

1. Abre la Consola de Claw Buff → pagina de Canales
2. Encuentra la tarjeta de Slack y haz clic en Conectar
3. Pega ambos tokens:
   • Token de Bot (xoxb-...)
   • Token de App (xapp-...)
4. Haz clic en Guardar y activar

Tu bot se conectara via Socket Mode — no se necesita URL publica ni webhook.

Paso 3: Empareja tu cuenta

Antes de que el bot responda, necesitas emparejar tu cuenta de Slack:

1. Envia un MD al bot — Encuentra tu bot en la barra lateral de Slack en Apps y envia cualquier mensaje (por ejemplo, "hola")
2. El bot respondera con un codigo de emparejamiento (por ejemplo, 7EPLYS7R)
3. Ve a la Consola de Claw Buff → pagina de Canales
4. Veras una seccion de Solicitudes de emparejamiento pendientes — haz clic en Aprobar junto al codigo

Una vez aprobado, el bot respondera a tus mensajes inmediatamente.

Paso 4: Habilitar canales (Opcional)

Por defecto, el bot solo funciona en mensajes directos. Para usarlo en canales de Slack:

1. En Slack, haz clic derecho en el nombre del canal → Ver detalles del canal → copia el Channel ID en la parte inferior del panel

2. En la Consola, ve a Canales → haz clic en Gestionar en la tarjeta de Slack
3. En Canales autorizados, pega el Channel ID y haz clic en Agregar
4. En Slack, invita al bot al canal: escribe /invite @NombreDeTuBot

El bot ahora respondera a las @menciones en ese canal. Puedes agregar multiples canales.

Paso 5: Empieza a chatear

• Envia un MD al bot — Encuentra tu bot en la barra lateral de Slack en Apps
• Menciona en un canal — Escribe @NombreDeTuBot seguido de tu mensaje
• App Home — Abre la pestana App Home del bot para una interfaz de chat dedicada

Caracteristicas

Preguntas frecuentes

1. El bot no responde?

• Verifica ambos tokens — Necesitas tanto el Token de Bot (xoxb-) como el Token de App (xapp-)
• Verifica Socket Mode — Asegurate de que Socket Mode este habilitado en la configuracion de tu aplicacion de Slack
• Verifica la Consola — La pagina de Canales muestra el estado de conexion y los registros de errores

2. El bot no responde a mensajes directos?

Asegurate de que estos scopes esten presentes: im:history, im:read, im:write. Si usaste el manifiesto de arriba, ya estan incluidos.

3. El bot no responde a menciones en canales?

• El bot necesita ser invitado al canal primero (escribe /invite @Claw Buff)
• Asegurate de que los scopes app_mentions:read y channels:history esten presentes

4. Error "not_allowed_token_type"?

Es posible que hayas intercambiado el Token de Bot y el Token de App. El Token de Bot comienza con xoxb- y el Token de App comienza con xapp-.