> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Configuración — canales Claves de configuración por canal bajo `channels.*`: acceso a DM y grupos, configuraciones de varias cuentas, control por menciones y claves por canal para Slack, Discord, Telegram, WhatsApp, Matrix, iMessage y otros plugins de canal. Para agentes, herramientas, runtime de Gateway y otras claves de nivel superior, consulta [Referencia de configuración](/es/gateway/configuration-reference). ## Canales Cada canal se inicia automáticamente cuando existe su sección de configuración (a menos que `enabled: false`). Telegram e iMessage se distribuyen dentro del paquete central `openclaw`. Otros canales oficiales (Discord, Slack, WhatsApp, Matrix, Microsoft Teams, IRC, Google Chat, Signal, Mattermost y más) se instalan como plugins separados con `openclaw plugins install `; consulta [Canales](/es/channels) para ver la lista completa y las especificaciones de instalación. ### Acceso a DM y grupos Todos los canales admiten políticas de DM y políticas de grupo: | Política de DM | Comportamiento | | -------------------------- | ------------------------------------------------------------------------------------------------------------- | | `pairing` (predeterminada) | Los remitentes desconocidos reciben un código de emparejamiento de un solo uso; el propietario debe aprobarlo | | `allowlist` | Solo remitentes en `allowFrom` (o en el almacén de permitidos emparejados) | | `open` | Permite todos los DM entrantes (requiere `allowFrom: ["*"]`) | | `disabled` | Ignora todos los DM entrantes | | Política de grupo | Comportamiento | | ---------------------------- | ------------------------------------------------------------------------------------ | | `allowlist` (predeterminada) | Solo grupos que coincidan con la lista de permitidos configurada | | `open` | Omite las listas de permitidos de grupo (el control por menciones sigue aplicándose) | | `disabled` | Bloquea todos los mensajes de grupo/sala | `channels.defaults.groupPolicy` establece el valor predeterminado cuando `groupPolicy` de un proveedor no está definido. Los códigos de emparejamiento caducan después de 1 hora. Las solicitudes de emparejamiento pendientes tienen un límite de **3 por cuenta** (acotadas por canal e id de cuenta). Si falta por completo un bloque de proveedor (`channels.` ausente), la política de grupo del runtime recurre a `allowlist` (cerrado por seguridad) con una advertencia al inicio. ### Anulaciones de modelo por canal Usa `channels.modelByChannel` para fijar IDs de canal específicos o pares de mensaje directo a un modelo. Los valores aceptan `provider/model` o alias de modelo configurados. La asignación de canales solo se aplica cuando una sesión aún no tiene una anulación de modelo activa (por ejemplo, una establecida mediante `/model`). Para conversaciones de grupo/hilo, las claves son IDs de grupo específicos del canal, IDs de tema o nombres de canal. Para conversaciones de mensaje directo (DM), las claves son identificadores de pares derivados de la identidad del remitente del canal (`nativeDirectUserId`, `origin.from`, `origin.to`, `OriginatingTo`, `From` o `SenderId`). La forma exacta de la clave depende del canal: | Canal | Forma de clave de DM | Ejemplo | | -------- | -------------------------- | -------------------------------------------- | | Discord | ID de usuario sin procesar | `987654321` | | Feishu | `feishu:ou_...` | `feishu:ou_a8b6cab7e945387de5f253775d9b4d85` | | Matrix | ID de usuario de Matrix | `@user:matrix.org` | | Slack | `user:U...` | `user:U12345` | | Telegram | ID de usuario sin procesar | `123456789` | | WhatsApp | número de teléfono o JID | `15551234567` | ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { modelByChannel: { discord: { "123456789012345678": "anthropic/claude-opus-4-6", }, slack: { C1234567890: "openai/gpt-5.5", "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 mensaje directo; no afectan el enrutamiento de grupos/hilos. ### Valores predeterminados de canal y Heartbeat Usa `channels.defaults` para compartir la política de grupo y el comportamiento de Heartbeat entre proveedores: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { defaults: { groupPolicy: "allowlist", // open | allowlist | disabled contextVisibility: "all", // all | allowlist | allowlist_quote heartbeat: { showOk: false, showAlerts: true, useIndicator: true, }, }, }, } ``` * `channels.defaults.groupPolicy`: política de grupo de reserva cuando `groupPolicy` a nivel de proveedor no está definido. * `channels.defaults.contextVisibility`: modo predeterminado de visibilidad de contexto complementario para todos los canales. Valores: `all` (predeterminado, incluye todo el contexto citado/de hilo/de historial), `allowlist` (solo incluye contexto de remitentes en la lista de permitidos), `allowlist_quote` (igual que allowlist, pero conserva el contexto explícito de cita/respuesta). Anulación por canal: `channels..contextVisibility`. * `channels.defaults.heartbeat.showOk`: incluye estados de canal saludables en la salida de Heartbeat (predeterminado `false`). * `channels.defaults.heartbeat.showAlerts`: incluye estados degradados/de error en la salida de Heartbeat (predeterminado `true`). * `channels.defaults.heartbeat.useIndicator`: renderiza una salida de Heartbeat compacta con estilo de indicador (predeterminado `true`). ### WhatsApp WhatsApp se ejecuta a través del canal web del Gateway (Baileys Web). Se inicia automáticamente cuando existe una sesión vinculada. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { web: { enabled: true, heartbeatSeconds: 60, whatsapp: { keepAliveIntervalMs: 25000, connectTimeoutMs: 60000, defaultQueryTimeoutMs: 60000, }, reconnect: { initialMs: 2000, maxMs: 30000, factor: 1.8, jitter: 0.25, maxAttempts: 12, // 0 = retry forever }, }, channels: { whatsapp: { dmPolicy: "pairing", // pairing | allowlist | open | disabled allowFrom: ["+15555550123", "+447700900123"], textChunkLimit: 4000, chunkMode: "length", // length | newline mediaMaxMb: 50, sendReadReceipts: true, // blue ticks (false in self-chat mode) groups: { "*": { requireMention: true }, }, groupPolicy: "allowlist", groupAllowFrom: ["+15551234567"], }, }, } ``` * `web.whatsapp.keepAliveIntervalMs` (predeterminado `25000`), `connectTimeoutMs` (predeterminado `60000`) y `defaultQueryTimeoutMs` (predeterminado `60000`) ajustan el socket de Baileys. * Valores predeterminados de `web.reconnect`: `initialMs: 2000`, `maxMs: 30000`, `factor: 1.8`, `jitter: 0.25`, `maxAttempts: 12`. `maxAttempts: 0` reintenta indefinidamente en lugar de abandonar. * Las entradas de nivel superior `bindings[]` con `type: "acp"` configuran vinculaciones ACP persistentes para DM y grupos de WhatsApp. Usa un número directo E.164 o un JID de grupo de WhatsApp en `match.peer.id`. La semántica de los campos se comparte en [Agentes ACP](/es/tools/acp-agents#persistent-channel-bindings). ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { whatsapp: { accounts: { default: {}, personal: {}, biz: { // authDir: "~/.openclaw/credentials/whatsapp/biz", }, }, }, }, } ``` * Los comandos salientes usan por defecto la cuenta `default` si está presente; de lo contrario, el primer id de cuenta configurado (ordenado). * El valor opcional `channels.whatsapp.defaultAccount` anula esa selección de cuenta predeterminada de reserva cuando coincide con un id de cuenta configurado. * El directorio de autenticación heredado de Baileys de una sola cuenta se migra mediante `openclaw doctor` a `whatsapp/default`. * Anulaciones por cuenta: `channels.whatsapp.accounts..sendReadReceipts`, `channels.whatsapp.accounts..dmPolicy`, `channels.whatsapp.accounts..allowFrom`. ### Telegram ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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: "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 archivo normal; se rechazan los enlaces simbólicos), con `TELEGRAM_BOT_TOKEN` como reserva para la cuenta predeterminada. * `apiRoot` es solo la raíz de la API de bots de Telegram. Usa `https://api.telegram.org` o tu raíz autohospedada/proxy, no `https://api.telegram.org/bot`; `openclaw doctor --fix` elimina un sufijo accidental final `/bot`. * Para un servidor de API de bots autohospedado en modo `--local`, `trustedLocalFileRoots` enumera rutas del host que OpenClaw puede leer. Monta el volumen de datos del servidor en el host de OpenClaw y configura su raíz de datos o el directorio por token; las rutas de contenedor bajo `/var/lib/telegram-bot-api` se asignan a esas raíces. Otras rutas absolutas se siguen rechazando. * El valor opcional `channels.telegram.defaultAccount` anula la selección de cuenta predeterminada cuando coincide con un id de cuenta configurado. * En configuraciones de varias cuentas (2+ ids de cuenta), establece un valor predeterminado explícito (`channels.telegram.defaultAccount` o `channels.telegram.accounts.default`) para evitar el enrutamiento de reserva; `openclaw doctor` advierte cuando falta o no es válido. * `configWrites: false` bloquea escrituras de configuración iniciadas desde Telegram (migraciones de ID de supergrupo, `/config set|unset`). * Las entradas de nivel superior `bindings[]` con `type: "acp"` configuran vinculaciones ACP persistentes para temas de foro (usa el `chatId:topic:topicId` canónico en `match.peer.id`). La semántica de los campos se comparte en [Agentes ACP](/es/tools/acp-agents#persistent-channel-bindings). * Las vistas previas de streaming de Telegram usan `sendMessage` + `editMessageText` (funciona en chats directos y de grupo). * `network.dnsResultOrder` tiene como valor predeterminado `"ipv4first"` para evitar fallos comunes de obtención por IPv6. * Política de reintentos: consulta [Política de reintentos](/es/concepts/retry). ### Discord ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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: "Short answers only.", }, }, }, }, historyLimit: 20, textChunkLimit: 2000, suppressEmbeds: true, chunkMode: "length", // length | newline streaming: { mode: "progress", // off | partial | block | progress (Discord default: progress) 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 reserva para la cuenta predeterminada. * Las llamadas salientes directas que proporcionan un `token` de Discord explícito usan ese token para la llamada; los ajustes de reintento/política de cuenta siguen viniendo de la cuenta seleccionada en la instantánea activa del entorno de ejecución. * El ajuste opcional `channels.discord.defaultAccount` invalida la selección de cuenta predeterminada cuando coincide con un id de cuenta configurado. * Usa `user:` (DM) o `channel:` (canal de servidor) para los destinos de entrega; los ID numéricos sin prefijo se rechazan. * Los slugs de servidor van en minúsculas con los espacios reemplazados por `-`; las claves de canal usan el nombre convertido a slug (sin `#`). Prefiere los ID de servidor. * Los mensajes escritos por bots se ignoran de forma predeterminada. `allowBots: true` los habilita; usa `allowBots: "mentions"` para aceptar solo mensajes de bot que mencionen al bot (los mensajes propios se siguen filtrando). * Los canales que admiten mensajes entrantes escritos por bots pueden usar la [protección contra bucles de bots](/es/channels/bot-loop-protection) compartida. Configura `channels.defaults.botLoopProtection` para los presupuestos base por par y luego sobrescribe el canal o la cuenta solo cuando una superficie necesite límites diferentes. * `channels.discord.guilds..ignoreOtherMentions` (y las sobrescrituras de canal) descarta mensajes que mencionan a otro usuario o rol pero no al bot (excluyendo @everyone/@here). * `channels.discord.mentionAliases` asigna texto saliente `@handle` estable a ID de usuario de Discord antes de enviar, para que se pueda mencionar a compañeros conocidos de forma determinista incluso cuando la caché transitoria de directorio esté vacía. Las sobrescrituras por cuenta están en `channels.discord.accounts..mentionAliases`. * `maxLinesPerMessage` (predeterminado `17`) divide mensajes altos incluso cuando tienen menos de 2000 caracteres. * `channels.discord.suppressEmbeds` tiene como valor predeterminado `true`, por lo que las URL salientes no se expanden en vistas previas de enlace de Discord salvo que se deshabilite. Las cargas útiles `embeds` explícitas se siguen enviando normalmente; las llamadas de herramienta por mensaje pueden sobrescribirlo con `suppressEmbeds`. * `channels.discord.threadBindings` controla el enrutamiento vinculado a hilos de Discord: * `enabled`: sobrescritura de Discord para funciones de sesión vinculadas a hilos (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age` y entrega/enrutamiento vinculados) * `idleHours`: sobrescritura de Discord para el auto-unfocus por inactividad en horas (`0` lo deshabilita) * `maxAgeHours`: sobrescritura de Discord para la edad máxima estricta en horas (`0` lo deshabilita) * `spawnSessions`: interruptor para `sessions_spawn({ thread: true })` y la creación/vinculación automática de hilos por generación de hilos ACP (predeterminado: `true`) * `defaultSpawnContext`: contexto nativo de subagente para generaciones vinculadas a hilos (`"fork"` de forma predeterminada) * Las entradas de nivel superior `bindings[]` con `type: "acp"` configuran vinculaciones ACP persistentes para canales e hilos (usa el id de canal/hilo en `match.peer.id`). La semántica de los campos se comparte en [Agentes ACP](/es/tools/acp-agents#persistent-channel-bindings). * `channels.discord.ui.components.accentColor` define el color de énfasis para los contenedores de componentes v2 de Discord. * `channels.discord.agentComponents.ttlMs` controla cuánto tiempo permanecen registrados los callbacks de componentes de Discord enviados. Predeterminado `1800000` (30 minutos), máximo `86400000` (24 horas). Las sobrescrituras por cuenta están en `channels.discord.accounts..agentComponents.ttlMs`. Prefiere el TTL más corto que encaje con el flujo de trabajo. * `channels.discord.voice` habilita conversaciones en canales de voz de Discord y sobrescrituras opcionales de unión automática + LLM + TTS. Las configuraciones de Discord solo de texto dejan la voz desactivada de forma predeterminada; configura `channels.discord.voice.enabled=true` para activarla. * `channels.discord.voice.model` sobrescribe opcionalmente el modelo LLM usado para respuestas en canales de voz de Discord. * `channels.discord.voice.daveEncryption` (predeterminado `true`) y `channels.discord.voice.decryptionFailureTolerance` (predeterminado `24`) se pasan a las opciones DAVE de `@discordjs/voice`. * `channels.discord.voice.connectTimeoutMs` controla la espera Ready inicial de `@discordjs/voice` para `/vc join` e intentos de unión automática (predeterminado `30000`). * `channels.discord.voice.reconnectGraceMs` controla cuánto tiempo puede tardar una sesión de voz desconectada en entrar en señalización de reconexión antes de que OpenClaw la destruya (predeterminado `15000`). * La reproducción de voz de Discord no se interrumpe por el evento de inicio de habla de otro usuario. Para evitar bucles de retroalimentación, OpenClaw ignora nueva captura de voz mientras se reproduce TTS. * OpenClaw también intenta recuperar la recepción de voz saliendo y volviendo a unirse a una sesión de voz después de fallos de descifrado repetidos. * `channels.discord.streaming` es la clave canónica del modo de transmisión. Discord usa de forma predeterminada `streaming.mode: "progress"`, de modo que el progreso de herramientas/trabajo aparece en un único mensaje de vista previa editado; configura `streaming.mode: "off"` para deshabilitarlo. Los valores heredados `streamMode` y booleanos de `streaming` siguen siendo alias de entorno de ejecución; ejecuta `openclaw doctor --fix` para reescribir la configuración persistida. * `channels.discord.autoPresence` asigna la disponibilidad del entorno de ejecución a la presencia del bot (healthy => online, degraded => idle, exhausted => dnd) y permite sobrescrituras opcionales del texto de estado. * `channels.discord.dangerouslyAllowNameMatching` vuelve a habilitar la coincidencia mutable por nombre/etiqueta (modo de compatibilidad de emergencia). * `channels.discord.execApprovals`: entrega de aprobaciones de ejecución nativa de Discord y autorización de aprobadores. * `enabled`: `true`, `false` o `"auto"` (predeterminado). En modo automático, las aprobaciones de ejecución se activan cuando los aprobadores se pueden resolver desde `approvers` o `commands.ownerAllowFrom`. * `approvers`: ID de usuario de Discord autorizados para aprobar solicitudes de ejecución. Recurre a `commands.ownerAllowFrom` cuando se omite. * `agentFilter`: allowlist opcional de ID de agente. Omítelo para reenviar aprobaciones para todos los agentes. * `sessionFilter`: patrones opcionales de clave de sesión (subcadena o regex). * `target`: dónde enviar las solicitudes de aprobación. `"dm"` (predeterminado) envía a los DM de los aprobadores, `"channel"` envía al canal de origen, `"both"` envía a ambos. Cuando el destino incluye `"channel"`, los botones solo pueden usarlos los aprobadores resueltos. * `cleanupAfterResolve`: cuando es `true`, elimina los DM de aprobación tras aprobación, denegación o timeout. **Modos de notificación de reacción:** `off` (ninguna), `own` (mensajes del bot, predeterminado), `all` (todos los mensajes), `allowlist` (desde `guilds..users` en todos los mensajes). ### Google Chat ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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", dm: { enabled: true, policy: "pairing", allowFrom: ["users/1234567890"], }, groupPolicy: "allowlist", groups: { "spaces/AAAA": { allow: true, requireMention: true }, }, actions: { reactions: true }, typingIndicator: "message", mediaMaxMb: 20, }, }, } ``` * JSON de cuenta de servicio: en línea (`serviceAccount`) o basado en archivo (`serviceAccountFile`). * También se admite SecretRef de cuenta de servicio (`serviceAccountRef`). * Reservas de entorno: `GOOGLE_CHAT_SERVICE_ACCOUNT` o `GOOGLE_CHAT_SERVICE_ACCOUNT_FILE` (solo cuenta predeterminada). * Usa `spaces/` o `users/` para destinos de entrega. * `channels.googlechat.dangerouslyAllowNameMatching` vuelve a habilitar la coincidencia mutable de principales de correo electrónico (modo de compatibilidad de emergencia). ### Slack ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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: { allow: true, requireMention: true, allowBots: false }, "#general": { allow: 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, chunkMode: "length", streaming: { mode: "partial", // off | partial | block | progress 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 }, }, }, } ``` * **Modo Socket** requiere `botToken` y `appToken` (`SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN` para la reserva de entorno de la cuenta predeterminada). * **Modo HTTP** requiere `botToken` más `signingSecret` (en la raíz o por cuenta). * `socketMode` pasa el ajuste del transporte Socket Mode del SDK de Slack a la API pública del receptor Bolt. Úsalo solo al investigar tiempos de espera de ping/pong o comportamiento de websocket obsoleto. `clientPingTimeout` tiene un valor predeterminado de `15000`; `serverPingTimeout` y `pingPongLoggingEnabled` se pasan solo 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/estado por credencial, como `botTokenSource`, `botTokenStatus`, `appTokenStatus` y, en modo HTTP, `signingSecretStatus`. `configured_unavailable` significa que la cuenta está configurada mediante SecretRef, pero la ruta actual de comando/runtime no pudo resolver el valor del secreto. * `configWrites: false` bloquea las escrituras de configuración iniciadas por Slack. * El `channels.slack.defaultAccount` opcional anula la selección de cuenta predeterminada cuando coincide con un id de cuenta configurado. * `channels.slack.streaming.mode` es la clave canónica del modo de stream de Slack (valor predeterminado `"partial"`). `channels.slack.streaming.nativeTransport` controla el transporte de streaming nativo de Slack (valor predeterminado `true`). Los valores heredados `streamMode`, booleano `streaming`, `chunkMode`, `blockStreaming`, `blockStreamingCoalesce` y `nativeStreaming` siguen siendo aliases de runtime; ejecuta `openclaw doctor --fix` para reescribir la configuración persistida a `streaming.{mode,chunkMode,block.enabled,block.coalesce,nativeTransport}`. * `unfurlLinks` y `unfurlMedia` pasan los booleanos de despliegue de enlaces y medios de `chat.postMessage` de Slack para respuestas del bot. `unfurlLinks` tiene el valor predeterminado `false`, de modo que los enlaces salientes del bot no se expanden en línea a menos que se habilite; `unfurlMedia` se omite salvo que esté configurado. Define cualquiera de los dos valores en `channels.slack.accounts.` para anular el valor de nivel superior para una cuenta. * Usa `user:` (DM) o `channel:` para objetivos de entrega. **Modos de notificación de reacción:** `off`, `own` (predeterminado), `all`, `allowlist` (desde `reactionAllowlist`). **Aislamiento de sesiones de hilo:** `thread.historyScope` es por hilo (predeterminado) o compartido en todo el canal. `thread.inheritParent` copia la transcripción del canal padre a hilos nuevos. `thread.initialHistoryLimit` (predeterminado `20`) limita cuántos mensajes de hilo existentes se recuperan cuando comienza una nueva sesión de hilo; `0` deshabilita la recuperación del historial del hilo. * El streaming nativo de Slack más el estado de hilo estilo asistente de Slack "está escribiendo..." requieren un objetivo de hilo de respuesta. Los DM de nivel superior permanecen fuera del hilo de forma predeterminada, por lo que aún pueden transmitir mediante vistas previas de borrador de Slack de publicar y editar, en lugar de mostrar la vista previa de stream/estado nativa con estilo de hilo. * `typingReaction` agrega una reacción temporal al mensaje entrante de Slack mientras se ejecuta una respuesta y luego la elimina al completarse. Usa un shortcode de emoji de Slack como `"hourglass_flowing_sand"`. * `channels.slack.execApprovals`: entrega de cliente de aprobaciones nativa de Slack y autorización de aprobador de exec. Mismo esquema que Discord: `enabled` (`true`/`false`/`"auto"`), `approvers` (ID de usuarios de Slack), `agentFilter`, `sessionFilter` y `target` (`"dm"`, `"channel"` o `"both"`). Las aprobaciones de Plugin pueden usar esta ruta de cliente nativo para solicitudes originadas en Slack cuando los aprobadores del Plugin de Slack se resuelven; la entrega de aprobaciones de Plugin nativa de Slack también se puede habilitar mediante `approvals.plugin` para sesiones originadas en Slack u objetivos de Slack. Las aprobaciones de Plugin usan aprobadores del Plugin de Slack de `allowFrom` y enrutamiento predeterminado, no aprobadores de exec. | Grupo de acciones | Predeterminado | Notas | | ----------------- | -------------- | ------------------------------ | | reactions | habilitado | Reaccionar + listar reacciones | | messages | habilitado | Leer/enviar/editar/eliminar | | pins | habilitado | Fijar/desfijar/listar | | memberInfo | habilitado | Información de miembro | | emojiList | habilitado | Lista de emojis personalizados | ### Mattermost Mattermost se instala como un Plugin separado, igual que Discord, Slack y WhatsApp: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install @openclaw/mattermost ``` Consulta [npmjs.com/package/@openclaw/mattermost](https://www.npmjs.com/package/@openclaw/mattermost) para ver los dist-tags actuales antes de fijar una versión. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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, chunkMode: "length", }, }, } ``` Modos de chat: `oncall` (responde con @-mención, predeterminado), `onmessage` (cada mensaje), `onchar` (mensajes que empiezan 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 al endpoint del Gateway de OpenClaw y ser accesible desde el servidor Mattermost. * Las callbacks slash nativas se autentican con los tokens por comando devueltos por Mattermost durante el registro de comandos slash. Si el registro falla o no se activa ningún comando, OpenClaw rechaza las callbacks con `Unauthorized: invalid command token.` * Para hosts de callback privados/tailnet/internos, Mattermost puede requerir que `ServiceSettings.AllowedUntrustedInternalConnections` incluya el host/dominio de callback. Usa valores de host/dominio, no URL completas. * `channels.mattermost.configWrites`: permite o deniega escrituras de configuración iniciadas por Mattermost. * `channels.mattermost.requireMention`: requiere `@mention` antes de responder en canales. * `channels.mattermost.groups..requireMention`: anulación por canal de la compuerta de menciones (`"*"` para el valor predeterminado). * El `channels.mattermost.defaultAccount` opcional anula la selección de cuenta predeterminada cuando coincide con un id de cuenta configurado. ### Signal ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 reacción:** `off`, `own` (predeterminado), `all`, `allowlist` (desde `reactionAllowlist`). * `channels.signal.account`: fija el arranque del canal a una identidad de cuenta Signal específica. * `channels.signal.configWrites`: permite o deniega escrituras de configuración iniciadas por Signal. * El `channels.signal.defaultAccount` opcional anula la selección de cuenta predeterminada cuando coincide con un id de cuenta configurado. ### iMessage OpenClaw inicia `imsg rpc` (JSON-RPC sobre stdio). No se requiere daemon ni puerto. Esta es la ruta preferida para nuevas configuraciones de iMessage de 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 de runtime compatible en la versión actual de OpenClaw. Migra configuraciones antiguas a `channels.imessage`; usa [Eliminación de BlueBubbles y la ruta de iMessage con imsg](/es/announcements/bluebubbles-imessage) para la versión breve y [Migrar desde BlueBubbles](/es/channels/imessage-from-bluebubbles) para la tabla de traducción completa. Si el Gateway no se está ejecutando en la Mac con sesión iniciada en Messages, mantén `channels.imessage.enabled=true` y define `channels.imessage.cliPath` en un wrapper SSH que ejecute `imsg "$@"` en esa Mac. La ruta local predeterminada de `imsg` es solo para macOS. Antes de confiar en un wrapper SSH para envíos de producción, verifica un `imsg send` saliente mediante ese wrapper exacto. Algunos estados de TCC de macOS asignan Messages Automation a `/usr/libexec/sshd-keygen-wrapper`, lo que puede hacer que las lecturas y pruebas funcionen mientras los envíos fallan con AppleEvents `-1743`; consulta la sección de solución de problemas del wrapper SSH en [iMessage](/es/channels/imessage). ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 `channels.imessage.defaultAccount` opcional anula la selección de cuenta predeterminada cuando coincide con un id de cuenta configurado. * Requiere Full Disk Access a la base de datos de Messages. * Prefiere objetivos `chat_id:`. Usa `imsg chats --limit 20` para listar chats. * `cliPath` puede apuntar a un wrapper SSH; define `remoteHost` (`host` o `user@host`) para recuperar adjuntos mediante SCP. * `attachmentRoots` y `remoteAttachmentRoots` restringen las rutas de adjuntos entrantes (predeterminado: `/Users/*/Library/Messages/Attachments`). * SCP usa verificación estricta de claves de host, así que asegúrate de que la clave de host del relé ya exista en `~/.ssh/known_hosts`. * `channels.imessage.configWrites`: permite o deniega escrituras de configuración iniciadas por iMessage. * `channels.imessage.sendTransport`: transporte de envío RPC de `imsg` preferido para respuestas salientes normales. `auto` (predeterminado) usa el puente IMCore para chats existentes cuando está en ejecución y luego recurre a AppleScript; `bridge` requiere entrega mediante API privada; `applescript` fuerza la ruta pública de automatización de Messages. * `channels.imessage.actions.*`: habilita acciones de API privada que también están controladas por `imsg status` / `openclaw channels status --probe`. * `channels.imessage.includeAttachments` está desactivado de forma predeterminada; defínelo en `true` antes de esperar medios entrantes en turnos de agente. * La recuperación entrante después de un reinicio del puente/gateway es automática (deduplicación por GUID más una barrera de edad para backlog obsoleto). Las configuraciones existentes de `channels.imessage.catchup.enabled: true` todavía se respetan 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"`, configura claves `chat_id` explícitas o una entrada comodín `"*"` para que los mensajes de grupo puedan pasar la compuerta del registro. * Las entradas `bindings[]` de nivel superior con `type: "acp"` pueden vincular conversaciones de iMessage a sesiones ACP persistentes. Usa un identificador normalizado o un objetivo de chat explícito (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`) en `match.peer.id`. Semántica de campos compartidos: [Agentes ACP](/es/tools/acp-agents#persistent-channel-bindings). ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} #!/usr/bin/env bash exec ssh -T gateway-host imsg "$@" ``` ### Matrix Matrix está respaldado por Plugin y se configura en `channels.matrix`. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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: "Ops", 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 con token usa `accessToken`; la autenticación con contraseña usa `userId` + `password`. * `channels.matrix.proxy` enruta el tráfico HTTP de Matrix a través de un proxy HTTP(S) explícito. Las cuentas con nombre pueden anularlo con `channels.matrix.accounts..proxy`. * `channels.matrix.network.dangerouslyAllowPrivateNetwork` permite homeservers privados/internos. `proxy` y esta opción de red son controles independientes. * `channels.matrix.defaultAccount` selecciona la cuenta preferida en configuraciones con varias cuentas. * `channels.matrix.autoJoin` usa `"off"` de forma predeterminada, por lo que las salas a las que se te invita y las invitaciones nuevas estilo MD se ignoran hasta que configures `autoJoin: "allowlist"` con `autoJoinAllowlist` o `autoJoin: "always"`. * `channels.matrix.execApprovals`: entrega de aprobaciones de ejecución nativa de Matrix y autorización de aprobadores. * `enabled`: `true`, `false` o `"auto"` (predeterminado). En modo automático, las aprobaciones de ejecución se activan cuando los aprobadores se pueden resolver desde `approvers` o `commands.ownerAllowFrom`. * `approvers`: IDs de usuario de Matrix (por ejemplo, `@owner:example.org`) autorizados para aprobar solicitudes de ejecución. * `agentFilter`: lista de permitidos opcional de IDs de agente. Omítelo para reenviar aprobaciones de todos los agentes. * `sessionFilter`: patrones opcionales de clave de sesión (subcadena o expresión regular). * `target`: dónde enviar solicitudes de aprobación. `"dm"` (predeterminado), `"channel"` (sala de origen) o `"both"`. * Anulaciones por cuenta: `channels.matrix.accounts..execApprovals`. * `channels.matrix.dm.sessionScope` controla cómo las MD de Matrix se agrupan en sesiones: `per-user` (predeterminado) comparte por par enrutado, mientras que `per-room` aísla cada sala de MD. * Las sondas de estado de Matrix y las búsquedas en el directorio en vivo usan 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](/es/channels/matrix). ### Microsoft Teams Microsoft Teams está respaldado por Plugin y se configura en `channels.msteams`. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { msteams: { enabled: true, configWrites: true, // appId, appPassword, tenantId, webhook, team/channel policies: // see /channels/msteams }, }, } ``` * Rutas de claves principales cubiertas aquí: `channels.msteams`, `channels.msteams.configWrites`. * La configuración completa de Teams (credenciales, webhook, política de MD/grupo, anulaciones por equipo/por canal) está documentada en [Microsoft Teams](/es/channels/msteams). ### IRC IRC está respaldado por Plugin y se configura en `channels.irc`. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 cubiertas aquí: `channels.irc`, `channels.irc.dmPolicy`, `channels.irc.configWrites`, `channels.irc.nickserv.*`. * La opción `channels.irc.defaultAccount` opcional anula la selección de cuenta predeterminada cuando coincide con un id de cuenta configurado. * La configuración completa del canal IRC (host/puerto/TLS/canales/listas de permitidos/activación por mención) está documentada en [IRC](/es/channels/irc). ### Varias cuentas (todos los canales) Ejecuta varias cuentas por canal (cada una con su propio `accountId`): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { telegram: { accounts: { default: { name: "Primary bot", botToken: "123456:ABC...", }, alerts: { name: "Alerts bot", botToken: "987654:XYZ...", }, }, }, }, } ``` * `default` se usa 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 por cuenta. * Usa `bindings[].match.accountId` para enrutar cada cuenta a un agente diferente. * Si agregas una cuenta no predeterminada mediante `openclaw channels add` (o la incorporación de canal) mientras aún tienes una configuración de canal de nivel superior con una sola cuenta, OpenClaw promociona primero los valores de cuenta única de nivel superior con alcance de cuenta al mapa de cuentas del canal para que la cuenta original siga funcionando. La mayoría de los canales los mueven a `channels..accounts.default`; Matrix puede preservar en su lugar un destino con nombre/predeterminado coincidente existente. * Las vinculaciones existentes solo de canal (sin `accountId`) siguen coincidiendo con la cuenta predeterminada; las vinculaciones con alcance de cuenta siguen siendo opcionales. * `openclaw doctor --fix` también repara formas mixtas moviendo valores de cuenta única de nivel superior con alcance de cuenta a la cuenta promocionada elegida para ese canal. La mayoría de los canales usan `accounts.default`; Matrix puede preservar en su lugar un destino con nombre/predeterminado coincidente existente. ### Otros canales de Plugin Muchos canales de Plugin se configuran como `channels.` y están documentados en sus páginas de canal dedicadas (por ejemplo Feishu, LINE, Nextcloud Talk, Nostr, QQ Bot, Synology Chat, Twitch y Zalo). Consulta el índice completo de canales: [Canales](/es/channels). ### Activación por mención en chats grupales Los mensajes de grupo requieren **mención obligatoria** de forma predeterminada (mención de metadatos o patrones regex seguros). Se aplica a chats grupales de WhatsApp, Telegram, Discord, Google Chat e iMessage. Las respuestas visibles se controlan por separado. Las solicitudes directas normales de grupo, canal y WebChat interno usan de forma predeterminada entrega final automática: el texto final del asistente se publica a través de la ruta heredada de respuesta visible. Opta por `messages.visibleReplies: "message_tool"` o `messages.groupChat.visibleReplies: "message_tool"` cuando la salida visible solo deba publicarse después de que el agente llame a `message(action=send)`. Si el modelo devuelve texto final sin llamar a la herramienta de mensajes en un modo solo herramienta activado, ese texto final permanece privado y el registro detallado del gateway registra metadatos de la carga útil suprimida. Las respuestas visibles solo herramienta requieren un modelo/tiempo de ejecución que llame a herramientas de forma fiable, y se recomiendan para salas compartidas de entorno en modelos de última generación como GPT 5.5. Algunos modelos más débiles pueden responder con texto final, pero no entender que la salida visible para el origen debe enviarse con `message(action=send)`. Para esos modelos, usa `"automatic"` para que el turno final del asistente sea la ruta de respuesta visible. Si el registro de sesión muestra texto del asistente con `didSendViaMessagingTool: false`, el modelo produjo texto final privado en lugar de llamar a la herramienta de mensajes. Cambia a un modelo más sólido para llamadas a herramientas en ese canal, inspecciona el registro detallado del Gateway para ver el resumen de la carga útil suprimida o configura `messages.groupChat.visibleReplies: "automatic"` para usar respuestas finales visibles en cada solicitud de grupo/canal. Si la herramienta de mensajes no está disponible bajo la política de herramientas activa, OpenClaw recurre a respuestas visibles automáticas en lugar de suprimir la respuesta silenciosamente. `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 de hilo vinculado reclamados; el Plugin no necesita llamar a `message(action=send)` para esas respuestas de vinculación. **Solución de problemas: la @mención de grupo activa escritura y luego silencio (sin error)** Síntoma: una @mención de grupo/canal muestra el indicador de escritura y el registro del Gateway informa `dispatch complete (queuedFinal=false, replies=0)`, pero no llega ningún mensaje a la sala. Las MD al mismo agente responden normalmente. Causa: el modo de respuesta visible de grupo/canal se resuelve como `"message_tool"`, por lo que OpenClaw ejecuta el turno pero suprime el texto final del asistente salvo que el agente llame a `message(action=send)`. No hay contrato `NO_REPLY` en este modo; si no hay llamada a la herramienta de mensajes, no hay respuesta de origen. No hay error porque la supresión es el comportamiento configurado. Los turnos normales de grupo y canal usan `"automatic"` de forma predeterminada, por lo que este síntoma solo aparece cuando `messages.groupChat.visibleReplies` (o el `messages.visibleReplies` global) se configura explícitamente como `"message_tool"`. El `defaultVisibleReplies` del arnés no se aplica aquí — el resolvedor de grupo/canal lo ignora; solo afecta a chats directos/de origen (el arnés de Codex suprime así los finales de chat directo). Solución: elige un modelo más sólido para llamadas a herramientas, elimina la anulación explícita `"message_tool"` para volver al valor predeterminado `"automatic"`, o configura `messages.groupChat.visibleReplies: "automatic"` para forzar respuestas visibles en cada solicitud de grupo/canal. El Gateway recarga en caliente la configuración de `messages` después de guardar el archivo; reinicia el Gateway solo cuando la observación de archivos o la recarga de configuración esté deshabilitada en el despliegue. **Tipos de mención:** * **Menciones de metadatos**: @menciones nativas de la plataforma. Se ignoran en el modo de chat contigo mismo de WhatsApp. * **Patrones de texto**: patrones regex seguros en `agents.list[].groupChat.mentionPatterns`. Los patrones inválidos y la repetición anidada no segura se ignoran. * La activación por mención solo se aplica cuando la detección es posible (menciones nativas o al menos un patrón). ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { messages: { visibleReplies: "automatic", // force old automatic final replies for direct/source chats groupChat: { historyLimit: 50, unmentionedInbound: "room_event", // always-on unmentioned room chatter becomes quiet context visibleReplies: "message_tool", // opt-in; require message(action=send) for visible room replies }, }, agents: { list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }], }, } ``` `messages.groupChat.historyLimit` establece el valor predeterminado global. Los canales pueden anularlo con `channels..historyLimit` (o por cuenta). Configura `0` para deshabilitarlo. `messages.groupChat.unmentionedInbound: "room_event"` envía los mensajes de grupo/canal no mencionados y siempre activos como contexto silencioso de sala en canales compatibles. Los mensajes mencionados, comandos y mensajes directos siguen siendo solicitudes de usuario. Consulta [Eventos de sala de entorno](/es/channels/ambient-room-events) para ver ejemplos completos de Discord, Slack y Telegram. `messages.visibleReplies` es el valor predeterminado global de eventos de origen; `messages.groupChat.visibleReplies` lo anula para eventos de origen de grupo/canal. Cuando `messages.visibleReplies` no está configurado, los chats directos/de origen usan el valor predeterminado del tiempo de ejecución o arnés seleccionado, pero los turnos directos de WebChat interno usan entrega final automática para paridad de prompts de Pi/Codex. Configura `messages.visibleReplies: "message_tool"` para exigir intencionalmente `message(action=send)` para la salida visible. Las listas de permitidos de canal y la activación por mención siguen decidiendo si se procesa un evento. #### Límites del historial de MD ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { telegram: { dmHistoryLimit: 30, dms: { "123456789": { historyLimit: 50 }, }, }, }, } ``` Resolución: anulación por MD → valor predeterminado del proveedor → sin límite (todo se conserva). Este resolvedor lee `channels..dmHistoryLimit` y `channels..dms..historyLimit` para cualquier canal cuya clave de sesión siga la forma estándar `provider:direct:` (o la forma heredada `provider:dm:`), por lo que funciona tanto con canales incluidos como con canales de Plugin, no solo con una lista fija. #### Modo de chat contigo mismo Incluye tu propio número en `allowFrom` para habilitar el modo de chat contigo mismo (ignora @menciones nativas, solo responde a patrones de texto): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { whatsapp: { allowFrom: ["+15555550123"], groups: { "*": { requireMention: true } }, }, }, agents: { list: [ { id: "main", groupChat: { mentionPatterns: ["reisponde", "@openclaw"] }, }, ], }, } ``` ### Comandos (gestión de comandos de chat) ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { commands: { native: "auto", // register native commands when supported nativeSkills: "auto", // register native skill commands when supported text: true, // parse /commands in chat messages bash: false, // allow ! (alias: /bash) bashForegroundMs: 2000, config: false, // allow /config mcp: false, // allow /mcp plugins: false, // allow /plugins debug: false, // allow /debug restart: true, // allow /restart + gateway restart tool ownerAllowFrom: ["discord:123456789012345678"], ownerDisplay: "raw", // raw | hash ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}", allowFrom: { "*": ["user1"], discord: ["user:123"], }, useAccessGroups: true, }, } ``` * Este bloque configura superficies de comandos. Para el catálogo actual de comandos integrados + incluidos, consulta [Comandos slash](/es/tools/slash-commands). * Esta página es una **referencia de claves de configuración**, no el catálogo completo de comandos. Los comandos propiedad de canales/Plugins, como QQ Bot `/bot-ping` `/bot-help` `/bot-logs`, LINE `/card`, device-pair `/pair`, memoria `/dreaming`, control del teléfono `/phone` y Talk `/voice`, están documentados en sus páginas de canal/Plugin y en [Comandos slash](/es/tools/slash-commands). * Los comandos de texto deben ser mensajes **independientes** con `/` inicial. * `native: "auto"` activa los comandos nativos para Discord/Telegram y deja Slack desactivado. * `nativeSkills: "auto"` activa los comandos nativos de habilidades para Discord/Telegram y deja Slack desactivado. * Anula por canal: `channels.discord.commands.native` (bool o `"auto"`). Para Discord, `false` omite el registro y la limpieza de comandos nativos durante el inicio. * Anula el registro de habilidades nativas por canal con `channels..commands.nativeSkills`. * `channels.telegram.customCommands` agrega entradas adicionales al menú del bot de Telegram. * `bash: true` habilita `! ` para el shell del host. Requiere `tools.elevated.enabled` y que el remitente esté en `tools.elevated.allowFrom.`. * `config: true` habilita `/config` (lee/escribe `openclaw.json`). Para clientes de Gateway `chat.send`, las escrituras persistentes de `/config set|unset` también requieren `operator.admin`; `/config show` de solo lectura sigue disponible para clientes operadores normales con alcance de escritura. * `mcp: true` habilita `/mcp` para la configuración de servidor MCP administrada por OpenClaw en `mcp.servers`. * `plugins: true` habilita `/plugins` para el descubrimiento, instalación y controles de habilitar/deshabilitar Plugins. * `channels..configWrites` controla las mutaciones de configuración por canal (predeterminado: true). * Para canales con varias cuentas, `channels..accounts..configWrites` también controla las escrituras dirigidas a esa cuenta (por ejemplo, `/allowlist --config --account ` o `/config set channels..accounts....`). * `restart: false` deshabilita `/restart` y las acciones de herramienta de reinicio de Gateway. Predeterminado: `true`. * `ownerAllowFrom` es la lista explícita de permitidos del propietario para comandos exclusivos del propietario y acciones de canal restringidas al propietario. Está separada de `allowFrom`. * `ownerDisplay: "hash"` aplica hash a los ids de propietario en el prompt del sistema. Configura `ownerDisplaySecret` para controlar el hash. * `allowFrom` es por proveedor. Cuando se configura, es la **única** fuente de autorización (se ignoran las listas de permitidos/emparejamiento del canal y `useAccessGroups`). * `useAccessGroups: false` permite que los comandos omitan las políticas de grupos de acceso cuando `allowFrom` no está configurado. * Mapa de documentación de comandos: * catálogo integrado + incluido: [Comandos slash](/es/tools/slash-commands) * superficies de comandos específicas del canal: [Canales](/es/channels) * comandos de QQ Bot: [QQ Bot](/es/channels/qqbot) * comandos de emparejamiento: [Emparejamiento](/es/channels/pairing) * comando de tarjeta de LINE: [LINE](/es/channels/line) * Dreaming de memoria: [Dreaming](/es/concepts/dreaming) *** ## Relacionado * [Referencia de configuración](/es/gateway/configuration-reference) — claves de nivel superior * [Configuración — agentes](/es/gateway/config-agents) * [Descripción general de canales](/es/channels)