OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Developer and self-hosted

Mattermost

Estado: plugin descargable (token de bot + eventos de WebSocket). Se admiten canales, canales privados, MD de grupo y MD. Mattermost es una plataforma de mensajería para equipos que puede alojarse en infraestructura propia (mattermost.com).

Instalación

Registro de npm

bash
openclaw plugins install @openclaw/mattermost

Copia de trabajo local

bash
openclaw plugins install ./path/to/local/mattermost-plugin

Detalles: Plugins

Configuración rápida

  • Asegurarse de que el plugin esté disponible

    Instale @openclaw/mattermost con el comando anterior y, si el Gateway ya está en ejecución, reinícielo.

  • Crear un bot de Mattermost

    Cree una cuenta de bot de Mattermost, copie el token del bot y añada el bot a los equipos y canales que deba leer.

  • Copiar la URL base

    Copie la URL base de Mattermost (p. ej., https://chat.example.com). La /api/v4 final se elimina automáticamente.

  • Configurar OpenClaw e iniciar el Gateway

    Configuración mínima:

    json5
    {  channels: {    mattermost: {      enabled: true,      botToken: "mm-token",      baseUrl: "https://chat.example.com",      dmPolicy: "pairing",    },  },}

    Alternativa no interactiva:

    bash
    openclaw channels add --channel mattermost --bot-token <token> --http-url https://chat.example.com

    • Comandos de barra nativos

    Los comandos de barra nativos son opcionales. Cuando están habilitados, OpenClaw registra comandos de barra oc_* en todos los equipos a los que pertenece el bot y recibe solicitudes POST de devolución de llamada en el servidor HTTP del Gateway.

    json5
    {  channels: {    mattermost: {      commands: {        native: true,        nativeSkills: true,        callbackPath: "/api/channels/mattermost/command",        // Úselo cuando Mattermost no pueda acceder directamente al Gateway (proxy inverso/URL pública).        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",      },    },  },}

    Comandos registrados: /oc_status, /oc_model, /oc_models, /oc_new, /oc_help, /oc_think, /oc_reasoning, /oc_verbose, /oc_queue. Con nativeSkills: true, los comandos de Skills también se registran como /oc_<skill>.

    Notas de comportamiento
    • native y nativeSkills tienen como valor predeterminado "auto", que en Mattermost se resuelve como deshabilitado. Establézcalos explícitamente en true.
    • callbackPath tiene como valor predeterminado /api/channels/mattermost/command.
    • Si se omite callbackUrl, OpenClaw deriva http://<gateway.customBindHost or localhost>:<gateway.port, default 18789><callbackPath>. Los hosts de enlace comodín (0.0.0.0, ::) recurren a localhost.
    • En configuraciones con varias cuentas, commands puede establecerse en el nivel superior o dentro de channels.mattermost.accounts.<id>.commands (los valores de cuenta prevalecen sobre los campos del nivel superior).
    • Los comandos de barra existentes con el mismo activador creados por otras integraciones no se modifican (el registro los omite); los comandos creados por el bot se actualizan o vuelven a crear cuando cambia la URL de devolución de llamada.
    • Las devoluciones de llamada de comandos se validan con los tokens específicos de cada comando que Mattermost devuelve cuando OpenClaw registra los comandos oc_*.
    • OpenClaw actualiza el registro actual de comandos de Mattermost antes de aceptar cada devolución de llamada, por lo que los tokens obsoletos de comandos de barra eliminados o regenerados dejan de aceptarse sin necesidad de reiniciar el Gateway.
    • La validación de devoluciones de llamada se cierra de forma segura si la API de Mattermost no puede confirmar que el comando siga vigente; las validaciones fallidas se almacenan brevemente en caché, las consultas simultáneas se agrupan y los inicios de nuevas consultas se limitan por comando para acotar la presión de repetición.
    • Las devoluciones de llamada de comandos de barra se cierran de forma segura cuando falla el registro, el inicio es parcial o el token de devolución de llamada no coincide con el token registrado del comando resuelto (un token válido para un comando no puede alcanzar la validación ascendente de otro comando).
    • Las devoluciones de llamada aceptadas se confirman con una respuesta efímera "Procesando..."; la respuesta real llega como un mensaje normal.
    Requisito de accesibilidad

    El servidor de Mattermost debe poder acceder al endpoint de devolución de llamada.

    • No establezca callbackUrl en localhost a menos que Mattermost se ejecute en el mismo host/espacio de nombres de red que OpenClaw.
    • No establezca callbackUrl en la URL base de Mattermost a menos que esa URL use un proxy inverso para dirigir /api/channels/mattermost/command a OpenClaw.
    • Una comprobación rápida es curl https://<gateway-host>/api/channels/mattermost/command; una solicitud GET debe devolver 405 Method Not Allowed desde OpenClaw, no 404.
    Lista de permitidos para el tráfico saliente de Mattermost

    Si el destino de la devolución de llamada usa direcciones privadas/de tailnet/internas, configure ServiceSettings.AllowedUntrustedInternalConnections de Mattermost para incluir el host/dominio de devolución de llamada.

    Use entradas de host/dominio, no URL completas.

    • Correcto: gateway.tailnet-name.ts.net
    • Incorrecto: https://gateway.tailnet-name.ts.net

    Variables de entorno (cuenta predeterminada)

    Configure estas variables en el host del Gateway si prefiere usar variables de entorno:

    • MATTERMOST_BOT_TOKEN=...
    • MATTERMOST_URL=https://chat.example.com

    Modos de chat

    Mattermost responde automáticamente a los MD. El comportamiento en los canales se controla mediante chatmode:

    oncall (predeterminado)

    Responde solo cuando se menciona al bot con @ en los canales.

    onmessage

    Responde a todos los mensajes del canal.

    onchar

    Responde cuando un mensaje comienza con un prefijo activador.

    Ejemplo de configuración:

    json5
    {  channels: {    mattermost: {      chatmode: "onchar",      oncharPrefixes: [">", "!"], // predeterminado    },  },}

    Notas:

    • onchar sigue respondiendo a las menciones explícitas con @.
    • channels.mattermost.requireMention se sigue respetando, pero se prefiere chatmode. La configuración groups.<channelId>.requireMention de cada canal prevalece sobre ambas.
    • Después de que el bot envíe una respuesta visible en un hilo de canal, los mensajes posteriores del mismo hilo se responden sin una nueva mención con @ ni un prefijo onchar, por lo que las conversaciones de varios turnos del hilo siguen fluyendo. La participación se recuerda durante 7 días desde la última respuesta del bot en ese hilo y persiste entre reinicios del Gateway. Los hilos que el bot solo ha observado no se ven afectados; inicie un nuevo mensaje de nivel superior para volver a exigir una mención explícita.
    • Establezca channels.mattermost.implicitMentions.threadParticipation: false para impedir que los seguimientos de hilos con participación omitan el requisito de mención. Las anulaciones de cuenta usan channels.mattermost.accounts.<id>.implicitMentions. Mattermost no genera actualmente datos replyToBot ni quotedBot, por lo que esas opciones no tienen efecto aquí.

    Hilos y sesiones

    Use channels.mattermost.replyToMode para controlar si las respuestas de canales y grupos permanecen en el canal principal o inician un hilo bajo la publicación activadora.

    • off (predeterminado): solo responde en un hilo cuando la publicación entrante ya está en uno.
    • first: para publicaciones de nivel superior de canales/grupos, inicia un hilo bajo esa publicación y dirige la conversación a una sesión específica del hilo.
    • all y batched: actualmente tienen el mismo comportamiento que first en Mattermost, porque una vez que Mattermost tiene una raíz de hilo, los fragmentos y archivos multimedia posteriores continúan en ese mismo hilo.
    • Los mensajes directos usan de forma predeterminada off incluso cuando se establece replyToMode.

    Use channels.mattermost.replyToModeByChatType para anular el modo de los chats direct, group o channel. Establezca direct para habilitar el uso de hilos en los mensajes directos:

    • off (predeterminado): los mensajes directos permanecen sin hilos en una única sesión continua.
    • first, all o batched: cada mensaje directo de nivel superior inicia un hilo de Mattermost respaldado por una sesión nueva e independiente.
    json5
    {  channels: {    mattermost: {      replyToMode: "all",      replyToModeByChatType: {        direct: "first",      },    },  },}

    Notas:

    • Las sesiones específicas de un hilo usan el id de la publicación activadora como raíz del hilo.
    • first y all son equivalentes actualmente porque, una vez que Mattermost tiene una raíz de hilo, los fragmentos y archivos multimedia posteriores continúan en ese mismo hilo.
    • Las anulaciones por tipo de chat prevalecen sobre replyToMode. Sin una anulación direct, las implementaciones existentes conservan los MD planos y sin hilos.

    Control de acceso (MD)

    • Valor predeterminado: channels.mattermost.dmPolicy = "pairing" (los remitentes desconocidos reciben un código de vinculación). Otros valores: allowlist, open, disabled.
    • Aprobación mediante:
      • openclaw pairing list mattermost
      • openclaw pairing approve mattermost &lt;CODE&gt;
    • MD públicos: channels.mattermost.dmPolicy="open" más channels.mattermost.allowFrom=["*"] (el esquema de configuración exige el comodín).
    • channels.mattermost.allowFrom acepta ids de usuario (recomendado) y entradas accessGroup:<name>. Consulte Grupos de acceso.

    Canales (grupos)

    • Valor predeterminado: channels.mattermost.groupPolicy = "allowlist" (requiere mención).
    • Incluya remitentes en la lista de permitidos mediante channels.mattermost.groupAllowFrom (se recomiendan los IDs de usuario).
    • channels.mattermost.groupAllowFrom acepta entradas accessGroup:<name>. Consulte Grupos de acceso.
    • Las anulaciones de menciones por canal se encuentran en channels.mattermost.groups.<channelId>.requireMention, o en channels.mattermost.groups["*"].requireMention para establecer un valor predeterminado.
    • La coincidencia de @username es mutable y solo se habilita cuando channels.mattermost.dangerouslyAllowNameMatching: true.
    • Canales abiertos: channels.mattermost.groupPolicy="open" (requieren mención).
    • Orden de resolución: channels.mattermost.groupPolicy, después channels.defaults.groupPolicy y, por último, "allowlist".
    • Nota de ejecución: si falta por completo la sección channels.mattermost, durante la ejecución se aplica de forma segura groupPolicy="allowlist" a las comprobaciones de grupos (incluso si se establece channels.defaults.groupPolicy) y se registra una advertencia una sola vez.

    Ejemplo:

    json5
    {  channels: {    mattermost: {      groupPolicy: "open",      groups: {        "*": { requireMention: true },        "team-channel-id": { requireMention: false },      },    },  },}

    Destinos para entregas salientes

    Use estos formatos de destino con openclaw message send o cron/webhooks:

    Destino Entrega en
    channel:<id> Canal por id
    channel:<name> o #channel-name Canal por nombre, buscado en los equipos a los que pertenece el bot
    user:<id> o mattermost:<id> MD con ese usuario
    @username MD (nombre de usuario resuelto mediante la API de Mattermost)

    Los envíos salientes admiten como máximo un archivo adjunto por mensaje; divida varios archivos en envíos separados.

    Reintento del canal de MD

    Cuando OpenClaw envía a un destino de MD de Mattermost y primero necesita resolver el canal directo, de forma predeterminada reintenta los fallos transitorios de creación del canal directo.

    Use channels.mattermost.dmChannelRetry para ajustar este comportamiento globalmente para el plugin de Mattermost, o channels.mattermost.accounts.<id>.dmChannelRetry para una cuenta. Valores predeterminados:

    json5
    {  channels: {    mattermost: {      dmChannelRetry: {        maxRetries: 3,        initialDelayMs: 1000,        maxDelayMs: 10000,        timeoutMs: 30000,      },    },  },}

    Notas:

    • Esto solo se aplica a la creación de canales de MD (/api/v4/channels/direct), no a todas las llamadas a la API de Mattermost.
    • Los reintentos usan retroceso exponencial con fluctuación aleatoria y se aplican a fallos transitorios, como límites de frecuencia, respuestas 5xx y errores de red o de tiempo de espera.
    • Los errores de cliente 4xx distintos de 429 se consideran permanentes y no se reintentan.

    Transmisión de vista previa

    Mattermost transmite el razonamiento, la actividad de herramientas y el texto parcial de la respuesta en una publicación de vista previa en borrador que se finaliza en el mismo lugar cuando es seguro enviar la respuesta final. En el modo partial, la vista previa se actualiza con el mismo ID de publicación en lugar de saturar el canal con mensajes por cada fragmento. En el modo block, la vista previa alterna entre el texto completado y los bloques de actividad de herramientas, de modo que los bloques anteriores permanecen visibles como publicaciones independientes en lugar de ser sobrescritos por el siguiente. Los resultados finales con contenido multimedia o errores cancelan las ediciones de vista previa pendientes y usan la entrega normal en lugar de publicar una vista previa descartable.

    La transmisión de vista previa está activada de forma predeterminada en el modo partial. Se configura mediante channels.mattermost.streaming.mode (los valores escalares/booleanos heredados de streaming se migran mediante openclaw doctor --fix):

    json5
    {  channels: {    mattermost: {      streaming: { mode: "partial" }, // desactivado | parcial | bloque | progreso    },  },}
    Modos de transmisión
    • partial (predeterminado): una publicación de vista previa que se edita a medida que crece la respuesta y que después se finaliza con la respuesta completa.
    • block alterna la vista previa entre el texto completado y los bloques de actividad de herramientas, de modo que cada bloque permanece visible como una publicación independiente en lugar de ser sobrescrito en el mismo lugar. Las actualizaciones de herramientas paralelas y consecutivas comparten la publicación actual de actividad de herramientas.
    • progress muestra una vista previa del estado durante la generación y solo publica la respuesta final al terminar.
    • off desactiva la transmisión de vista previa. Con streaming.block.enabled: true, los bloques completados del asistente se siguen entregando como respuestas de bloque normales (publicaciones separadas), en lugar de como una única publicación final combinada.
    Notas sobre el comportamiento de la transmisión
    • Si la transmisión no puede finalizarse en el mismo lugar (por ejemplo, si la publicación se elimina durante la transmisión), OpenClaw recurre al envío de una nueva publicación final para que la respuesta nunca se pierda.
    • Las cargas útiles que solo contienen razonamiento se omiten de las publicaciones del canal, incluido el texto que llega como una cita en bloque > Thinking. Establezca /reasoning on para ver el razonamiento en otras superficies; la publicación final de Mattermost conserva únicamente la respuesta.
    • Consulte Transmisión para ver la matriz de correspondencia de canales.

    Reacciones (herramienta de mensajes)

    • Use message action=react con channel=mattermost.
    • messageId es el ID de publicación de Mattermost.
    • emoji acepta nombres como thumbsup o :+1: (los dos puntos son opcionales).
    • Establezca remove=true (booleano) para eliminar una reacción.
    • Los eventos de adición o eliminación de reacciones se reenvían como eventos del sistema a la sesión del agente enrutada, sujetos a las mismas comprobaciones de políticas de MD/grupo que los mensajes.

    Ejemplos:

    text
    message action=react channel=mattermost target=channel:<channelId> messageId=<postId> emoji=thumbsupmessage action=react channel=mattermost target=channel:<channelId> messageId=<postId> emoji=thumbsup remove=true

    Configuración:

    • channels.mattermost.actions.reactions: habilita o deshabilita las acciones de reacción (valor predeterminado: true).
    • Modificación por cuenta: channels.mattermost.accounts.<id>.actions.reactions.

    Botones interactivos (herramienta de mensajes)

    Envíe mensajes con botones en los que se pueda hacer clic. Cuando un usuario hace clic en un botón, el agente recibe la selección y puede responder.

    Los botones proceden de la carga útil semántica presentation (en las respuestas normales del agente y en message action=send). OpenClaw representa los botones de valor como botones interactivos de Mattermost, mantiene visibles los botones de URL en el texto del mensaje y degrada los menús de selección a texto legible.

    text
    message action=send channel=mattermost target=channel:<channelId> presentation={"blocks":[{"type":"buttons","buttons":[{"label":"Sí","value":"yes"},{"label":"No","value":"no"}]}]}

    Campos de los botones de presentación:

    labelstringrequired

    Etiqueta visible (alias: text).

    valuestring

    Valor devuelto al hacer clic, usado como ID de acción (alias: callback_data, callbackData). Es obligatorio para un botón en el que se pueda hacer clic, salvo que se establezca url.

    urlstring

    Botón de enlace; se representa como texto label: url en el cuerpo del mensaje en lugar de como botón interactivo.

    style"primary" | "secondary" | "success" | "danger"

    Estilo del botón. Mattermost aplica el estilo predeterminado a los valores que no admite.

    Para anunciar la compatibilidad con botones en el mensaje del sistema del agente, añada inlineButtons a las capacidades del canal:

    json5
    {  channels: {    mattermost: {      capabilities: ["inlineButtons"],    },  },}

    Cuando un usuario hace clic en un botón:

  • Comprobación de acceso

    Quien hace clic debe superar las mismas comprobaciones de políticas de MD/grupo que el remitente de un mensaje; los clics no autorizados reciben un aviso efímero y se ignoran.

  • Botones sustituidos por una confirmación

    Todos los botones se sustituyen por una línea de confirmación (p. ej., "✓ Sí seleccionado por @user").

  • El agente recibe la selección

    El agente recibe la selección como un mensaje entrante (además de un evento del sistema) y responde.

    • Notas de implementación
    • Las devoluciones de llamada de los botones usan verificación HMAC-SHA256 (automática, no requiere configuración).
    • Al hacer clic se sustituye todo el bloque de datos adjuntos, por lo que todos los botones se eliminan juntos; no es posible eliminarlos parcialmente.
    • Los ID de acción que contienen guiones o guiones bajos se depuran automáticamente (limitación del enrutamiento de Mattermost).
    • Los clics cuyo action_id no coincide con una acción de la publicación original se rechazan con 403 ("Acción desconocida").
    Configuración y accesibilidad
    • channels.mattermost.capabilities: matriz de cadenas de capacidades. Añada "inlineButtons" para habilitar la descripción de la herramienta de botones en el mensaje del sistema del agente.
    • channels.mattermost.interactions.callbackBaseUrl: URL base externa opcional para las devoluciones de llamada de los botones (por ejemplo, https://gateway.example.com). Úsela cuando Mattermost no pueda acceder directamente al gateway en su host de enlace.
    • En configuraciones con varias cuentas, también puede establecerse el mismo campo en channels.mattermost.accounts.<id>.interactions.callbackBaseUrl.
    • Si se omite interactions.callbackBaseUrl, OpenClaw deriva la URL de devolución de llamada de gateway.customBindHost + gateway.port (valor predeterminado: 18789) y, a continuación, recurre a http://localhost:<port>. La ruta de devolución de llamada es /mattermost/interactions/<accountId>.
    • Regla de accesibilidad: el servidor de Mattermost debe poder acceder a la URL de devolución de llamada del botón. localhost solo funciona cuando Mattermost y OpenClaw se ejecutan en el mismo host/espacio de nombres de red.
    • channels.mattermost.interactions.allowedSourceIps: lista de permitidos de direcciones IP de origen para las devoluciones de llamada de los botones. Sin ella, solo se aceptan orígenes de bucle invertido (127.0.0.1, ::1), por lo que debe añadirse aquí un servidor remoto de Mattermost a la lista de permitidos; de lo contrario, sus clics se rechazan con 403. Si se usa un proxy inverso, establezca también gateway.trustedProxies para que la IP real del cliente se derive de los encabezados reenviados.
    • Si el destino de la devolución de llamada es privado, de la red de Tailscale o interno, añada su host/dominio a ServiceSettings.AllowedUntrustedInternalConnections de Mattermost.

    Integración directa con la API (scripts externos)

    Los scripts externos y Webhooks pueden publicar botones directamente mediante la API REST de Mattermost en lugar de pasar por la herramienta message del agente. Se recomienda usar la herramienta message de OpenClaw. Para las integraciones directas, importe buildButtonAttachments de @openclaw/mattermost/api.js; si se publica JSON sin procesar, deben seguirse estas reglas:

    Estructura de la carga útil:

    json5
    {  channel_id: "<channelId>",  message: "Elija una opción:",  props: {    attachments: [      {        actions: [          {            id: "mybutton01", // solo alfanumérico; consulte más abajo            type: "button", // obligatorio; de lo contrario, los clics se ignoran silenciosamente            name: "Aprobar", // etiqueta visible            style: "primary", // opcional: "default", "primary", "danger"            integration: {              url: "https://gateway.example.com/mattermost/interactions/default",              context: {                action_id: "mybutton01", // debe coincidir con el ID del botón                action: "approve",                // ... cualquier campo personalizado ...                _token: "<hmac>", // consulte la sección sobre HMAC más abajo              },            },          },        ],      },    ],  },}

    Generación del token HMAC

    El gateway verifica los clics en los botones con HMAC-SHA256. Los scripts externos deben generar tokens que coincidan con la lógica de verificación del gateway:

  • Derivar el secreto del token del bot

    HMAC-SHA256(key="openclaw-mattermost-interactions", data=botToken), codificado en hexadecimal.

  • Crear el objeto de contexto

    Cree el objeto de contexto con todos los campos excepto _token.

  • Serializar con las claves ordenadas

    Serialice con las claves ordenadas de forma recursiva y sin espacios (el gateway también canoniza los objetos anidados y genera JSON compacto).

  • Firmar la carga útil

    HMAC-SHA256(key=secret, data=serializedContext)

  • Añadir el token

    Añada el resumen hexadecimal resultante como _token en el contexto.

    • Ejemplo en Python:

    python
     secret = hmac.new(    b"openclaw-mattermost-interactions",    bot_token.encode(), hashlib.sha256).hexdigest() ctx = {"action_id": "mybutton01", "action": "approve"}payload = json.dumps(ctx, sort_keys=True, separators=(",", ":"))token = hmac.new(secret.encode(), payload.encode(), hashlib.sha256).hexdigest() context = {**ctx, "_token": token}
    Errores comunes de HMAC
    • El json.dumps de Python añade espacios de forma predeterminada ({"key": "val"}). Use separators=(",", ":") para que coincida con la salida compacta de JavaScript ({"key":"val"}).
    • Firme siempre todos los campos de contexto (excepto _token). El Gateway elimina _token y después firma todo lo restante. Firmar un subconjunto provoca un fallo de verificación silencioso.
    • Use sort_keys=True: el Gateway ordena las claves antes de firmar, y Mattermost puede reordenar los campos de contexto al almacenar la carga útil.
    • Derive el secreto del token del bot (de forma determinista), no de bytes aleatorios. El secreto debe ser el mismo en el proceso que crea los botones y en el Gateway que realiza la verificación.

    Adaptador de directorio

    El Plugin de Mattermost incluye un adaptador de directorio que resuelve los nombres de canales y usuarios mediante la API de Mattermost. Esto habilita los destinos #channel-name y @username en openclaw message send y en las entregas de cron/webhook.

    No se necesita ninguna configuración: el adaptador usa el token del bot de la configuración de la cuenta.

    Varias cuentas

    Mattermost admite varias cuentas en channels.mattermost.accounts:

    json5
    {  channels: {    mattermost: {      accounts: {        default: { name: "Primary", botToken: "mm-token", baseUrl: "https://chat.example.com" },        alerts: { name: "Alerts", botToken: "mm-token-2", baseUrl: "https://alerts.example.com" },      },    },  },}

    Los valores de la cuenta sustituyen a los campos de nivel superior; channels.mattermost.defaultAccount selecciona qué cuenta se utiliza cuando no se especifica ninguna.

    Solución de problemas

    No hay respuestas en los canales

    Asegúrese de que el bot esté en el canal y menciónelo (oncall), use un prefijo de activación (onchar) o configure chatmode: "onmessage".

    Errores de autenticación o de varias cuentas
    • Compruebe el token del bot, la URL base y si la cuenta está habilitada.
    • Problemas con varias cuentas: las variables de entorno solo se aplican a la cuenta default.
    • Los hosts privados o de LAN de Mattermost necesitan network.dangerouslyAllowPrivateNetwork: true (la protección contra SSRF bloquea las IP privadas de forma predeterminada).
    Los comandos de barra nativos fallan
    • Unauthorized: invalid command token.: OpenClaw no aceptó el token de devolución de llamada. Causas habituales:
      • el registro del comando de barra falló o solo se completó parcialmente durante el inicio
      • la devolución de llamada está llegando al Gateway o a la cuenta equivocados
      • Mattermost aún tiene comandos antiguos que apuntan a un destino de devolución de llamada anterior
      • el Gateway se reinició sin reactivar los comandos de barra
    • Si los comandos de barra nativos dejan de funcionar, busque mattermost: failed to register slash commands o mattermost: native slash commands enabled but no commands could be registered en los registros.
    • Si se omite callbackUrl y los registros advierten que la devolución de llamada se resolvió en una URL de bucle invertido como http://localhost:18789/..., probablemente solo se pueda acceder a esa URL cuando Mattermost se ejecute en el mismo host o espacio de nombres de red que OpenClaw. En su lugar, establezca un commands.callbackUrl explícito al que se pueda acceder externamente.
    Problemas con los botones
    • Los botones aparecen como cuadros blancos o no aparecen: los datos del botón tienen un formato incorrecto. Cada botón de presentación necesita un label y un value (los botones a los que les falte cualquiera de los dos se descartan).
    • Los botones se muestran, pero al hacer clic no ocurre nada: compruebe que el servidor de Mattermost pueda acceder al Gateway, que la IP del servidor de Mattermost esté incluida en channels.mattermost.interactions.allowedSourceIps (sin esta opción, solo se acepta el bucle invertido) y que ServiceSettings.AllowedUntrustedInternalConnections incluya el host de devolución de llamada para destinos privados.
    • Los botones devuelven un error 404 al hacer clic: es probable que el id del botón contenga guiones o guiones bajos. El enrutador de acciones de Mattermost falla con los identificadores no alfanuméricos. Use solo [a-zA-Z0-9].
    • El Gateway registra rejected callback source: el clic procedió de una IP ajena a interactions.allowedSourceIps. Añada el servidor de Mattermost o su punto de entrada a la lista de permitidos y configure gateway.trustedProxies detrás de un proxy inverso.
    • El Gateway registra invalid _token: discrepancia de HMAC. Compruebe que se firmen todos los campos de contexto (no un subconjunto), que se usen claves ordenadas y JSON compacto (sin espacios). Consulte la sección sobre HMAC anterior.
    • El Gateway registra missing _token in context: el campo _token no está en el contexto del botón. Asegúrese de incluirlo al crear la carga útil de integración.
    • El Gateway rechaza el clic con Unknown action: context.action_id no coincide con ningún id de acción de la publicación. Establezca ambos con el mismo valor depurado.
    • El agente no ofrece botones: añada capabilities: ["inlineButtons"] a la configuración del canal de Mattermost.

    Temas relacionados

    Was this useful?
    On this page

    On this page