Configuración — canales

Claves de configuración por canal en channels.*: acceso a mensajes directos y grupos, configuraciones multicuenta, control de menciones y claves específicas por canal para Slack, Discord, Telegram, WhatsApp, Matrix, iMessage y otros plugins de canal.

Para agentes, herramientas, el entorno de ejecución del Gateway y otras claves de nivel superior, consulte la Referencia de configuración.

Canales

Cada canal se inicia automáticamente cuando existe su sección de configuración (salvo que enabled: false). Telegram e iMessage se incluyen en el paquete principal openclaw. Otros canales oficiales (Discord, Slack, WhatsApp, Matrix, Microsoft Teams, IRC, Google Chat, Signal, Mattermost y más) se instalan como plugins independientes con openclaw plugins install <spec>; consulte Canales para ver la lista completa y las especificaciones de instalación.

Acceso a mensajes directos y grupos

Todos los canales admiten políticas de mensajes directos y de grupos:

Sustituciones de modelos por canal

Use channels.modelByChannel para fijar identificadores de canal o interlocutores de mensajes directos específicos a un modelo. Los valores admiten provider/model o alias de modelos configurados. La asignación de canales solo se aplica cuando una sesión aún no tiene activa una sustitución de modelo (por ejemplo, una establecida mediante /model).

Para conversaciones de grupos o hilos, las claves son identificadores de grupo, identificadores de tema o nombres de canal específicos del canal. Para conversaciones de mensajes directos (DM), las claves son identificadores de interlocutor derivados de la identidad del remitente del canal (nativeDirectUserId, origin.from, origin.to, OriginatingTo, From o SenderId). El formato exacto de la clave depende del canal:

{  channels: {    modelByChannel: {      discord: {        "123456789012345678": "anthropic/claude-opus-4-6",      },      slack: {        C1234567890: "openai/gpt-5.6-sol",        "user:U12345": "openai/gpt-5.4-mini",      },      telegram: {        "-1001234567890": "openai/gpt-5.4-mini",        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",        "123456789": "openai/gpt-4.1",      },    },  },}

Las claves específicas de DM solo coinciden en conversaciones de mensajes directos; no afectan al enrutamiento de grupos o hilos.

Valores predeterminados de canales y Heartbeat

Use channels.defaults para compartir entre proveedores el comportamiento de las políticas de grupos, las menciones implícitas y Heartbeat:

{  channels: {    defaults: {      groupPolicy: "allowlist", // open | allowlist | disabled      contextVisibility: "all", // all | allowlist | allowlist_quote      implicitMentions: {        replyToBot: true,        quotedBot: true,        threadParticipation: true,      },      heartbeat: {        showOk: false,        showAlerts: true,        useIndicator: true,      },    },  },}

• channels.defaults.groupPolicy: política de grupos alternativa cuando no se ha definido groupPolicy en el nivel del proveedor.
• channels.defaults.contextVisibility: modo predeterminado de visibilidad del contexto complementario para todos los canales. Valores: all (predeterminado, incluye todo el contexto de citas, hilos e historial), allowlist (solo incluye contexto de remitentes incluidos en la lista de permitidos), allowlist_quote (igual que la lista de permitidos, pero conserva el contexto explícito de citas y respuestas). Sustitución por canal: channels.<channel>.contextVisibility.
• channels.defaults.implicitMentions: controla qué hechos entrantes compatibles cuentan como menciones. replyToBot, quotedBot y threadParticipation tienen como valor predeterminado true, lo que conserva el comportamiento actual. Sustituya el valor por canal con channels.<channel>.implicitMentions o por cuenta con channels.<channel>.accounts.<id>.implicitMentions; cada indicador se resuelve de forma independiente en el orden cuenta -> canal -> valores predeterminados. Los nombres son afirmativos: establezca un indicador en false para impedir que ese hecho omita el control de menciones. Las menciones explícitas nativas siempre están permitidas y un indicador no tiene efecto cuando el canal no produce ese hecho. Consulte Control de menciones para ver la matriz actual de productores. Estos ajustes no cambian los modos de respuestas o hilos salientes ni el procesamiento de comandos autorizados.
• channels.defaults.heartbeat.showOk: incluye los estados correctos de los canales en la salida de Heartbeat (valor predeterminado: false).
• channels.defaults.heartbeat.showAlerts: incluye los estados degradados o de error en la salida de Heartbeat (valor predeterminado: true).
• channels.defaults.heartbeat.useIndicator: representa la salida de Heartbeat con un estilo compacto de indicadores (valor predeterminado: true).

WhatsApp

WhatsApp se ejecuta mediante el canal web del Gateway (Baileys Web). Se inicia automáticamente cuando existe una sesión vinculada.

{  web: {    enabled: true,  },  channels: {    whatsapp: {      dmPolicy: "pairing", // pairing | allowlist | open | disabled      allowFrom: ["+15555550123", "+447700900123"],      textChunkLimit: 4000,      streaming: { chunkMode: "length" }, // length | newline      mediaMaxMb: 50,      sendReadReceipts: true, // marcas azules (false en el modo de chat consigo mismo)      groups: {        "*": { requireMention: true },      },      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],    },  },}

• Las entradas bindings[] de nivel superior con type: "acp" configuran vinculaciones ACP persistentes para mensajes directos y grupos de WhatsApp. Use un número directo E.164 o el JID de un grupo de WhatsApp en match.peer.id. La semántica de los campos se describe en Agentes ACP.

{channels: {  whatsapp: {    accounts: {      default: {},      personal: {},      biz: {        // authDir: "~/.openclaw/credentials/whatsapp/biz",      },    },  },},}

Telegram

{  channels: {    telegram: {      enabled: true,      botToken: "your-bot-token",      dmPolicy: "pairing",      allowFrom: ["tg:123456789"],      groups: {        "*": { requireMention: true },        "-1001234567890": {          allowFrom: ["@admin"],          systemPrompt: "Keep answers brief.",          topics: {            "99": {              requireMention: false,              skills: ["search"],              systemPrompt: "Stay on topic.",            },          },        },      },      customCommands: [        { command: "backup", description: "Git backup" },        { command: "generate", description: "Create an image" },      ],      historyLimit: 50,      replyToMode: "first", // off | first | all | batched      linkPreview: true,      streaming: { mode: "partial" }, // off | partial | block | progress (default: partial)      actions: { reactions: true, sendMessage: true },      reactionNotifications: "own", // off | own | all      mediaMaxMb: 100,      retry: {        attempts: 3,        minDelayMs: 400,        maxDelayMs: 30000,        jitter: 0.1,      },      network: {        autoSelectFamily: true,        dnsResultOrder: "ipv4first",      },      apiRoot: "https://api.telegram.org",      trustedLocalFileRoots: ["/srv/telegram-bot-api-data"],      proxy: "socks5://localhost:9050",      webhookUrl: "https://example.com/telegram-webhook",      webhookSecret: "secret",      webhookPath: "/telegram-webhook",    },  },}

• Token del bot: channels.telegram.botToken o channels.telegram.tokenFile (solo archivos normales; se rechazan los enlaces simbólicos), con TELEGRAM_BOT_TOKEN como alternativa para la cuenta predeterminada.
• apiRoot es únicamente la raíz de la API de bots de Telegram. Use https://api.telegram.org o la raíz de su servidor autohospedado o proxy, no https://api.telegram.org/bot<TOKEN>; openclaw doctor --fix elimina un sufijo final /bot<TOKEN> añadido accidentalmente.
• Para un servidor de API de bots autohospedado en modo --local, trustedLocalFileRoots enumera las rutas del host que OpenClaw puede leer. Monte el volumen de datos del servidor en el host de OpenClaw y configure su raíz de datos o el directorio por token; las rutas del contenedor bajo /var/lib/telegram-bot-api se asignan a esas raíces. Las demás rutas absolutas se siguen rechazando.
• El valor opcional channels.telegram.defaultAccount sustituye la selección de cuenta predeterminada cuando coincide con un id. de cuenta configurado.
• En configuraciones multicuenta (2 o más identificadores de cuenta), establezca un valor predeterminado explícito (channels.telegram.defaultAccount o channels.telegram.accounts.default) para evitar el enrutamiento alternativo; openclaw doctor advierte cuando falta o no es válido.
• configWrites: false bloquea las escrituras de configuración iniciadas por Telegram (migraciones de identificadores de supergrupos, /config set|unset).
• Las entradas bindings[] de nivel superior con type: "acp" configuran vinculaciones ACP persistentes para temas de foros (use el valor canónico chatId:topic:topicId en match.peer.id). La semántica de los campos se describe en Agentes ACP.
• Las vistas previas de transmisiones de Telegram usan sendMessage + editMessageText (funciona en chats directos y de grupos).
• network.dnsResultOrder tiene como valor predeterminado "ipv4first" para evitar errores habituales de obtención mediante IPv6.
• Política de reintentos: consulte Política de reintentos.

Discord

{  channels: {    discord: {      enabled: true,      token: "your-bot-token",      mediaMaxMb: 100,      allowBots: false,      actions: {        reactions: true,        stickers: true,        polls: true,        permissions: true,        messages: true,        threads: true,        pins: true,        search: true,        memberInfo: true,        roleInfo: true,        roles: false,        channelInfo: true,        voiceStatus: true,        events: true,        moderation: false,      },      replyToMode: "off", // off | first | all | batched      dmPolicy: "pairing",      allowFrom: ["1234567890", "123456789012345678"],      dm: { enabled: true, groupEnabled: false, groupChannels: ["openclaw-dm"] },      guilds: {        "123456789012345678": {          slug: "friends-of-openclaw",          requireMention: false,          ignoreOtherMentions: true,          reactionNotifications: "own",          users: ["987654321098765432"],          channels: {            general: { allow: true },            help: {              allow: true,              requireMention: true,              users: ["987654321098765432"],              skills: ["docs"],              systemPrompt: "Solo respuestas breves.",            },          },        },      },      historyLimit: 20,      textChunkLimit: 2000,      suppressEmbeds: true,      streaming: {        mode: "progress", // off | partial | block | progress (valor predeterminado de Discord: progress)        chunkMode: "length", // length | newline        progress: {          label: "auto",          maxLines: 8,          maxLineChars: 120,          toolProgress: true,        },      },      maxLinesPerMessage: 17,      ui: {        components: {          accentColor: "#5865F2",        },      },      threadBindings: {        enabled: true,        idleHours: 24,        maxAgeHours: 0,        spawnSessions: true,        defaultSpawnContext: "fork",      },      voice: {        enabled: true,        autoJoin: [          {            guildId: "123456789012345678",            channelId: "234567890123456789",          },        ],        daveEncryption: true,        decryptionFailureTolerance: 24,        connectTimeoutMs: 30000,        reconnectGraceMs: 15000,        tts: {          provider: "openai",          openai: { voice: "alloy" },        },      },      execApprovals: {        enabled: "auto", // true | false | "auto"        approvers: ["987654321098765432"],        agentFilter: ["default"],        sessionFilter: ["discord:"],        target: "dm", // dm | channel | both        cleanupAfterResolve: false,      },      retry: {        attempts: 3,        minDelayMs: 500,        maxDelayMs: 30000,        jitter: 0.1,      },    },  },}

• Token: channels.discord.token, con DISCORD_BOT_TOKEN como alternativa para la cuenta predeterminada.
• Las llamadas salientes directas que proporcionan un token de Discord explícito usan ese token para la llamada; la configuración de reintentos y políticas de la cuenta sigue procediendo de la cuenta seleccionada en la instantánea del entorno de ejecución activo.
• El valor opcional channels.discord.defaultAccount sustituye la selección de la cuenta predeterminada cuando coincide con el id de una cuenta configurada.
• Use user:<id> (DM) o channel:<id> (canal del servidor) como destinos de entrega; se rechazan los ID numéricos sin prefijo.
• Los slugs de los servidores se escriben en minúsculas y sustituyen los espacios por -; las claves de canal usan el nombre convertido en slug (sin #). Se recomienda usar los ID de los servidores.
• Los mensajes enviados por bots se ignoran de forma predeterminada. allowBots: true los habilita; use allowBots: "mentions" para aceptar únicamente los mensajes de bots que mencionen al bot (los mensajes propios se siguen filtrando).
• Los canales que admiten mensajes entrantes enviados por bots pueden usar la protección compartida contra bucles de bots. Establezca channels.defaults.botLoopProtection para los presupuestos básicos por par y, después, sustituya la configuración del canal o de la cuenta únicamente cuando una superficie necesite límites diferentes.
• channels.discord.guilds.<id>.ignoreOtherMentions (y las sustituciones por canal) descarta los mensajes que mencionan a otro usuario o rol, pero no al bot (excepto @everyone/@here).
• channels.discord.mentionAliases asigna el texto estable de salida @handle a los ID de usuario de Discord antes del envío, de modo que se pueda mencionar a miembros conocidos del equipo de manera determinista incluso cuando la caché transitoria del directorio esté vacía. Las sustituciones por cuenta se encuentran en channels.discord.accounts.<accountId>.mentionAliases.
• maxLinesPerMessage (valor predeterminado: 17) divide los mensajes largos verticalmente incluso cuando tienen menos de 2000 caracteres.
• channels.discord.suppressEmbeds tiene como valor predeterminado true, por lo que las URL salientes no se expanden como vistas previas de enlaces de Discord salvo que se deshabilite. Las cargas útiles embeds explícitas se siguen enviando con normalidad; las llamadas de herramientas por mensaje pueden sustituirlo mediante suppressEmbeds.
• channels.discord.threadBindings controla el enrutamiento de Discord vinculado a hilos:
  • enabled: sustitución de Discord para las funciones de sesión vinculadas a hilos (/focus, /unfocus, /agents, /session idle, /session max-age y la entrega/el enrutamiento vinculados)
  • idleHours: sustitución de Discord para la pérdida automática de foco por inactividad, en horas (0 la deshabilita)
  • maxAgeHours: sustitución de Discord para la antigüedad máxima absoluta, en horas (0 la deshabilita)
  • spawnSessions: interruptor para la creación y vinculación automáticas de hilos al generar hilos mediante sessions_spawn({ thread: true }) y ACP (valor predeterminado: true)
  • defaultSpawnContext: contexto nativo del subagente para generaciones vinculadas a hilos ("fork" de forma predeterminada)
• Las entradas bindings[] de nivel superior con type: "acp" configuran vinculaciones persistentes de ACP para canales e hilos (use el id del canal/hilo en match.peer.id). La semántica de los campos se comparte en Agentes ACP.
• channels.discord.ui.components.accentColor establece el color de realce de los contenedores de componentes v2 de Discord.
• channels.discord.agentComponents.ttlMs controla cuánto tiempo permanecen registrados los callbacks enviados de los componentes de Discord. Valor predeterminado: 1800000 (30 minutos); máximo: 86400000 (24 horas). Las sustituciones por cuenta se encuentran en channels.discord.accounts.<accountId>.agentComponents.ttlMs. Se recomienda usar el TTL más corto que se ajuste al flujo de trabajo.
• channels.discord.voice habilita las conversaciones en canales de voz de Discord y las sustituciones opcionales de unión automática, LLM y TTS. Las configuraciones de Discord solo de texto mantienen la voz desactivada de forma predeterminada; establezca channels.discord.voice.enabled=true para habilitarla.
• channels.discord.voice.model sustituye opcionalmente el modelo LLM utilizado para las respuestas en canales de voz de Discord.
• channels.discord.voice.daveEncryption (valor predeterminado: true) y channels.discord.voice.decryptionFailureTolerance (valor predeterminado: 24) se transfieren a las opciones DAVE de @discordjs/voice.
• channels.discord.voice.connectTimeoutMs controla la espera inicial de Ready de @discordjs/voice para /vc join y los intentos de unión automática (valor predeterminado: 30000).
• channels.discord.voice.reconnectGraceMs controla cuánto tiempo puede tardar una sesión de voz desconectada en entrar en la señalización de reconexión antes de que OpenClaw la destruya (valor predeterminado: 15000).
• La reproducción de voz de Discord no se interrumpe cuando otro usuario comienza a hablar. Para evitar bucles de retroalimentación, OpenClaw ignora las nuevas capturas de voz mientras se reproduce TTS.
• Además, OpenClaw intenta recuperar la recepción de voz abandonando la sesión de voz y volviendo a unirse tras repetidos errores de descifrado.
• channels.discord.streaming es la clave canónica del modo de transmisión. Discord usa streaming.mode: "progress" de forma predeterminada para que el progreso del trabajo y de las herramientas aparezca en un único mensaje de vista previa editado; establezca streaming.mode: "off" para deshabilitarlo. Las claves planas antiguas (streamMode, chunkMode, blockStreaming, draftChunk, blockStreamingCoalesce) ya no se leen durante la ejecución; ejecute openclaw doctor --fix para migrar la configuración persistente.
• channels.discord.autoPresence asigna la disponibilidad del entorno de ejecución a la presencia del bot (correcto => en línea, degradado => inactivo, agotado => no molestar) y permite sustituciones opcionales del texto de estado.
• channels.discord.guilds.<id>.presenceEvents dirige las llegadas de disponibilidad de personas a un canal de Discord configurado como eventos del sistema del agente. Los miembros aptos deben poder ver channelId; los hilos públicos heredan la visibilidad del canal principal, mientras que los hilos privados requieren además ser miembro o disponer de Manage Threads. users puede restringir aún más esa audiencia. Inicializa los miembros actualmente en línea a partir de instantáneas completas de GUILD_CREATE, dirige las transiciones observadas de fuera de línea a en línea y considera que una primera señal posterior en línea de un miembro no visto indica que está disponible por primera vez, sin afirmar si se conectó o se unió después de la instantánea. Los servidores que superan el límite de instantáneas de Discord de 75,000 miembros requieren primero una actualización explícita de estado fuera de línea. Controles de limitación: reconnectSuppressSeconds (periodo de inactividad tras una nueva sesión del Gateway mientras se reconstruye el estado de presencia del servidor; valor predeterminado: 300; 0 lo deshabilita) y burstLimit/burstWindowSeconds (límite por servidor de eventos puestos en cola correctamente; valor predeterminado: 8 eventos por ventana móvil de 60s). Las sesiones reanudadas no inician el periodo de supresión de reconexión. El periodo de espera existente para volver a saludar a cada usuario sigue siendo de ocho horas. Requiere channels.discord.intents.presence=true, el Presence Intent privilegiado del Developer Portal de Discord y un Heartbeat del agente habilitado.
• channels.discord.dangerouslyAllowNameMatching vuelve a habilitar la coincidencia mutable de nombres/etiquetas (modo de compatibilidad de emergencia).
• channels.discord.execApprovals: entrega nativa de Discord para aprobaciones de ejecución y autorización de los aprobadores.
  • enabled: true, false o "auto" (valor predeterminado). En el modo automático, las aprobaciones de ejecución se activan cuando se pueden resolver aprobadores a partir de approvers o commands.ownerAllowFrom.
  • approvers: ID de usuario de Discord autorizados para aprobar solicitudes de ejecución. Si se omite, se recurre a commands.ownerAllowFrom.
  • agentFilter: lista de permitidos opcional de ID de agentes. Omítala para reenviar las aprobaciones de todos los agentes.
  • sessionFilter: patrones opcionales de claves de sesión (subcadena o expresión regular).
  • target: dónde enviar las solicitudes de aprobación. "dm" (valor predeterminado) las envía a los DM de los aprobadores, "channel" las envía al canal de origen y "both" las envía a ambos. Cuando el destino incluye "channel", los botones solo pueden utilizarlos los aprobadores resueltos.
  • cleanupAfterResolve: cuando es true, elimina los DM de aprobación tras la aprobación, la denegación o el agotamiento del tiempo de espera.

Modos de notificación de reacciones: off (ninguno), own (mensajes del bot, valor predeterminado), all (todos los mensajes), allowlist (de guilds.<id>.users en todos los mensajes).

Google Chat

{  channels: {    googlechat: {      enabled: true,      serviceAccountFile: "/path/to/service-account.json",      audienceType: "app-url", // app-url | project-number      audience: "https://gateway.example.com/googlechat",      webhookPath: "/googlechat",      botUser: "users/1234567890",      dmPolicy: "pairing",      allowFrom: ["users/1234567890"],      groupPolicy: "allowlist",      groups: {        "spaces/AAAA": { allow: true, requireMention: true },      },      actions: { reactions: true },      typingIndicator: "message",      mediaMaxMb: 20,    },  },}

• JSON de la cuenta de servicio: en línea (serviceAccount) o mediante archivo (serviceAccountFile).
• serviceAccount acepta directamente una SecretRef.
• Alternativas mediante variables de entorno: GOOGLE_CHAT_SERVICE_ACCOUNT o GOOGLE_CHAT_SERVICE_ACCOUNT_FILE (solo para la cuenta predeterminada).
• Use spaces/<spaceId> o users/<userId> como destinos de entrega.
• channels.googlechat.dangerouslyAllowNameMatching vuelve a habilitar la coincidencia mutable de identidades principales de correo electrónico (modo de compatibilidad de emergencia).

Slack

{  channels: {    slack: {      enabled: true,      botToken: "xoxb-...",      appToken: "xapp-...",      socketMode: {        clientPingTimeout: 15000,        serverPingTimeout: 30000,        pingPongLoggingEnabled: false,      },      dmPolicy: "pairing",      allowFrom: ["U123", "U456", "*"],      dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },      channels: {        C123: { enabled: true, requireMention: true, allowBots: false },        "#general": {          enabled: true,          requireMention: true,          allowBots: false,          users: ["U123"],          skills: ["docs"],          systemPrompt: "Short answers only.",        },      },      historyLimit: 50,      allowBots: false,      reactionNotifications: "own",      reactionAllowlist: ["U123"],      replyToMode: "off", // off | first | all | batched      thread: {        historyScope: "thread", // thread | channel        inheritParent: false,        initialHistoryLimit: 20,      },      actions: {        reactions: true,        messages: true,        pins: true,        memberInfo: true,        emojiList: true,      },      slashCommand: {        enabled: true,        name: "openclaw",        sessionPrefix: "slack:slash",        ephemeral: true,      },      typingReaction: "hourglass_flowing_sand",      unfurlLinks: false,      unfurlMedia: false,      textChunkLimit: 4000,      streaming: {        mode: "partial", // off | partial | block | progress        chunkMode: "length", // length | newline        nativeTransport: true, // use Slack native streaming API when mode=partial      },      mediaMaxMb: 20,      execApprovals: {        enabled: "auto", // true | false | "auto"        approvers: ["U123"],        agentFilter: ["default"],        sessionFilter: ["slack:"],        target: "dm", // dm | channel | both      },    },  },}

• El modo Socket requiere tanto botToken como appToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN para usar como alternativa las variables de entorno de la cuenta predeterminada).
• El modo HTTP requiere botToken además de signingSecret (en la raíz o por cuenta).
• La identidad de usuario (identity: "user") publica y lee como la persona que concede la autorización. Requiere userToken además de appToken en el modo Socket, o userToken además de signingSecret en el modo HTTP. No se requiere ningún token de bot ni usuario de bot. Consulte Identidad de usuario para conocer los ámbitos de usuario y las suscripciones a eventos.
• enterpriseOrgInstall: true incorpora una cuenta a la ruta de eventos de toda la organización de Slack Enterprise Grid. Al iniciarse, verifica el token del bot con auth.test y falla cuando el modo configurado no coincide con la identidad de instalación de Slack. Los mensajes directos empresariales deben estar desactivados o usar dmPolicy: "open" con un allowFrom: ["*"] efectivo. Las políticas de canales y usuarios deben usar identificadores estables de Slack; los nombres mutables y los prefijos de canal no compatibles provocan un fallo durante el inicio. V1 solo gestiona eventos directos del modo Socket o HTTP message y app_mention con respuestas inmediatas; no están disponibles la retransmisión, los comandos, las interacciones, App Home, los escuchadores de eventos de reacciones, los elementos fijados, las herramientas de acciones, las aprobaciones nativas, las vinculaciones, la entrega diferida ni los envíos proactivos. La confirmación, la indicación de escritura y las reacciones de estado controladas por el escuchador siguen disponibles con reactions:write; las notificaciones de reacciones entrantes y las herramientas de acciones de reacción no están disponibles. Consulte Instalaciones de Enterprise Grid para toda la organización para conocer el manifiesto de privilegios mínimos, el flujo de configuración y todas las restricciones.
• socketMode transmite el ajuste del transporte del modo Socket del SDK de Slack a la API pública del receptor de Bolt. Úselo únicamente al investigar tiempos de espera de ping/pong o el comportamiento de websockets obsoletos. El valor predeterminado de clientPingTimeout es 15000; serverPingTimeout y pingPongLoggingEnabled solo se transmiten cuando están configurados.
• botToken, appToken, signingSecret y userToken aceptan cadenas de texto sin formato u objetos SecretRef.
• Las instantáneas de cuentas de Slack exponen campos de origen y estado por credencial, como botTokenSource, botTokenStatus, userTokenSource, userTokenStatus, appTokenStatus y, en el modo HTTP, signingSecretStatus. configured_unavailable significa que la cuenta está configurada mediante SecretRef, pero la ruta actual del comando o del entorno de ejecución no pudo resolver el valor secreto.
• configWrites: false bloquea las escrituras de configuración iniciadas por Slack.
• El valor opcional channels.slack.defaultAccount reemplaza la selección de la cuenta predeterminada cuando coincide con el identificador de una cuenta configurada.
• channels.slack.streaming.mode es la clave canónica del modo de transmisión de Slack (valor predeterminado: "partial"). channels.slack.streaming.nativeTransport controla el transporte de transmisión nativo de Slack (valor predeterminado: true). Los valores heredados streamMode, el booleano streaming, chunkMode, blockStreaming, blockStreamingCoalesce y nativeStreaming ya no se leen durante la ejecución; ejecute openclaw doctor --fix para migrar la configuración persistente a streaming.{mode,chunkMode,block.enabled,block.coalesce,nativeTransport}.
• unfurlLinks y unfurlMedia transmiten los booleanos de despliegue de enlaces y contenido multimedia chat.postMessage de Slack para las respuestas del bot. El valor predeterminado de unfurlLinks es false, por lo que los enlaces salientes del bot no se expanden en línea salvo que se habilite esta opción; unfurlMedia se omite a menos que esté configurado. Establezca cualquiera de los valores en channels.slack.accounts.<accountId> para reemplazar el valor de nivel superior en una cuenta.
• Use user:<id> (mensaje directo) o channel:<id> como destinos de entrega.

Modos de notificación de reacciones: off, own (predeterminado), all, allowlist (de reactionAllowlist).

Aislamiento de sesiones de hilos: thread.historyScope funciona por hilo (predeterminado) o se comparte en todo el canal. thread.inheritParent copia la transcripción del canal principal en los hilos nuevos. thread.initialHistoryLimit (valor predeterminado: 20) limita cuántos mensajes existentes del hilo se recuperan cuando se inicia una nueva sesión de hilo; 0 desactiva la recuperación del historial del hilo.

• La transmisión nativa de Slack y el estado de hilo «is typing...» al estilo del asistente de Slack requieren un hilo como destino de respuesta. Los mensajes directos de nivel superior permanecen fuera de los hilos de forma predeterminada, por lo que pueden seguir transmitiéndose mediante vistas previas de borrador publicadas y editadas en Slack, en lugar de mostrar la vista previa nativa de transmisión y estado propia de los hilos.
• typingReaction añade una reacción temporal al mensaje entrante de Slack mientras se genera una respuesta y la elimina al finalizar. Use un código corto de emoji de Slack, como "hourglass_flowing_sand".
• channels.slack.execApprovals: entrega del cliente de aprobaciones nativo de Slack y autorización de aprobadores de ejecución. Usa el mismo esquema que Discord: enabled (true/false/"auto"), approvers (identificadores de usuario de Slack), agentFilter, sessionFilter y target ("dm", "channel" o "both"). Las aprobaciones de plugins pueden usar esta ruta del cliente nativo para solicitudes originadas en Slack cuando se resuelven los aprobadores del plugin de Slack; la entrega de aprobaciones de plugins nativa de Slack también puede habilitarse mediante approvals.plugin para sesiones originadas en Slack o destinos de Slack. Las aprobaciones de plugins usan los aprobadores del plugin de Slack de allowFrom y el enrutamiento predeterminado, no los aprobadores de ejecución.

Mattermost

Mattermost se instala como un plugin independiente, del mismo modo que Discord, Slack y WhatsApp:

openclaw plugins install @openclaw/mattermost

Consulte npmjs.com/package/@openclaw/mattermost para conocer las etiquetas de distribución actuales antes de fijar una versión.

{  channels: {    mattermost: {      enabled: true,      botToken: "mm-token",      baseUrl: "https://chat.example.com",      dmPolicy: "pairing",      chatmode: "oncall", // oncall | onmessage | onchar      oncharPrefixes: [">", "!"],      groups: {        "*": { requireMention: true },        "team-channel-id": { requireMention: false },      },      commands: {        native: true, // opt-in        nativeSkills: true,        callbackPath: "/api/channels/mattermost/command",        // Optional explicit URL for reverse-proxy/public deployments        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",      },      textChunkLimit: 4000,      streaming: { chunkMode: "length" },    },  },}

Modos de chat: oncall (responder ante una mención con @, predeterminado), onmessage (cada mensaje), onchar (mensajes que comienzan con el prefijo activador).

Cuando los comandos nativos de Mattermost están habilitados:

• commands.callbackPath debe ser una ruta (por ejemplo, /api/channels/mattermost/command), no una URL completa.
• commands.callbackUrl debe resolverse en el endpoint del Gateway de OpenClaw y ser accesible desde el servidor de Mattermost.
• Las devoluciones de llamada de comandos de barra nativos se autentican mediante los tokens de cada comando que devuelve Mattermost durante el registro del comando de barra. Si el registro falla o no se activa ningún comando, OpenClaw rechaza las devoluciones de llamada con Unauthorized: invalid command token.
• Para hosts de devolución de llamada privados, de una red Tailscale o internos, Mattermost puede requerir que ServiceSettings.AllowedUntrustedInternalConnections incluya el host o dominio de devolución de llamada. Use valores de host o dominio, no URL completas.
• channels.mattermost.configWrites: permitir o denegar las escrituras de configuración iniciadas por Mattermost.
• channels.mattermost.requireMention: requerir @mention antes de responder en los canales.
• channels.mattermost.groups.<channelId>.requireMention: reemplazo por canal del requisito de mención ("*" como valor predeterminado).
• El valor opcional channels.mattermost.defaultAccount reemplaza la selección de la cuenta predeterminada cuando coincide con el identificador de una cuenta configurada.

Signal

{  channels: {    signal: {      enabled: true,      account: "+15555550123", // optional account binding      dmPolicy: "pairing",      allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],      configWrites: true,      reactionNotifications: "own", // off | own | all | allowlist      reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],      historyLimit: 50,    },  },}

Modos de notificación de reacciones: off, own (predeterminado), all, allowlist (de reactionAllowlist).

• channels.signal.account: vincular el inicio del canal a una identidad de cuenta específica de Signal.
• channels.signal.configWrites: permitir o denegar las escrituras de configuración iniciadas por Signal.
• El valor opcional channels.signal.defaultAccount reemplaza la selección de la cuenta predeterminada cuando coincide con el identificador de una cuenta configurada.

iMessage

OpenClaw inicia imsg rpc (JSON-RPC mediante entrada y salida estándar). No se requiere ningún daemon ni puerto. Esta es la ruta preferida para las nuevas configuraciones de iMessage en OpenClaw cuando el host puede conceder permisos para la base de datos de Messages y Automation.

Se eliminó la compatibilidad con BlueBubbles. channels.bluebubbles no es una superficie de configuración del entorno de ejecución compatible con la versión actual de OpenClaw. Migre las configuraciones antiguas a channels.imessage; consulte Eliminación de BlueBubbles y la ruta de imsg para iMessage para obtener la versión breve y Migración desde BlueBubbles para consultar la tabla de traducción completa.

Si el Gateway no se ejecuta en el Mac con la sesión de Messages iniciada, conserve channels.imessage.enabled=true y establezca channels.imessage.cliPath en un contenedor SSH que ejecute imsg "$@" en ese Mac. La ruta local predeterminada imsg solo funciona en macOS.

Antes de depender de un contenedor SSH para los envíos de producción, verifique un imsg send saliente mediante ese contenedor exacto. Algunos estados de TCC de macOS asignan la automatización de Mensajes a /usr/libexec/sshd-keygen-wrapper, lo que puede permitir que las lecturas y las sondas funcionen mientras los envíos fallan con AppleEvents -1743; consulte la sección de solución de problemas del contenedor SSH en iMessage.

{  channels: {    imessage: {      enabled: true,      cliPath: "imsg",      dbPath: "~/Library/Messages/chat.db",      remoteHost: "user@gateway-host",      dmPolicy: "pairing",      allowFrom: ["+15555550123", "user@example.com", "chat_id:123"],      historyLimit: 50,      includeAttachments: false,      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],      mediaMaxMb: 16,      service: "auto",      sendTransport: "auto",      region: "US",      actions: {        reactions: true,        edit: true,        unsend: true,        reply: true,        sendWithEffect: true,        sendAttachment: true,      },    },  },}

• El valor opcional channels.imessage.defaultAccount anula la selección predeterminada de la cuenta cuando coincide con el id de una cuenta configurada.
• Requiere acceso total al disco para la base de datos de Mensajes.
• Se prefieren los destinos chat_id:<id>. Utilice imsg chats --limit 20 para enumerar los chats.
• cliPath puede apuntar a un contenedor SSH; establezca remoteHost (host o user@host) para obtener archivos adjuntos mediante SCP.
• attachmentRoots y remoteAttachmentRoots restringen las rutas de los archivos adjuntos entrantes (valor predeterminado: /Users/*/Library/Messages/Attachments).
• SCP utiliza una comprobación estricta de las claves de host, por lo que debe asegurarse de que la clave del host de retransmisión ya exista en ~/.ssh/known_hosts.
• channels.imessage.configWrites: permite o deniega las escrituras de configuración iniciadas desde iMessage.
• channels.imessage.sendTransport: transporte de envío RPC imsg preferido para las respuestas salientes normales. auto (valor predeterminado) utiliza el puente IMCore para los chats existentes cuando está en ejecución y, después, recurre a AppleScript; bridge requiere la entrega mediante una API privada; applescript fuerza la ruta pública de automatización de Mensajes.
• channels.imessage.actions.*: habilita acciones de API privada que también están condicionadas por imsg status / openclaw channels status --probe.
• channels.imessage.includeAttachments está desactivado de forma predeterminada; establézcalo en true antes de esperar contenido multimedia entrante en los turnos del agente.
• La recuperación entrante después de reiniciar un puente o el Gateway es automática (deduplicación mediante GUID más un límite de antigüedad para la acumulación obsoleta). Las configuraciones channels.imessage.catchup.enabled: true existentes siguen admitiéndose como perfil de compatibilidad obsoleto; catchup está deshabilitado de forma predeterminada.
• channels.imessage.groups: registro de grupos y configuración por grupo. Con groupPolicy: "allowlist", configure claves chat_id explícitas o una entrada comodín "*" para que los mensajes de grupo puedan superar el control del registro.
• Las entradas bindings[] de nivel superior con type: "acp" pueden vincular conversaciones de iMessage a sesiones ACP persistentes. Utilice un identificador normalizado o un destino de chat explícito (chat_id:*, chat_guid:*, chat_identifier:*) en match.peer.id. Semántica de los campos compartidos: Agentes ACP.

#!/usr/bin/env bashexec ssh -T gateway-host imsg "$@"

Matrix

Matrix funciona mediante un plugin y se configura en channels.matrix.

{  channels: {    matrix: {      enabled: true,      homeserver: "https://matrix.example.org",      accessToken: "syt_bot_xxx",      proxy: "http://127.0.0.1:7890",      encryption: true,      initialSyncLimit: 20,      defaultAccount: "ops",      accounts: {        ops: {          name: "Operaciones",          userId: "@ops:example.org",          accessToken: "syt_ops_xxx",        },        alerts: {          userId: "@alerts:example.org",          password: "secret",          proxy: "http://127.0.0.1:7891",        },      },    },  },}

• La autenticación mediante token utiliza accessToken; la autenticación mediante contraseña utiliza userId + password.
• channels.matrix.proxy dirige el tráfico HTTP de Matrix a través de un proxy HTTP(S) explícito. Las cuentas con nombre pueden anularlo mediante channels.matrix.accounts.<id>.proxy.
• channels.matrix.network.dangerouslyAllowPrivateNetwork permite servidores domésticos privados o internos. proxy y esta habilitación de red son controles independientes.
• channels.matrix.defaultAccount selecciona la cuenta preferida en configuraciones con varias cuentas.
• channels.matrix.autoJoin utiliza "off" de forma predeterminada, por lo que las salas a las que se recibe una invitación y las nuevas invitaciones de tipo mensaje directo se ignoran hasta que se establece autoJoin: "allowlist" con autoJoinAllowlist o autoJoin: "always".
• channels.matrix.execApprovals: entrega nativa de Matrix para aprobaciones de ejecución y autorización de los aprobadores.
  • enabled: true, false o "auto" (valor predeterminado). En modo automático, las aprobaciones de ejecución se activan cuando los aprobadores pueden resolverse desde approvers o commands.ownerAllowFrom.
  • approvers: id de usuario de Matrix (por ejemplo, @owner:example.org) con permiso para aprobar solicitudes de ejecución.
  • agentFilter: lista de agentes permitidos opcional. Omítala para reenviar las aprobaciones de todos los agentes.
  • sessionFilter: patrones opcionales de claves de sesión (subcadena o expresión regular).
  • target: dónde enviar las solicitudes de aprobación. "dm" (valor predeterminado), "channel" (sala de origen) o "both".
  • Valores de anulación por cuenta: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope controla cómo se agrupan los mensajes directos de Matrix en sesiones: per-user (valor predeterminado) los comparte por interlocutor enrutado, mientras que per-room aísla cada sala de mensajes directos.
• Las sondas de estado de Matrix y las búsquedas en vivo en el directorio utilizan la misma política de proxy que el tráfico en tiempo de ejecución.
• La configuración completa de Matrix, las reglas de destino y los ejemplos de configuración están documentados en Matrix.

Microsoft Teams

Microsoft Teams funciona mediante un plugin y se configura en channels.msteams.

{  channels: {    msteams: {      enabled: true,      configWrites: true,      // appId, appPassword, tenantId, webhook y políticas de equipo/canal:      // consulte /channels/msteams    },  },}

• Rutas de claves principales tratadas aquí: channels.msteams, channels.msteams.configWrites.
• La configuración completa de Teams (credenciales, webhook, política de mensajes directos/grupos y valores de anulación por equipo/canal) está documentada en Microsoft Teams.

IRC

IRC funciona mediante un plugin y se configura en channels.irc.

{  channels: {    irc: {      enabled: true,      dmPolicy: "pairing",      configWrites: true,      nickserv: {        enabled: true,        service: "NickServ",        password: "${IRC_NICKSERV_PASSWORD}",        register: false,        registerEmail: "bot@example.com",      },    },  },}

• Rutas de claves principales tratadas aquí: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• El valor opcional channels.irc.defaultAccount anula la selección predeterminada de la cuenta cuando coincide con el id de una cuenta configurada.
• La configuración completa del canal IRC (host/puerto/TLS/canales/listas de permitidos/control mediante menciones) está documentada en IRC.

Varias cuentas (todos los canales)

Ejecute varias cuentas por canal (cada una con su propio accountId):

{  channels: {    telegram: {      accounts: {        default: {          name: "Bot principal",          botToken: "123456:ABC...",        },        alerts: {          name: "Bot de alertas",          botToken: "987654:XYZ...",        },      },    },  },}

• default se utiliza cuando se omite accountId (CLI + enrutamiento).
• Los tokens de entorno solo se aplican a la cuenta predeterminada.
• La configuración base del canal se aplica a todas las cuentas, salvo que se anule en una cuenta concreta.
• Utilice bindings[].match.accountId para dirigir cada cuenta a un agente diferente.
• Si se añade una cuenta no predeterminada mediante openclaw channels add (o la incorporación del canal) mientras se sigue utilizando una configuración de canal de nivel superior para una sola cuenta, OpenClaw promueve primero los valores de nivel superior con ámbito de cuenta y propios de una sola cuenta al mapa de cuentas del canal para que la cuenta original siga funcionando. La mayoría de los canales los trasladan a channels.<channel>.accounts.default; Matrix puede conservar en su lugar un destino existente coincidente, ya sea con nombre o predeterminado.
• Las vinculaciones existentes únicamente por canal (sin accountId) siguen coincidiendo con la cuenta predeterminada; las vinculaciones con ámbito de cuenta continúan siendo opcionales.
• openclaw doctor --fix también repara las estructuras mixtas trasladando los valores de nivel superior con ámbito de cuenta y propios de una sola cuenta a la cuenta promovida elegida para ese canal. La mayoría de los canales utilizan accounts.default; Matrix puede conservar en su lugar un destino existente coincidente, ya sea con nombre o predeterminado.

Otros canales de plugins

Muchos canales de plugins se configuran como channels.<id> y se documentan en sus páginas de canal específicas (por ejemplo, Feishu, LINE, Nextcloud Talk, Nostr, QQ Bot, Synology Chat, Twitch y Zalo). Consulte el índice completo de canales: Canales.

Control mediante menciones en chats de grupo

De forma predeterminada, los mensajes de grupo requieren una mención (mención en los metadatos o patrones seguros de expresiones regulares). Se aplica a los chats de grupo de WhatsApp, Telegram, Discord, Google Chat e iMessage.

Las respuestas visibles se controlan por separado. De forma predeterminada, las solicitudes directas normales de grupos, canales y WebChat interno utilizan la entrega final automática: el texto final del asistente se publica mediante la ruta heredada de respuestas visibles. Habilite messages.visibleReplies: "message_tool" o messages.groupChat.visibleReplies: "message_tool" cuando las respuestas de origen creadas por el modelo solo deban publicarse después de que el agente llame a message(action=send). Si el modelo devuelve una respuesta final sustancial sin llamar a la herramienta de mensajes en un modo de solo herramientas habilitado, ese texto final permanece privado, el registro detallado del Gateway registra los metadatos de la carga útil suprimida y OpenClaw pone en cola un reintento de recuperación que solicita al modelo que entregue la misma respuesta mediante message(action=send).

La política de solo herramientas rige las respuestas de origen del asistente y el contenido multimedia genérico de las herramientas. No suprime la salida de terminal que pertenece al tiempo de ejecución, como las respuestas de comandos autorizados, los avisos persistentes de finalización ni los artefactos nativos del proveedor que el entorno propietario clasifica explícitamente como pertenecientes al host. Los artefactos pertenecientes al host se entregan mediante la ruta normal de envío del canal y siguen respetando la denegación saliente de sendPolicy. Los turnos ambientales room_event permanecen silenciosos salvo que sean comandos explícitos, incluso cuando la salida del tiempo de ejecución esté marcada como perteneciente al host.

Las respuestas visibles de solo herramientas requieren un modelo o entorno de ejecución que llame a las herramientas de forma fiable, y se recomiendan para salas ambientales compartidas con modelos de última generación como GPT-5.6 Sol. Algunos modelos menos capaces pueden responder con texto final, pero no comprenden que la salida visible en el origen debe enviarse mediante message(action=send). OpenClaw recupera de forma predeterminada el caso común de una respuesta final bloqueada solo cuando dicha respuesta es sustancial, el turno de origen no era un evento de sala, la política de envío no denegó la entrega y todavía no se había enviado ninguna respuesta al origen. La recuperación se limita a un solo reintento; suprime la persistencia de la solicitud sintética de reintento y mantiene ese reintento fuera del procesamiento por lotes de recopilación para que no pueda combinarse con solicitudes en cola no relacionadas. Si el reintento también queda bloqueado o no puede ponerse en cola, OpenClaw entrega únicamente un diagnóstico depurado, como «He generado una respuesta, pero no he podido entregarla en este chat. Inténtelo de nuevo». El texto final privado original nunca se marca para su entrega automática al origen. En el caso de los modelos que bloquean respuestas repetidamente, utilice "automatic" para que el turno final del asistente sea la ruta de respuesta visible, cambie a un modelo más capaz de llamar a herramientas, inspeccione el registro detallado del Gateway para consultar el resumen de la carga útil suprimida o establezca messages.groupChat.visibleReplies: "automatic" para utilizar respuestas finales visibles en todas las solicitudes de grupos o canales.

Si la herramienta de mensajes no está disponible según la política de herramientas activa, OpenClaw recurre a respuestas visibles automáticas en lugar de suprimir silenciosamente la respuesta. openclaw doctor advierte sobre esta discrepancia.

Esta regla se aplica al texto final normal del agente. Las vinculaciones de conversación propiedad de un plugin usan la respuesta devuelta por el plugin propietario como respuesta visible para los turnos reclamados del hilo vinculado; el plugin no necesita llamar a message(action=send) para esas respuestas de vinculación.

Solución de problemas: una @mención en un grupo activa el indicador de escritura y luego no ocurre nada (sin error)

Síntoma: una @mención en un grupo/canal muestra el indicador de escritura y el registro del Gateway informa de dispatch complete (queuedFinal=false, replies=0), pero no llega ningún mensaje a la sala. Los mensajes directos al mismo agente reciben respuesta normalmente.

Causa: el modo de respuesta visible del grupo/canal se resuelve como "message_tool", por lo que OpenClaw ejecuta el turno, pero suprime el texto final del asistente a menos que el agente llame a message(action=send). En este modo no existe ningún contrato NO_REPLY; si no se llama a la herramienta de mensajes, el texto final original es privado. Para los turnos de origen sustanciales, OpenClaw ahora intenta un reintento de recuperación protegido; las notas breves, el silencio explícito, los eventos de sala, los turnos denegados por la política de envío y los turnos ya entregados no se reintentan. Los turnos normales de grupos y canales usan "automatic" de forma predeterminada, por lo que este síntoma solo aparece cuando messages.groupChat.visibleReplies (o el valor global messages.visibleReplies) se establece explícitamente en "message_tool". El valor defaultVisibleReplies del arnés no se aplica aquí: el solucionador de grupos/canales lo ignora; solo afecta a los chats directos/de origen (el arnés de Codex suprime de ese modo los textos finales de los chats directos).

Solución: usar un modelo con mayor capacidad para llamar a herramientas, eliminar la sustitución explícita "message_tool" para volver al valor predeterminado "automatic", o establecer messages.groupChat.visibleReplies: "automatic" para forzar respuestas visibles en cada solicitud de grupo/canal. Un texto final sustancial que quede sin entregar ya no debería terminar como un éxito silencioso; debería recuperarse mediante un reintento message(action=send) o mostrar el diagnóstico saneado de fallo de entrega. El Gateway recarga en caliente la configuración messages después de guardar el archivo; solo es necesario reiniciar el Gateway cuando la supervisión de archivos o la recarga de configuración estén deshabilitadas en el despliegue.

Tipos de menciones:

• Menciones de metadatos: @menciones nativas de la plataforma. Se ignoran en el modo de chat con uno mismo de WhatsApp.
• Patrones de texto: patrones de expresiones regulares seguros en agents.entries.*.groupChat.mentionPatterns. Se ignoran los patrones no válidos y las repeticiones anidadas no seguras.
• El control por menciones solo se aplica cuando es posible detectarlas (menciones nativas o al menos un patrón).

{  messages: {    visibleReplies: "automatic", // fuerza las respuestas finales automáticas anteriores para chats directos/de origen    groupChat: {      historyLimit: 50,      unmentionedInbound: "room_event", // la conversación de sala permanente sin menciones se convierte en contexto silencioso      visibleReplies: "message_tool", // opción voluntaria; exige message(action=send) para respuestas visibles en la sala    },  },  agents: {    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],  },}

messages.groupChat.historyLimit establece el valor predeterminado global. Los canales pueden sustituirlo mediante channels.<channel>.historyLimit (o por cuenta). Establezca 0 para deshabilitarlo.

messages.groupChat.unmentionedInbound: "room_event" envía los mensajes permanentes de grupos/canales sin menciones como contexto silencioso de la sala en los canales compatibles. Los mensajes con menciones, los comandos y los mensajes directos siguen siendo solicitudes del usuario. Consulte Eventos ambientales de sala para ver ejemplos completos de Discord, Slack y Telegram.

messages.visibleReplies es el valor predeterminado global para los eventos de origen; messages.groupChat.visibleReplies lo sustituye para los eventos de origen de grupos/canales. Cuando messages.visibleReplies no está establecido, los chats directos/de origen usan el valor predeterminado del entorno de ejecución o del arnés seleccionado, pero los turnos directos internos de WebChat usan la entrega final automática para mantener la paridad de solicitudes de Pi/Codex. Establezca messages.visibleReplies: "message_tool" para exigir deliberadamente message(action=send) para generar una salida visible. Las listas de permitidos de los canales y el control por menciones siguen determinando si se procesa un evento.

Límites del historial de mensajes directos

{  channels: {    telegram: {      dmHistoryLimit: 30,      dms: {        "123456789": { historyLimit: 50 },      },    },  },}

Resolución: sustitución por mensaje directo → valor predeterminado del proveedor → sin límite (se conserva todo).

Este solucionador lee channels.<provider>.dmHistoryLimit y channels.<provider>.dms.<id>.historyLimit para cualquier canal cuya clave de sesión siga la forma estándar provider:direct:<id> (o la forma heredada provider:dm:<id>), por lo que funciona tanto con canales incluidos como con canales de plugins, no solo con una lista fija.

Modo de chat con uno mismo

Incluya su propio número en allowFrom para habilitar el modo de chat con uno mismo (ignora las @menciones nativas y solo responde a patrones de texto):

{  channels: {    whatsapp: {      allowFrom: ["+15555550123"],      groups: { "*": { requireMention: true } },    },  },  agents: {    list: [      {        id: "main",        groupChat: { mentionPatterns: ["reisponde", "@openclaw"] },      },    ],  },}

Comandos (gestión de comandos de chat)

{  commands: {    native: "auto", // registra comandos nativos cuando son compatibles    nativeSkills: "auto", // registra comandos nativos de Skills cuando son compatibles    text: true, // analiza /commands en mensajes de chat    bash: false, // permite ! (alias: /bash)    bashForegroundMs: 2000,    config: false, // permite /config    mcp: false, // permite /mcp    plugins: false, // permite /plugins    debug: false, // permite /debug    restart: true, // permite /restart y solicitudes externas de reinicio SIGUSR1    ownerAllowFrom: ["discord:123456789012345678"],    ownerDisplay: "raw", // raw | hash    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",    allowFrom: {      "*": ["user1"],      discord: ["user:123"],    },    useAccessGroups: true,  },}

Relacionado

• Referencia de configuración — claves de nivel superior
• Configuración — agentes
• Descripción general de los canales