Discord

Discord admite etiquetas de respuesta en la salida del agente:

• [[reply_to_current]]
• [[reply_to:<id>]]

Controlado por channels.discord.replyToMode:

• off (predeterminado)
• first
• all
• batched

Nota: off deshabilita el encadenamiento implícito de respuestas. Las etiquetas explícitas [[reply_to_*]] se siguen respetando. first siempre adjunta la referencia implícita de respuesta nativa al primer mensaje saliente de Discord del turno. batched solo adjunta la referencia implícita de respuesta nativa de Discord cuando el turno entrante fue un lote con rebote de varios mensajes. Esto es útil cuando quieres respuestas nativas principalmente para chats ambiguos en ráfaga, no para cada turno de un solo mensaje.

Los ID de mensajes se exponen en el contexto/historial para que los agentes puedan dirigirse a mensajes específicos.

OpenClaw puede transmitir borradores de respuestas enviando un mensaje temporal y editándolo a medida que llega el texto. channels.discord.streaming acepta off | partial | block | progress (predeterminado). progress mantiene un borrador de estado editable y lo actualiza con el progreso de herramientas hasta la entrega final; streamMode es un alias heredado en tiempo de ejecución. Ejecuta openclaw doctor --fix para reescribir la configuración persistida a la clave canónica.

Establece channels.discord.streaming.mode en off para deshabilitar las ediciones de vista previa de Discord. Si la transmisión por bloques de Discord está habilitada explícitamente, OpenClaw omite la transmisión de vista previa para evitar transmitir dos veces.

{
channels: {
discord: {
  streaming: {
    mode: "progress",
    progress: {
      label: "auto",
      maxLines: 8,
      toolProgress: true,
    },
  },
},
},
}

• partial edita un único mensaje de vista previa a medida que llegan los tokens.
• block emite fragmentos del tamaño de borrador (usa draftChunk para ajustar el tamaño y los puntos de corte, limitado a textChunkLimit).
• Los finales con medios, errores y respuestas explícitas cancelan las ediciones de vista previa pendientes.
• streaming.preview.toolProgress (predeterminado true) controla si las actualizaciones de herramientas/progreso reutilizan el mensaje de vista previa.
• streaming.preview.commandText / streaming.progress.commandText controla el detalle de comandos/ejecución en líneas de progreso compactas: raw (predeterminado) o status (solo etiqueta de herramienta).

Oculta el texto sin procesar de comandos/ejecución mientras mantienes líneas de progreso compactas:

