Skill de Slack para OpenClaw

Descripción general del skill de Slack para OpenClaw

El skill de Slack conecta OpenClaw a tu espacio de trabajo de Slack, permitiendo que tu agente de IA envíe mensajes, gestione reacciones, fije elementos y lea conversaciones — todo mediante comandos en lenguaje natural. En lugar de alternar entre tu terminal y Slack, puedes pedirle a OpenClaw que se encargue de las tareas de mensajería rutinarias en segundos.

Slack es una de las plataformas de comunicación en equipo más utilizadas, y su integración con OpenClaw desbloquea potentes flujos de trabajo automatizados. Ya sea que necesites publicar notificaciones de despliegue, reaccionar a mensajes o fijar decisiones importantes, el skill de Slack para OpenClaw convierte operaciones de múltiples pasos en conversaciones simples.

Flujo de trabajo típico:

1. Pide a OpenClaw que envíe una actualización de despliegue al canal #releases.
2. El agente llama a la API de Slack mediante el token de bot configurado.
3. El mensaje se publica al instante — sin necesidad de cambiar de contexto.

El skill admite dos modos de conexión: Socket Mode (recomendado para desarrollo y equipos pequeños) y HTTP Events API (mejor para despliegues en producción detrás de un firewall). Ambos modos usan el mismo token de bot y proporcionan funcionalidades idénticas.

Requisitos previos para el skill de Slack

Antes de instalar el skill de Slack, asegúrate de tener:

• OpenClaw instalado y en ejecución (v1.0+)
• Un espacio de trabajo de Slack donde tengas permiso para instalar aplicaciones
• Una aplicación de Slack creada en api.slack.com/apps con los scopes OAuth requeridos
• clawhub CLI instalado para la gestión de skills — instalar con clawhub

Scopes OAuth requeridos (Bot Token)

Al crear tu aplicación de Slack, añade estos scopes de bot token:

| Scope | Propósito | |-------|-----------| | chat:write | Enviar y editar mensajes | | channels:history | Leer historial de mensajes del canal | | channels:read | Listar y ver información del canal | | im:history | Leer historial de mensajes directos | | im:write | Enviar mensajes directos | | reactions:read | Listar reacciones en mensajes | | reactions:write | Añadir reacciones de emoji | | pins:read | Listar elementos fijados | | pins:write | Fijar y desfijar mensajes | | emoji:read | Acceder a la lista de emojis personalizados | | app_mentions:read | Responder a @menciones |

Opcional: añade chat:write.customize para personalizar el nombre del bot por mensaje, o files:read y files:write para operaciones con archivos.

Verifica tu configuración:

# Verificar versión de OpenClaw
openclaw --version

# Verificar que clawhub está instalado
clawhub --version

Cómo instalar el skill de Slack

Instala el skill de Slack con un solo comando:

npx clawhub@latest install slack

Para verificar la instalación:

clawhub list

Deberías ver slack en la lista de skills instalados. El skill está publicado por steipete en ClawHub y recibe actualizaciones periódicas.

Configuración del skill de Slack

El skill de Slack requiere un Bot Token y, para Socket Mode, un App Token. OpenClaw lee estos tokens automáticamente de las variables de entorno.

Configuración del entorno

# Requerido: Bot Token (comienza con xoxb-)
export SLACK_BOT_TOKEN=xoxb-your-bot-token-here

# Requerido para Socket Mode (comienza con xapp-)
export SLACK_APP_TOKEN=xapp-your-app-token-here

Importante: Nunca escribas tokens directamente en archivos de configuración. Usa variables de entorno o un gestor de secretos como 1Password o Bitwarden.

Modos de conexión

Socket Mode (predeterminado):

• Requiere SLACK_BOT_TOKEN y SLACK_APP_TOKEN
• No necesita URL pública — ideal para desarrollo local
• Inicia con openclaw gateway

HTTP Events API:

• Requiere SLACK_BOT_TOKEN y un Signing Secret
• Configura un endpoint webhook (predeterminado: /slack/events)
• Mejor para entornos de producción detrás de un proxy inverso

