Cómo configurar OpenClaw en Discord: emparejamiento por DM, canales del servidor y voz

Name

Soren Atelier

Actualizado el 8/4/2026

Si quieres usar OpenClaw con Discord, la ruta más rápida y segura es: crear un bot de Discord, configurar el token del bot en la máquina que ejecuta OpenClaw, iniciar el gateway, aprobar el primer emparejamiento por DM y luego convertir tu servidor privado en un espacio de trabajo de guild.

Ese es el flujo de configuración que importa porque OpenClaw en Discord no es solo "otro bot". Cada canal de Discord puede convertirse en su propia sesión de agente con su propio contexto, aprobaciones y reglas de enrutamiento. Si omites el emparejamiento, la allowlist y la configuración de menciones, normalmente la experiencia parece rota aunque el token del bot sea válido.

Si buscaste documentación de OpenClaw para Discord, la fuente oficial principal es la guía del canal de Discord de OpenClaw: Discord setup docs (opens in a new tab). Esta página es la capa práctica encima de eso: qué configurar primero, qué mantener privado y cómo pasar de una prueba por DM a un espacio de trabajo privado útil en Discord.

Si primero necesitas el marco general del producto, lee NVIDIA NemoClaw vs OpenClaw vs ZeroClaw: Differences, Pi Agent, and Nanobot in 2026. Si tu objetivo real es ayuda de código local al repositorio más que un asistente basado en Discord, How to Use Codex y How to Use OpenCode son mejores puntos de partida.

Respuesta rápida: ¿cuál es la forma más rápida de hacer que OpenClaw funcione en Discord?

El orden de configuración confiable es:

1. crear el bot de Discord
2. habilitar los intents necesarios
3. configurar el token del bot de forma segura
4. iniciar el gateway
5. aprobar el primer emparejamiento por DM
6. agregar tu servidor a la allowlist de guild
7. decidir si las respuestas deben requerir @mention
8. agregar voz solo después de que el chat de texto sea estable

¿Qué te ofrece realmente OpenClaw en Discord?

OpenClaw en Discord no es solo una memoria compartida de bot.

Según la documentación actual de OpenClaw, Discord admite:

• DMs
• canales de texto de guild
• flujos de trabajo con hilos en canales de foro
• manejo nativo de comandos
• botones de aprobación
• sesiones opcionales en canales de voz

Eso importa porque la forma real del producto es un espacio de trabajo de Discord con sesiones de agente, no solo un bot por DM.

En la práctica, eso significa:

• los DMs de Discord pueden actuar como tu primer canal de emparejamiento de bajo riesgo
• cada canal de guild puede mantener contexto separado
• las aprobaciones y el enrutamiento permanecen ligadas a la superficie de Discord donde ocurrió la solicitud
• la voz puede añadirse más tarde si quieres conversaciones continuas

Inicio rápido

La documentación oficial de Discord recomienda crear un bot, configurar el token y luego iniciar el gateway. La versión mínima práctica se ve así:

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true --strict-json
openclaw gateway

Si OpenClaw ya se está ejecutando como proceso en segundo plano, reinicia el gateway en lugar de lanzar una segunda copia.

Luego envía un DM a tu bot en Discord y aprueba el código de emparejamiento.

Ese es el camino más corto desde "tengo un token de bot de Discord" hasta "OpenClaw realmente es accesible en Discord".

Paso 1: Crea el bot de Discord correctamente

En la Discord setup docs (opens in a new tab) oficial, OpenClaw recomienda un flujo estándar de bot de Discord:

1. ve al Discord Developer Portal
2. crea una nueva aplicación
3. añade un bot
4. copia el token del bot

Para la URL OAuth, los scopes base son:

• bot
• applications.commands

Los permisos base habituales son:

• View Channels
• Send Messages
• Read Message History
• Embed Links
• Attach Files

Evita Administrator salvo que realmente lo necesites. Un servidor privado con permisos mínimos es una mejor opción por defecto.

Paso 2: Habilita los intents correctos antes de depurar cualquier otra cosa