{
  "channels": {
    "discord": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

La transmisión de vista previa solo admite texto; las respuestas con medios recurren a la entrega normal. Cuando la transmisión block está habilitada explícitamente, OpenClaw omite la transmisión de vista previa para evitar transmitir dos veces.

Contexto de historial de servidor:

• channels.discord.historyLimit predeterminado 20
• alternativa: messages.groupChat.historyLimit
• 0 deshabilita

Controles de historial de mensajes directos:

• channels.discord.dmHistoryLimit
• channels.discord.dms["<user_id>"].historyLimit

Comportamiento de hilos:

• Los hilos de Discord se enrutan como sesiones de canal y heredan la configuración del canal padre salvo que se anule.
• Las sesiones de hilo heredan la selección /model a nivel de sesión del canal padre como alternativa solo de modelo; las selecciones /model locales del hilo siguen teniendo prioridad y el historial de transcripción del padre no se copia salvo que la herencia de transcripción esté habilitada.
• channels.discord.thread.inheritParent (predeterminado false) opta los nuevos hilos automáticos para inicializarse desde la transcripción padre. Las anulaciones por cuenta viven en channels.discord.accounts.<id>.thread.inheritParent.
• Las reacciones de la herramienta de mensajes pueden resolver destinos de mensajes directos user:<id>.
• guilds.<guild>.channels.<channel>.requireMention: false se conserva durante la alternativa de activación en fase de respuesta.

Los temas de canal se inyectan como contexto no confiable. Las listas de permitidos limitan quién puede activar el agente, no son un límite completo de censura de contexto suplementario.

Discord puede vincular un hilo a un destino de sesión para que los mensajes de seguimiento en ese hilo sigan enrutándose a la misma sesión (incluidas las sesiones de subagentes).

Comandos:

• /focus <target> vincula el hilo actual/nuevo a un destino de subagente/sesión
• /unfocus elimina la vinculación del hilo actual
• /agents muestra ejecuciones activas y estado de vinculación
• /session idle <duration|off> inspecciona/actualiza el desenfoque automático por inactividad para vinculaciones enfocadas
• /session max-age <duration|off> inspecciona/actualiza la edad máxima estricta para vinculaciones enfocadas

Configuración:

{
session: {
threadBindings: {
  enabled: true,
  idleHours: 24,
  maxAgeHours: 0,
},
},
channels: {
discord: {
  threadBindings: {
    enabled: true,
    idleHours: 24,
    maxAgeHours: 0,
    spawnSessions: true,
    defaultSpawnContext: "fork",
  },
},
},
}

Notas:

• session.threadBindings.* establece valores predeterminados globales.
• channels.discord.threadBindings.* anula el comportamiento de Discord.
• spawnSessions controla la creación/vinculación automática de hilos para sessions_spawn({ thread: true }) y generaciones de hilos ACP. Predeterminado: true.
• defaultSpawnContext controla el contexto nativo de subagente para generaciones vinculadas a hilos. Predeterminado: "fork".
• Las claves obsoletas spawnSubagentSessions/spawnAcpSessions se migran mediante openclaw doctor --fix.
• Si las vinculaciones de hilos están deshabilitadas para una cuenta, /focus y las operaciones relacionadas de vinculación de hilos no están disponibles.

Consulta Subagentes, Agentes ACP y Referencia de configuración.

Para espacios de trabajo ACP estables "siempre activos", configura vinculaciones ACP tipadas de nivel superior dirigidas a conversaciones de Discord.

Ruta de configuración:

• bindings[] con type: "acp" y match.channel: "discord"

Ejemplo:

{
agents: {
list: [
  {
    id: "codex",
    runtime: {
      type: "acp",
      acp: {
        agent: "codex",
        backend: "acpx",
        mode: "persistent",
        cwd: "/workspace/openclaw",
      },
    },
  },
],
},
bindings: [
{
  type: "acp",
  agentId: "codex",
  match: {
    channel: "discord",
    accountId: "default",
    peer: { kind: "channel", id: "222222222222222222" },
  },
  acp: { label: "codex-main" },
},
],
channels: {
discord: {
  guilds: {
    "111111111111111111": {
      channels: {
        "222222222222222222": {
          requireMention: false,
        },
      },
    },
  },
},
},
}

Notas:

• /acp spawn codex --bind here vincula el canal o hilo actual en su lugar y mantiene los mensajes futuros en la misma sesión ACP. Los mensajes de hilo heredan la vinculación del canal padre.
• En un canal o hilo vinculado, /new y /reset restablecen la misma sesión ACP en su lugar. Las vinculaciones temporales de hilos pueden anular la resolución de destino mientras estén activas.
• spawnSessions controla la creación/vinculación de hilos hijos mediante --thread auto|here.

Consulta Agentes ACP para obtener detalles del comportamiento de vinculación.

Modo de notificación de reacciones por servidor:

• off
• own (predeterminado)
• all
• allowlist (usa guilds.<id>.users)

Los eventos de reacción se convierten en eventos del sistema y se adjuntan a la sesión de Discord enrutada.

ackReaction envía un emoji de confirmación mientras OpenClaw procesa un mensaje entrante.

Orden de resolución:

• channels.discord.accounts.<accountId>.ackReaction
• channels.discord.ackReaction
• messages.ackReaction
• alternativa de emoji de identidad del agente (agents.list[].identity.emoji, de lo contrario "👀")

Notas:

• Discord acepta emoji Unicode o nombres de emoji personalizados.
• Usa "" para deshabilitar la reacción para un canal o una cuenta.

Las escrituras de configuración iniciadas por canal están habilitadas de forma predeterminada.

Esto afecta los flujos /config set|unset (cuando las funciones de comandos están habilitadas).

Deshabilitar:

{
channels: {
discord: {
  configWrites: false,
},
},
}

Enruta el tráfico WebSocket del Gateway de Discord y las búsquedas REST de inicio (ID de aplicación + resolución de listas de permitidos) a través de un proxy HTTP(S) con channels.discord.proxy.

{
channels: {
discord: {
  proxy: "http://proxy.example:8080",
},
},
}

Anulación por cuenta:

{
channels: {
discord: {
  accounts: {
    primary: {
      proxy: "http://proxy.example:8080",
    },
  },
},
},
}

Habilita la resolución de PluralKit para asignar mensajes proxy a la identidad de miembro del sistema:

{
channels: {
discord: {
  pluralkit: {
    enabled: true,
    token: "pk_live_...", // optional; needed for private systems
  },
},
},
}

Notas:

• las listas de permitidos pueden usar pk:<memberId>
• los nombres visibles de miembros se coinciden por nombre/slug solo cuando channels.discord.dangerouslyAllowNameMatching: true
• las búsquedas usan el ID del mensaje original y están restringidas por ventana de tiempo
• si la búsqueda falla, los mensajes proxy se tratan como mensajes de bot y se descartan salvo que allowBots=true

Usa mentionAliases cuando los agentes necesiten menciones salientes deterministas para usuarios conocidos de Discord. Las claves son identificadores sin la @ inicial; los valores son ID de usuario de Discord. Los identificadores desconocidos, @everyone, @here y las menciones dentro de spans de código Markdown se dejan sin cambios.

{
channels: {
discord: {
  mentionAliases: {
    Vladislava: "123456789012345678",
  },
  accounts: {
    ops: {
      mentionAliases: {
        OpsLead: "234567890123456789",
      },
    },
  },
},
},
}

Las actualizaciones de presencia se aplican cuando estableces un campo de estado o actividad, o cuando habilitas la presencia automática.

Ejemplo solo de estado:

{
channels: {
discord: {
  status: "idle",
},
},
}

Ejemplo de actividad (el estado personalizado es el tipo de actividad predeterminado):

{
channels: {
discord: {
  activity: "Focus time",
  activityType: 4,
},
},
}

Ejemplo de transmisión:

{
channels: {
discord: {
  activity: "Live coding",
  activityType: 1,
  activityUrl: "https://twitch.tv/openclaw",
},
},
}

Mapa de tipos de actividad:

• 0: Jugando
• 1: Transmitiendo (requiere activityUrl)
• 2: Escuchando
• 3: Viendo
• 4: Personalizado (usa el texto de actividad como estado; el emoji es opcional)
• 5: Compitiendo

Ejemplo de presencia automática (señal de salud en tiempo de ejecución):

{
channels: {
discord: {
  autoPresence: {
    enabled: true,
    intervalMs: 30000,
    minUpdateIntervalMs: 15000,
    exhaustedText: "token exhausted",
  },
},
},
}

La presencia automática asigna la disponibilidad en tiempo de ejecución al estado de Discord: healthy => online, degraded o unknown => idle, exhausted o unavailable => dnd. Sobrescrituras de texto opcionales:

• autoPresence.healthyText
• autoPresence.degradedText
• autoPresence.exhaustedText (admite el marcador de posición {reason})

Discord admite la gestión de aprobaciones mediante botones en mensajes directos y, opcionalmente, puede publicar solicitudes de aprobación en el canal de origen.

Ruta de configuración:

• channels.discord.execApprovals.enabled
• channels.discord.execApprovals.approvers (opcional; recurre a commands.ownerAllowFrom cuando es posible)
• channels.discord.execApprovals.target (dm | channel | both, valor predeterminado: dm)
• agentFilter, sessionFilter, cleanupAfterResolve

Discord habilita automáticamente las aprobaciones de ejecución nativas cuando enabled no está definido o es "auto" y se puede resolver al menos un aprobador, ya sea desde execApprovals.approvers o desde commands.ownerAllowFrom. Discord no infiere aprobadores de ejecución a partir de allowFrom del canal, dm.allowFrom heredado ni defaultTo de mensajes directos. Define enabled: false para deshabilitar Discord explícitamente como cliente de aprobación nativo.

Para comandos de grupo sensibles solo para el propietario, como /diagnostics y /export-trajectory, OpenClaw envía solicitudes de aprobación y resultados finales de forma privada. Primero intenta enviar un mensaje directo de Discord cuando el propietario que invoca el comando tiene una ruta de propietario de Discord; si no está disponible, recurre a la primera ruta de propietario disponible de commands.ownerAllowFrom, como Telegram.

Cuando target es channel o both, la solicitud de aprobación es visible en el canal. Solo los aprobadores resueltos pueden usar los botones; otros usuarios reciben una denegación efímera. Las solicitudes de aprobación incluyen el texto del comando, así que habilita la entrega en canal solo en canales de confianza. Si el ID del canal no puede derivarse de la clave de sesión, OpenClaw recurre a la entrega por mensaje directo.

Discord también renderiza los botones de aprobación compartidos que usan otros canales de chat. El adaptador nativo de Discord añade principalmente enrutamiento de mensajes directos para aprobadores y distribución a canales. Cuando esos botones están presentes, son la UX principal de aprobación; OpenClaw solo debe incluir un comando manual /approve cuando el resultado de la herramienta indique que las aprobaciones por chat no están disponibles o que la aprobación manual es la única vía. Si el runtime de aprobación nativo de Discord no está activo, OpenClaw mantiene visible la solicitud local determinista /approve <id> <decision>. Si el runtime está activo pero no se puede entregar una tarjeta nativa a ningún destino, OpenClaw envía un aviso de reserva en el mismo chat con el comando /approve exacto de la aprobación pendiente.

La autenticación de Gateway y la resolución de aprobaciones siguen el contrato compartido del cliente de Gateway (los ID plugin: se resuelven mediante plugin.approval.resolve; otros ID mediante exec.approval.resolve). Las aprobaciones caducan después de 30 minutos de forma predeterminada.

Consulta Aprobaciones de ejecución.

• habilita Message Content Intent
• habilita Server Members Intent cuando dependas de la resolución de usuario/miembro
• reinicia el gateway después de cambiar intents

• verifica groupPolicy
• verifica la lista de permitidos del servidor en channels.discord.guilds
• si existe el mapa channels del servidor, solo se permiten los canales listados
• verifica el comportamiento de requireMention y los patrones de mención

Comprobaciones útiles:

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

Causas comunes:

• groupPolicy="allowlist" sin lista de permitidos de servidor/canal coincidente
• requireMention configurado en el lugar incorrecto (debe estar bajo channels.discord.guilds o en la entrada del canal)
• remitente bloqueado por la lista de permitidos users del servidor/canal

Registros típicos:

• Slow listener detected ...
• stuck session: sessionKey=agent:...:discord:... state=processing ...

Parámetros de la cola de gateway de Discord:

• una sola cuenta: channels.discord.eventQueue.listenerTimeout
• varias cuentas: channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
• esto solo controla el trabajo del listener de gateway de Discord, no la duración del turno del agente

Discord no aplica un tiempo de espera propio del canal a los turnos de agente en cola. Los listeners de mensajes delegan de inmediato, y las ejecuciones de Discord en cola conservan el orden por sesión hasta que el ciclo de vida de sesión/herramienta/runtime completa o aborta el trabajo.

{
channels: {
discord: {
  accounts: {
    default: {
      eventQueue: {
        listenerTimeout: 120000,
      },
    },
  },
},
},
}

OpenClaw obtiene los metadatos /gateway/bot de Discord antes de conectarse. Los fallos transitorios recurren a la URL de Gateway predeterminada de Discord y se limitan por tasa en los registros.

Ajustes de tiempo de espera de metadatos:

• cuenta única: channels.discord.gatewayInfoTimeoutMs
• varias cuentas: channels.discord.accounts.<accountId>.gatewayInfoTimeoutMs
• alternativa de entorno cuando la configuración no está definida: OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS
• valor predeterminado: 30000 (30 segundos), máximo: 120000

OpenClaw espera el evento READY de Gateway de Discord durante el inicio y después de reconexiones en tiempo de ejecución. Las configuraciones con varias cuentas y escalonamiento de inicio pueden necesitar una ventana READY de inicio más larga que la predeterminada.

Ajustes de tiempo de espera de READY:

• inicio con cuenta única: channels.discord.gatewayReadyTimeoutMs
• inicio con varias cuentas: channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
• alternativa de entorno de inicio cuando la configuración no está definida: OPENCLAW_DISCORD_READY_TIMEOUT_MS
• valor predeterminado de inicio: 15000 (15 segundos), máximo: 120000
• tiempo de ejecución con cuenta única: channels.discord.gatewayRuntimeReadyTimeoutMs
• tiempo de ejecución con varias cuentas: channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
• alternativa de entorno de tiempo de ejecución cuando la configuración no está definida: OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
• valor predeterminado de tiempo de ejecución: 30000 (30 segundos), máximo: 120000

Las comprobaciones de permisos de channels status --probe solo funcionan con ID numéricos de canales.

Si usas claves de slug, la coincidencia en tiempo de ejecución aún puede funcionar, pero la sonda no puede verificar completamente los permisos.

• MD deshabilitados: channels.discord.dm.enabled=false
• política de MD deshabilitada: channels.discord.dmPolicy="disabled" (heredado: channels.discord.dm.policy)
• esperando aprobación de emparejamiento en modo pairing

De forma predeterminada, se ignoran los mensajes escritos por bots.

Si estableces channels.discord.allowBots=true, usa reglas estrictas de menciones y listas de permitidos para evitar comportamientos de bucle. Prefiere channels.discord.allowBots="mentions" para aceptar solo mensajes de bots que mencionen al bot.

{
channels: {
discord: {
  accounts: {
    mantis: {
      // Mantis listens to other bots only when they mention her.
      allowBots: "mentions",
    },
    molty: {
      // Molty listens to all bot-authored Discord messages.
      allowBots: true,
      mentionAliases: {
        // Lets Molty write "@Mantis" and send a real Discord mention.
        Mantis: "MANTIS_DISCORD_USER_ID",
      },
    },
  },
},
},
}

• mantén OpenClaw actualizado (openclaw update) para que esté presente la lógica de recuperación de recepción de voz de Discord
• confirma channels.discord.voice.daveEncryption=true (predeterminado)
• empieza con channels.discord.voice.decryptionFailureTolerance=24 (predeterminado upstream) y ajusta solo si es necesario
• revisa los registros en busca de:
  • discord voice: DAVE decrypt failures detected
  • discord voice: repeated decrypt failures; attempting rejoin
• si los fallos continúan después de la reincorporación automática, recopila registros y compáralos con el historial upstream de recepción de DAVE en discord.js #11419 y discord.js #11449