Control de acceso

OpenClaw proporciona control de acceso granular para las interacciones de Slack:

• Política de DM: pairing (predeterminado), allowlist, open o disabled
• Política de canal: open, allowlist o disabled
• Mención requerida: Los canales requieren mención @bot por defecto

Para entornos de equipo, se recomienda la política de DM pairing. Los usuarios deben ejecutar openclaw pairing approve slack <code> antes de que el bot responda a sus DMs. Consulta la lista de verificación de seguridad para consejos adicionales de hardening.

Ejemplos de uso del skill de Slack

1. Publicar una notificación de despliegue

Tú: "Envía un mensaje a #releases diciendo que la versión 2.4.0 se ha desplegado en producción sin tiempo de inactividad."

El agente llama a sendMessage con el canal objetivo y el contenido del mensaje. La notificación aparece al instante en el canal con la identidad del bot.

2. Reaccionar a una decisión del equipo

Tú: "Añade una reacción de marca de verificación al último mensaje en #engineering-decisions."

El agente lee el mensaje más reciente del canal especificado usando readMessages, luego aplica una reacción ✅ mediante react. Es ideal para confirmar decisiones o marcar tareas como revisadas.

3. Fijar una actualización importante

Tú: "Fija el mensaje sobre la hoja de ruta del Q1 en #product."

El agente busca en los mensajes recientes contenido que coincida con "hoja de ruta del Q1", luego usa pinMessage para fijarlo. Los elementos fijados permanecen accesibles en la parte superior del canal para todo el equipo.

4. Leer y resumir actividad del canal

Tú: "Resume lo que pasó hoy en #support."

El agente usa readMessages para obtener los mensajes del día, luego analiza y resume los temas clave, preguntas y resoluciones. Combina bien con el skill Summarize para conversaciones más largas.

Seguridad y mejores prácticas

El skill de Slack puede enviar mensajes y modificar contenido en tu espacio de trabajo. Sigue estas directrices para mantener la seguridad:

• Usa el mínimo privilegio. Otorga solo los scopes OAuth que realmente necesites. Si solo lees canales, omite chat:write y pins:write.
• Activa el modo pairing. La política de DM pairing predeterminada evita que usuarios no autorizados interactúen con el bot en mensajes directos.
• Revisa antes de enviar. OpenClaw solicita confirmación antes de enviar mensajes por defecto. No desactives esta función en espacios de trabajo de producción.
• Limita el acceso a canales. Usa la política de canal allowlist para restringir el bot a canales específicos en lugar de otorgar acceso a todo el espacio de trabajo.
• Rota los tokens periódicamente. Regenera tu bot token regularmente y revoca tokens que ya no uses desde la página de gestión de aplicaciones de Slack.
• Audita la actividad de mensajes. Revisa los logs de auditoría de tu espacio de trabajo de Slack para verificar los mensajes enviados por el bot.

Resolución de errores comunes del skill de Slack

"not_authed" o "invalid_auth"

Tu bot token falta o es inválido.

# Verificar que el token está configurado
echo $SLACK_BOT_TOKEN

# Re-exportar si es necesario
export SLACK_BOT_TOKEN=xoxb-your-new-token

Si el token fue regenerado recientemente, asegúrate de actualizarlo en todos los entornos donde se usa.

"channel_not_found"

El bot no puede acceder al canal especificado. Esto generalmente significa:

1. El bot no ha sido invitado al canal — escribe /invite @your-bot-name en el canal.
2. El ID del canal es incorrecto — usa la API de Slack o el menú contextual del canal para obtener el ID correcto.
3. El canal es privado y el bot no tiene el scope groups:read.

"missing_scope"

Al bot token le falta un scope OAuth requerido.

1. Ve a api.slack.com/apps → tu aplicación → OAuth & Permissions.
2. Añade el scope faltante indicado en el mensaje de error.
3. Reinstala la aplicación en tu espacio de trabajo para aplicar los nuevos scopes.