Esta es una de las formas más fáciles de perder tiempo.

La documentación de Discord de OpenClaw señala estos intents:

• Message Content Intent: required
• Server Members Intent: recommended, y requerido para allowlists de roles y coincidencia de nombres
• Presence Intent: optional

Si el bot entra al servidor pero se comporta de forma extraña, los intents faltantes son una de las primeras cosas que debes verificar.

Paso 3: Mantén el token fuera del chat

El token de tu bot de Discord es un secreto. No lo pegues en un chat con el agente.

Usa una variable de entorno o una ruta de configuración respaldada por SecretRef en la máquina que ejecuta OpenClaw. La documentación recomienda explícitamente configurar el token localmente y luego vincular la configuración a ese secreto local.

Esta es la base segura:

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true --strict-json

Luego inicia el gateway:

openclaw gateway

Si el chat de texto no funciona después de esto, detente y depura el token, los intents y el gateway antes de tocar las políticas de guild.

Paso 4: Empareja primero por DM en Discord

La documentación actual de Discord de OpenClaw trata los DMs como el punto de verificación inicial más sencillo.

El flujo práctico es:

1. asegúrate de que el gateway esté en ejecución
2. envía un DM al bot en Discord
3. espera el código de emparejamiento
4. aprueba ese código desde un canal existente de OpenClaw o mediante CLI

Por qué empezar con el emparejamiento por DM:

• es el ciclo más corto para validar el token del bot y el enrutamiento
• elimina la política de guild de la prueba inicial
• te permite demostrar que el bot está vivo antes de convertir todo un servidor en un espacio de trabajo

Si tu primer DM nunca obtiene respuesta, no avances todavía. El problema suele ser uno de estos:

• el token es incorrecto
• el gateway no se está ejecutando
• los DMs están bloqueados
• los intents están incompletos

Paso 5: Convierte un servidor privado de Discord en un espacio de trabajo de guild

Una vez que el emparejamiento por DM funcione, el siguiente paso útil no es "agregar más canales por todas partes". Es "configurar bien un servidor privado de Discord".

La documentación oficial recomienda un espacio de trabajo de guild porque cada canal obtiene su propia sesión aislada de OpenClaw. Esa es la verdadera razón por la que Discord es interesante aquí. Puedes crear canales como:

• #coding
• #research
• #home
• #ops

y cada uno puede mantener contexto diferente.

El primer cambio de configuración es agregar tu servidor a la allowlist de guild:

{
  channels: {
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        YOUR_SERVER_ID: {
          requireMention: true,
          users: ["YOUR_USER_ID"],
        },
      },
    },
  },
}

Este es el valor predeterminado más seguro porque limita dónde responderá el bot y quién puede usarlo.

Paso 6: Decide si tu servidor debe requerir @mention

Por defecto, OpenClaw en Discord es más seguro que conveniente.

Eso suele ser correcto para servidores compartidos. Pero en un servidor privado donde solo estás tú y tu bot, requerir @mention en cada mensaje hace que el espacio de trabajo se sienta torpe.

La documentación muestra que puedes desactivar el comportamiento de solo mención para una guild específica:

{
  channels: {
    discord: {
      guilds: {
        YOUR_SERVER_ID: {
          requireMention: false,
        },
      },
    },
  },
}

Usa esto solo en servidores de confianza. Si el servidor es compartido, mantén activado el requisito de mención.

Paso 7: Entiende el modelo de memoria antes de esperar "contexto compartido"

Este es uno de los detalles conceptuales más importantes en la documentación de Discord.

OpenClaw no trata cada conversación de Discord como un único gran pool de memoria compartida.

La documentación señala que:

• los DMs pueden colapsar en la sesión principal del agente
• los canales de guild están aislados
• la memoria a largo plazo no se carga automáticamente en cada canal de guild de la misma manera

Eso significa que no debes esperar que #research y #home se sientan automáticamente como el mismo hilo de asistente. Ese aislamiento es útil, pero solo si sabes que existe.

Si necesitas instrucciones compartidas estables en todas partes, mantenlas en la capa global de instrucciones del agente en lugar de asumir que la memoria del canal las conservará.

