🦞
Integración de Canal

Conectar OpenClaw a Slack

Añade OpenClaw a tu espacio de trabajo de Slack. Obtén asistencia de IA en canales, hilos o mensajes directos con soporte de comandos slash.

💼 ¿Por qué usar Slack?
  • Conexión WebSocketMensajería en tiempo real vía Slack Bot API + Socket Mode
  • Comandos SlashInterfaz de comandos /clawd nativa
  • Soporte de HilosMantén las conversaciones organizadas con contexto de historial
  • Formato EnriquecidoRespuestas formateadas con reacciones y pines
  • Acceso FlexibleMDs, canales públicos y canales privados
Requisitos
  • Token de Bot de SlackComienza con xoxb-...
  • Token de App de SlackComienza con xapp-... (para Socket Mode)
  • App de SlackCon los scopes de OAuth apropiados configurados

Pasos de Configuración

1

Crear una App de Slack

Ve al portal de API de Slack y crea una nueva aplicación:

  • • Visita api.slack.com/apps
  • • Haz clic en "Create New App"
  • • Elige "From scratch"
  • • Nómbrala (ej., "OpenClaw") y selecciona tu espacio de trabajo
2

Añadir Scopes del Token de Bot

Configura los permisos OAuth para tu bot:

  • • Ve a "OAuth & Permissions" en la barra lateral
  • • En "Bot Token Scopes", añade:
  • - app_mentions:read — Leer menciones
  • - channels:history — Ver mensajes del canal
  • - channels:read — Ver info del canal
  • - chat:write — Enviar mensajes
  • - im:history — Ver historial de MDs
  • - im:read — Ver info de MDs
  • - im:write — Iniciar conversaciones por MD
  • - reactions:write — Añadir reacciones
  • - users:read — Ver info de usuarios
3

Habilitar Socket Mode

Socket Mode permite comunicación en tiempo real sin una URL pública:

  • • Ve a "Socket Mode" en la barra lateral
  • • Activa "Enable Socket Mode"
  • • Genera un Token de Nivel de App con el scope connections:write
  • • Copia el token (comienza con xapp-...)
4

Instalar App en el Espacio de Trabajo

Instala la app y obtén tu Token de Bot:

  • • Ve a "Install App" en la barra lateral
  • • Haz clic en "Install to Workspace"
  • • Autoriza los permisos solicitados
  • • Copia el Bot User OAuth Token (comienza con xoxb-...)
5

Configurar OpenClaw

Añade la configuración de Slack a tu openclaw.json:

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}
6

Invitar Bot a Canales

Añade el bot a los canales donde quieres que responda:

  • • Abre el canal en Slack
  • • Escribe /invite @OpenClaw
  • • O haz clic en el nombre del canal -> Integraciones -> Añadir apps
  • • Reinicia OpenClaw con openclaw restart y prueba mencionando al bot.
Características

Soporte de Hilos

Mantiene el contexto de conversación dentro de hilos con alcance de historial configurable.

Reacciones con Emoji

El bot puede añadir reacciones para confirmar mensajes o indicar estado.

Fijar Mensajes

Fija respuestas importantes para referencia fácil después.

Comandos Slash

Usa /clawd para consultas rápidas de IA desde cualquier lugar.

Info de Miembros

Busca información de miembros del espacio de trabajo cuando sea necesario.

Soporte de MD

Conversaciones privadas uno a uno con el bot.

Configuración Avanzada

Opciones completas de configuración para la integración de Slack:

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "dm": {
        "enabled": true,
        "policy": "pairing",
        "allowFrom": ["U123", "U456"]
      },
      "channels": {
        "#general": {
          "allow": true,
          "requireMention": true,
          "users": ["U123"]
        }
      },
      "historyLimit": 50,
      "slashCommand": {
        "enabled": true,
        "name": "clawd"
      },
      "actions": {
        "reactions": true,
        "messages": true,
        "pins": true
      }
    }
  }
}
  • dm.enabledPermitir mensajes directos al bot
  • dm.policyPolítica de acceso a MD ("pairing" u "open")
  • dm.allowFromArray de IDs de usuario permitidos para MD
  • channelsObjeto de configuración por canal
  • requireMentionSolo responder cuando se mencione con @
  • historyLimitNúmero de mensajes a incluir para contexto
  • slashCommandConfigurar ajustes de comandos slash
  • actionsHabilitar/deshabilitar reacciones, mensajes y pines
Políticas de Canal

Modo Lista Blanca

Solo responder en canales configurados explícitamente. Mejor para entornos controlados.

Modo Abierto

Responder en todos los canales donde el bot esté invitado. Usa requireMention para limitar respuestas.

Cómo Obtener IDs de Usuario de Slack

Desde el Perfil:

Haz clic en el nombre del usuario -> Ver perfil -> Haz clic en los tres puntos (...) -> Copiar ID de miembro

Desde Admin de Slack:

Configuración del Espacio de Trabajo -> Gestionar Miembros -> Exportar lista de miembros como CSV

⚠️ Solución de Problemas

¿El bot no responde en los canales?

Asegúrate de que el bot esté invitado al canal y tenga los scopes correctos. Verifica si requireMention está habilitado.

¿Errores de conexión de Socket Mode?

Verifica que tu App Token (xapp-...) sea correcto y tenga el scope connections:write.

¿El comando slash no aparece?

Ve a "Slash Commands" en la configuración de tu app de Slack y crea el comando manualmente, apuntando a Socket Mode.

¿Errores de permiso denegado?

Reinstala la app en tu espacio de trabajo después de añadir nuevos scopes. Algunos cambios de scope requieren reinstalación.

¡Slack Conectado!

Ahora configura más canales o mejora tu bot con skills personalizados.