Configuración — canales

​

Canales

​

Acceso a DM y grupos

​

Anulaciones de modelo por canal

{
  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",
      },
    },
  },
}

​

Valores predeterminados de canal y Heartbeat

{
  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.<channel>.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

{
  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.

{
  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: "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<TOKEN>; openclaw doctor --fix elimina un sufijo accidental final /bot<TOKEN>.
• 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.
• 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.

​

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: "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:<id> (DM) o channel:<id> (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 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.<id>.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.<accountId>.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.
• 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.<accountId>.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.

​

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",
      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/<spaceId> o users/<userId> 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

{
  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.<accountId> para anular el valor de nivel superior para una cuenta.
• Usa user:<id> (DM) o channel:<id> para objetivos de entrega.

• 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.

​

Mattermost

openclaw plugins install @openclaw/mattermost

{
  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",
    },
  },
}

• 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.<channelId>.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

{
  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,
    },
  },
}

• 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

{
  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:<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.

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

​

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: "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.<id>.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.<id>.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.

​

Microsoft Teams

{
  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.

​

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 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.

​

Varias cuentas (todos los canales)

{
  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.<channel>.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

​

Activación por mención en chats grupales

• 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).

{
  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"] } }],
  },
}

​

Límites del historial de MD

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

​

Modo de chat contigo mismo

{
  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", // 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,
  },
}

​

Relacionado

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