Agrega voz solo después de que el chat de texto funcione

OpenClaw también admite canales de voz de Discord, pero eso debería venir después de que el texto ya sea estable.

La documentación dice que la voz requiere:

• comandos nativos habilitados
• channels.discord.voice configurado
• permisos de Connect y Speak en el canal de voz objetivo

Una forma mínima de auto-join se ve así:

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
      },
    },
  },
}

Esto es potente, pero no es tu primer hito. Primero asegúrate de que:

• el emparejamiento por DM funcione
• el enrutamiento de texto en guild funcione
• las allowlists se comporten como esperas

Solo entonces agrega voz.

Errores comunes

Enviar el token del bot en el chat

No hagas esto. Configura el token localmente en la máquina que ejecuta OpenClaw y luego apunta la configuración de OpenClaw a ese secreto local.

Intentar canales de guild antes del emparejamiento por DM

Si saltas el punto de control de DM, terminas depurando token, intents, gateway, política de guild y menciones todo a la vez.

Dejar requireMention activado en un servidor privado y asumir que el bot está roto

En un servidor privado, el bot puede estar funcionando bien pero aun así ignorar mensajes hasta que se le mencione. Eso es política, no fallo.

Esperar una memoria compartida para todos los canales de Discord

Los canales de guild están diseñados para permanecer aislados. Eso a menudo es útil, pero sorprende a quienes esperan un historial global único.

Activar voz antes de que el chat de texto funcione

La voz añade otra capa de depuración. Empieza con texto.

Lista de verificación para solucionar problemas

Si OpenClaw en Discord no responde, comprueba esto en orden:

1. el gateway está en ejecución
2. el token del bot es válido y está configurado localmente
3. Message Content Intent está habilitado
4. los DMs están permitidos para el emparejamiento
5. el servidor está en la allowlist de guild si estás probando canales de guild
6. requireMention está configurado como esperas
7. el remitente no está bloqueado por política de usuario o de guild

La documentación de OpenClaw también apunta a comandos útiles para el diagnóstico:

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Cuándo esta configuración de Discord es el punto de partida equivocado

No empieces aquí si tu objetivo real es:

• un asistente de código local para el repositorio
• un runtime sin interfaz para despliegue embebido
• una comparación genérica de alternativas a OpenClaw

En esos casos, estas lecturas son mejores:

• How to Use Codex
• How to Use OpenCode
• NVIDIA NemoClaw vs OpenClaw vs ZeroClaw: Differences, Pi Agent, and Nanobot in 2026

FAQ

¿Cuál es la primera cosa que debo probar en la configuración de OpenClaw en Discord?

Prueba primero el emparejamiento por DM de Discord. Es la forma más corta de confirmar que tu token, gateway y enrutamiento básico funcionan.

¿Necesito @mention en cada canal de Discord?

No siempre. En servidores privados, muchos usuarios querrán requireMention configurado en false. En servidores compartidos, mantener activado el requisito de mención es la opción más segura.

¿Por qué mi bot de OpenClaw en Discord aparece en línea pero no responde?

Las causas más comunes son un token incorrecto, falta de Message Content Intent, un gateway detenido, DMs bloqueados o una política de guild que impide respuestas sin allowlist o sin coincidencia de mención.

¿Debería habilitar primero la voz de Discord?

No. Haz que funcionen primero el emparejamiento por DM y los canales de texto de guild, y luego agrega voz.

¿Esto es mejor que una guía genérica de "Cómo usar OpenClaw"?

Para la intención de búsqueda práctica, sí. La configuración de Discord tiene una tarea más clara: ayuda al lector a poner en funcionamiento una integración real en lugar de intentar resumir todo el producto OpenClaw en una sola página.

Guías relacionadas

• NVIDIA NemoClaw vs OpenClaw vs ZeroClaw: Differences, Pi Agent, and Nanobot in 2026
• How to Use Codex
• How to Use OpenCode
• Parallel Code Agents Explained
• Cursor Review: Where It Still Wins and Where It Still Breaks