Requisitos previos
- Un espacio de trabajo de Slack donde tengas acceso de administrador
- Una instancia de Claw (crea una aquí)
Guía de configuración
Crear una App de Slack
- Ve a Slack API y haz clic en Create New App
- Selecciona From scratch
- Introduce un nombre para la app (ej., “AI Assistant”) y selecciona tu espacio de trabajo
- Haz clic en Create App
Habilitar Socket Mode
- En la barra lateral izquierda, ve a Socket Mode
- Cambia Enable Socket Mode a ON
- Asigna un nombre al token (ej., “claw-socket”) y haz clic en Generate
- Copia el App-Level Token (comienza con
xapp-) — lo necesitarás
Configurar permisos del Bot
- Ve a OAuth & Permissions en la barra lateral
- Bajo Bot Token Scopes, añade estos scopes:
chat:write— Enviar mensajesim:history— Leer historial de DMim:read— Ver DMsim:write— Iniciar DMsapp_mentions:read— Detectar @mentions
- Haz clic en Install to Workspace en la parte superior
- Autoriza la app
- Copia el Bot User OAuth Token (comienza con
xoxb-)
Habilitar eventos
- Ve a Event Subscriptions en la barra lateral
- Cambia Enable Events a ON
- Bajo Subscribe to bot events, añade:
message.im— Mensajes en DMsapp_mention— @mentions en canales
- Haz clic en Save Changes
Configurar en el Dashboard de LemonData
- Ve a tu Claw Dashboard
- Haz clic en el icono de configuración de tu instancia
- Abre la pestaña IM Integrations
- Expande la sección Slack
- Pega tu App Token (
xapp-...) y Bot Token (xoxb-...) - Haz clic en Save
Control de acceso
Configuración de grupo
Configura el acceso a los canales en la pestaña IM Integrations de tu Dashboard:| Ajuste | Opciones | Descripción |
|---|---|---|
| Group Policy | Open (predeterminado) / Allowlist / Disabled | Controla en qué canales responde el bot |
| Require @mention | On / Off | El bot solo responde cuando es mencionado con @mention |
| Group IDs | Lista de IDs de canal | Restringir a canales específicos (vacío = todos los canales) |
| Group Allowed Users | Lista de IDs de usuario | Solo estos usuarios pueden activar el bot (modo allowlist) |
Solución de problemas
El bot no responde a los DMs
El bot no responde a los DMs
- Verifica que ambos tokens sean correctos (el App Token comienza con
xapp-, el Bot Token conxoxb-) - Comprueba que el evento
message.imesté suscrito - Asegúrate de que la app esté instalada en tu espacio de trabajo
El bot no responde a las @mentions
El bot no responde a las @mentions
- Comprueba que el scope
app_mentions:ready el eventoapp_mentionestén configurados - El bot debe ser invitado al canal primero (escribe
/invite @botname)
Error 'not_allowed_token_type'
Error 'not_allowed_token_type'
- Asegúrate de usar el App-Level Token (
xapp-) para el campo App Token, no el Bot Token - El Bot Token (
xoxb-) va en el campo Bot Token