Configuration — canaux

Clés de configuration propres à chaque canal sous channels.* : accès aux messages privés et aux groupes, configurations multicomptes, filtrage par mention et clés propres à chaque canal pour Slack, Discord, Telegram, WhatsApp, Matrix, iMessage et les autres plugins de canal.

Pour les agents, les outils, l'environnement d'exécution du Gateway et les autres clés de niveau supérieur, consultez la référence de configuration.

Canaux

Chaque canal démarre automatiquement lorsque sa section de configuration existe (sauf si enabled: false). Telegram et iMessage sont inclus dans le paquet principal openclaw. Les autres canaux officiels (Discord, Slack, WhatsApp, Matrix, Microsoft Teams, IRC, Google Chat, Signal, Mattermost, entre autres) s'installent sous forme de plugins distincts avec openclaw plugins install <spec> ; consultez Canaux pour obtenir la liste complète et les spécifications d'installation.

Accès aux messages privés et aux groupes

Tous les canaux prennent en charge des politiques relatives aux messages privés et aux groupes :

Remplacements de modèle par canal

Utilisez channels.modelByChannel pour attribuer un modèle à des identifiants de canal ou à des correspondants de messages privés précis. Les valeurs acceptent le format provider/model ou des alias de modèle configurés. Le mappage de canal ne s'applique que lorsqu'une session ne dispose pas déjà d'un remplacement de modèle actif (par exemple, défini avec /model).

Pour les conversations de groupe ou de fil de discussion, les clés sont des identifiants de groupe, des identifiants de sujet ou des noms de canal propres au canal. Pour les conversations par message privé (DM), les clés sont des identifiants de correspondant dérivés de l'identité de l'expéditeur du canal (nativeDirectUserId, origin.from, origin.to, OriginatingTo, From ou SenderId). La forme exacte de la clé dépend du 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",      },    },  },}

Les clés propres aux messages privés ne correspondent que dans les conversations par message privé ; elles n'affectent pas le routage des groupes ou des fils de discussion.

Valeurs par défaut des canaux et Heartbeat

Utilisez channels.defaults pour partager le comportement de la stratégie de groupe et de Heartbeat entre les fournisseurs :

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

• channels.defaults.groupPolicy : stratégie de groupe de secours lorsqu’un groupPolicy au niveau du fournisseur n’est pas défini.
• channels.defaults.contextVisibility : mode de visibilité par défaut du contexte supplémentaire pour tous les canaux. Valeurs : all (par défaut, inclut tout le contexte des citations, des fils de discussion et de l’historique), allowlist (inclut uniquement le contexte provenant des expéditeurs figurant sur la liste d’autorisation), allowlist_quote (identique à la liste d’autorisation, mais conserve le contexte explicite des citations et des réponses). Remplacement par canal : channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk : inclut les états des canaux sains dans la sortie Heartbeat (valeur par défaut : false).
• channels.defaults.heartbeat.showAlerts : inclut les états dégradés ou en erreur dans la sortie Heartbeat (valeur par défaut : true).
• channels.defaults.heartbeat.useIndicator : affiche la sortie Heartbeat sous forme compacte d’indicateurs (valeur par défaut : true).

WhatsApp

WhatsApp fonctionne via le canal web du Gateway (Baileys Web). Il démarre automatiquement lorsqu’une session associée existe.

{  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 = réessayer indéfiniment    },  },  channels: {    whatsapp: {      dmPolicy: "pairing", // pairing | allowlist | open | disabled      allowFrom: ["+15555550123", "+447700900123"],      textChunkLimit: 4000,      chunkMode: "length", // length | newline      mediaMaxMb: 50,      sendReadReceipts: true, // coches bleues (false en mode de discussion avec soi-même)      groups: {        "*": { requireMention: true },      },      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],    },  },}

• web.whatsapp.keepAliveIntervalMs (valeur par défaut : 25000), connectTimeoutMs (valeur par défaut : 60000) et defaultQueryTimeoutMs (valeur par défaut : 60000) ajustent le socket Baileys.
• Valeurs par défaut de web.reconnect : initialMs: 2000, maxMs: 30000, factor: 1.8, jitter: 0.25, maxAttempts: 12. Avec maxAttempts: 0, les tentatives se poursuivent indéfiniment au lieu d’être abandonnées.
• Les entrées bindings[] de niveau supérieur avec type: "acp" configurent des liaisons ACP persistantes pour les messages privés et les groupes WhatsApp. Utilisez un numéro direct au format E.164 ou un JID de groupe WhatsApp dans match.peer.id. La sémantique des champs est décrite dans Agents 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: "Répondez brièvement.",          topics: {            "99": {              requireMention: false,              skills: ["search"],              systemPrompt: "Restez dans le sujet.",            },          },        },      },      customCommands: [        { command: "backup", description: "Sauvegarde Git" },        { command: "generate", description: "Créer une image" },      ],      historyLimit: 50,      replyToMode: "first", // désactivé | premier | tous | par lots      linkPreview: true,      streaming: "partial", // désactivé | partiel | bloc | progression (par défaut : partiel)      actions: { reactions: true, sendMessage: true },      reactionNotifications: "own", // désactivé | propres | toutes      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",    },  },}

• Jeton du bot : channels.telegram.botToken ou channels.telegram.tokenFile (fichier standard uniquement ; liens symboliques refusés), avec TELEGRAM_BOT_TOKEN comme solution de secours pour le compte par défaut.
• apiRoot désigne uniquement la racine de l’API Bot de Telegram. Utilisez https://api.telegram.org ou la racine de votre instance auto-hébergée/proxy, et non https://api.telegram.org/bot<TOKEN> ; openclaw doctor --fix supprime tout suffixe final /bot<TOKEN> ajouté par erreur.
• Pour un serveur d’API Bot auto-hébergé en mode --local, trustedLocalFileRoots répertorie les chemins de l’hôte qu’OpenClaw peut lire. Montez le volume de données du serveur sur l’hôte OpenClaw et configurez soit sa racine de données, soit le répertoire propre à chaque jeton ; les chemins de conteneur sous /var/lib/telegram-bot-api sont mis en correspondance avec ces racines. Les autres chemins absolus restent refusés.
• Le paramètre facultatif channels.telegram.defaultAccount remplace la sélection du compte par défaut lorsqu’il correspond à un identifiant de compte configuré.
• Dans les configurations multicomptes (2 identifiants de compte ou plus), définissez explicitement un compte par défaut (channels.telegram.defaultAccount ou channels.telegram.accounts.default) afin d’éviter le routage de secours ; openclaw doctor émet un avertissement si cette valeur est absente ou non valide.
• configWrites: false bloque les écritures de configuration lancées depuis Telegram (migrations d’identifiants de supergroupes, /config set|unset).
• Les entrées bindings[] de niveau supérieur avec type: "acp" configurent des liaisons ACP persistantes pour les sujets de forum (utilisez la forme canonique chatId:topic:topicId dans match.peer.id). La sémantique des champs est décrite dans Agents ACP.
• Les aperçus de flux Telegram utilisent sendMessage + editMessageText (fonctionne dans les conversations directes et de groupe).
• network.dnsResultOrder utilise par défaut "ipv4first" afin d’éviter les échecs de récupération courants avec IPv6.
• Politique de nouvelle tentative : consultez Politique de nouvelle tentative.

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,      streaming: {        mode: "progress", // off | partial | block | progress (Discord default: 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,      },    },  },}

• Jeton : channels.discord.token, avec DISCORD_BOT_TOKEN comme solution de secours pour le compte par défaut.
• Les appels sortants directs qui fournissent un token Discord explicite utilisent ce jeton pour l’appel ; les paramètres de nouvelle tentative et de stratégie du compte proviennent toujours du compte sélectionné dans l’instantané d’exécution actif.
• Le paramètre facultatif channels.discord.defaultAccount remplace la sélection du compte par défaut lorsqu’il correspond à l’identifiant d’un compte configuré.
• Utilisez user:<id> (message privé) ou channel:<id> (canal de serveur) comme cibles de livraison ; les identifiants numériques seuls sont refusés.
• Les slugs de serveur sont en minuscules, les espaces étant remplacés par - ; les clés de canal utilisent le nom sous forme de slug (sans #). Privilégiez les identifiants de serveur.
• Les messages rédigés par des bots sont ignorés par défaut. allowBots: true les active ; utilisez allowBots: "mentions" pour accepter uniquement les messages de bots qui mentionnent le bot (ses propres messages restent filtrés).
• Les canaux prenant en charge les messages entrants rédigés par des bots peuvent utiliser la protection partagée contre les boucles de bots. Définissez channels.defaults.botLoopProtection pour les budgets de paires de référence, puis remplacez la valeur au niveau du canal ou du compte uniquement si une surface nécessite des limites différentes.
• channels.discord.guilds.<id>.ignoreOtherMentions (ainsi que les remplacements propres aux canaux) ignore les messages qui mentionnent un autre utilisateur ou rôle, mais pas le bot (à l’exception de @everyone/@here).
• channels.discord.mentionAliases associe un texte @handle sortant stable à des identifiants d’utilisateur Discord avant l’envoi, afin que les coéquipiers connus puissent être mentionnés de manière déterministe même lorsque le cache transitoire du répertoire est vide. Les remplacements propres à chaque compte se trouvent sous channels.discord.accounts.<accountId>.mentionAliases.
• maxLinesPerMessage (valeur par défaut : 17) fractionne les messages longs même s’ils comportent moins de 2000 caractères.
• channels.discord.suppressEmbeds vaut true par défaut, afin que les URL sortantes ne soient pas développées en aperçus de liens Discord, sauf si cette option est désactivée. Les charges utiles embeds explicites sont toujours envoyées normalement ; les appels d’outils propres à un message peuvent remplacer cette valeur avec suppressEmbeds.
• channels.discord.threadBindings contrôle le routage Discord lié aux fils de discussion :
  • enabled : remplacement Discord pour les fonctionnalités de session liées aux fils de discussion (/focus, /unfocus, /agents, /session idle, /session max-age, ainsi que la livraison et le routage liés)
  • idleHours : remplacement Discord du désengagement automatique après inactivité, en heures (0 le désactive)
  • maxAgeHours : remplacement Discord de l’âge maximal strict, en heures (0 le désactive)
  • spawnSessions : commutateur pour sessions_spawn({ thread: true }) et la création/liaison automatique d’un fil lors de la génération d’un fil ACP (valeur par défaut : true)
  • defaultSpawnContext : contexte natif du sous-agent pour les générations liées à un fil ("fork" par défaut)
• Les entrées bindings[] de niveau supérieur avec type: "acp" configurent des liaisons ACP persistantes pour les canaux et les fils de discussion (utilisez l’identifiant du canal ou du fil dans match.peer.id). La sémantique des champs est commune et décrite dans Agents ACP.
• channels.discord.ui.components.accentColor définit la couleur d’accentuation des conteneurs de composants Discord v2.
• channels.discord.agentComponents.ttlMs détermine la durée pendant laquelle les rappels des composants Discord envoyés restent enregistrés. Valeur par défaut : 1800000 (30 minutes) ; maximum : 86400000 (24 heures). Les remplacements propres à chaque compte se trouvent sous channels.discord.accounts.<accountId>.agentComponents.ttlMs. Privilégiez la durée de vie la plus courte compatible avec le workflow.
• channels.discord.voice active les conversations dans les canaux vocaux Discord, ainsi que les remplacements facultatifs pour la connexion automatique, le LLM et la synthèse vocale. Les configurations Discord exclusivement textuelles laissent la voix désactivée par défaut ; définissez channels.discord.voice.enabled=true pour l’activer.
• channels.discord.voice.model remplace facultativement le modèle LLM utilisé pour les réponses dans les canaux vocaux Discord.
• channels.discord.voice.daveEncryption (valeur par défaut : true) et channels.discord.voice.decryptionFailureTolerance (valeur par défaut : 24) sont transmis aux options DAVE de @discordjs/voice.
• channels.discord.voice.connectTimeoutMs contrôle l’attente initiale de l’état Ready de @discordjs/voice pour /vc join et les tentatives de connexion automatique (valeur par défaut : 30000).
• channels.discord.voice.reconnectGraceMs contrôle le délai accordé à une session vocale déconnectée pour entrer dans la signalisation de reconnexion avant qu’OpenClaw ne la détruise (valeur par défaut : 15000).
• La lecture vocale Discord n’est pas interrompue par l’événement de début de prise de parole d’un autre utilisateur. Pour éviter les boucles de rétroaction, OpenClaw ignore toute nouvelle capture vocale pendant la lecture de la synthèse vocale.
• OpenClaw tente également de rétablir la réception vocale en quittant puis en rejoignant à nouveau une session vocale après des échecs répétés de déchiffrement.
• channels.discord.streaming est la clé canonique du mode de diffusion. Discord utilise par défaut streaming.mode: "progress" afin que la progression des outils et du travail apparaisse dans un seul message d’aperçu modifié ; définissez streaming.mode: "off" pour la désactiver. Les anciennes clés de premier niveau (streamMode, chunkMode, blockStreaming, draftChunk, blockStreamingCoalesce) ne sont plus lues à l’exécution ; exécutez openclaw doctor --fix pour migrer la configuration persistante.
• channels.discord.autoPresence associe la disponibilité à l’exécution à la présence du bot (opérationnel => en ligne, dégradé => inactif, épuisé => ne pas déranger) et permet de remplacer facultativement le texte d’état.
• channels.discord.dangerouslyAllowNameMatching réactive la correspondance sur les noms et étiquettes modifiables (mode de compatibilité d’urgence).
• channels.discord.execApprovals : livraison native Discord des approbations d’exécution et autorisation des approbateurs.
  • enabled : true, false ou "auto" (valeur par défaut). En mode automatique, les approbations d’exécution sont activées lorsque les approbateurs peuvent être déterminés à partir de approvers ou de commands.ownerAllowFrom.
  • approvers : identifiants d’utilisateur Discord autorisés à approuver les demandes d’exécution. Utilise commands.ownerAllowFrom comme solution de secours lorsque ce paramètre est omis.
  • agentFilter : liste d’identifiants d’agents autorisés facultative. Omettez-la pour transmettre les approbations de tous les agents.
  • sessionFilter : motifs facultatifs de clés de session (sous-chaîne ou expression régulière).
  • target : emplacement où envoyer les demandes d’approbation. "dm" (valeur par défaut) les envoie dans les messages privés des approbateurs, "channel" les envoie au canal d’origine et "both" les envoie aux deux. Lorsque la cible inclut "channel", seuls les approbateurs déterminés peuvent utiliser les boutons.
  • cleanupAfterResolve : lorsque la valeur est true, supprime les messages privés d’approbation après une approbation, un refus ou une expiration.

Modes de notification des réactions : off (aucune), own (messages du bot, valeur par défaut), all (tous les messages), allowlist (utilisateurs de guilds.<id>.users sur tous les messages).

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 du compte de service : intégré (serviceAccount) ou fourni sous forme de fichier (serviceAccountFile).
• Les SecretRef de compte de service sont également pris en charge (serviceAccountRef).
• Variables d’environnement de secours : GOOGLE_CHAT_SERVICE_ACCOUNT ou GOOGLE_CHAT_SERVICE_ACCOUNT_FILE (compte par défaut uniquement).
• Utilisez spaces/<spaceId> ou users/<userId> comme cibles de livraison.
• channels.googlechat.dangerouslyAllowNameMatching réactive la correspondance sur les identités principales d’adresse e-mail modifiables (mode de compatibilité d’urgence).

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

• Le mode Socket nécessite à la fois botToken et appToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN comme solution de repli sur les variables d’environnement du compte par défaut).
• Le mode HTTP nécessite botToken ainsi que signingSecret (à la racine ou par compte).
• enterpriseOrgInstall: true inscrit un compte au chemin d’événements à l’échelle de l’organisation Slack Enterprise Grid. Au démarrage, le jeton du bot est vérifié avec auth.test et le démarrage échoue lorsque le mode configuré ne correspond pas à l’identité d’installation Slack. Les messages privés d’entreprise doivent être désactivés ou utiliser dmPolicy: "open" avec une valeur effective allowFrom: ["*"]. Les politiques de canaux et d’utilisateurs doivent utiliser des identifiants Slack stables ; les noms modifiables et les préfixes de canaux non pris en charge font échouer le démarrage. La V1 gère uniquement les événements directs message et app_mention du mode Socket ou HTTP avec des réponses immédiates ; le relais, les commandes, les interactions, App Home, les écouteurs d’événements de réaction, les épingles, les outils d’action, les approbations natives, les liaisons, la livraison différée et les envois proactifs ne sont pas disponibles. Les accusés de réception, l’indication de saisie et les réactions de statut gérés par l’écouteur restent disponibles avec reactions:write ; les notifications de réactions entrantes et les outils d’action de réaction ne sont pas disponibles. Consultez Installations Enterprise Grid à l’échelle de l’organisation pour le manifeste de moindre privilège, le processus de configuration et l’ensemble des restrictions.
• socketMode transmet les réglages du transport du mode Socket du SDK Slack à l’API publique du récepteur Bolt. Utilisez-le uniquement pour examiner les délais d’expiration ping/pong ou le comportement d’une websocket obsolète. La valeur par défaut de clientPingTimeout est 15000 ; serverPingTimeout et pingPongLoggingEnabled ne sont transmis que s’ils sont configurés.
• botToken, appToken, signingSecret et userToken acceptent des chaînes en texte brut ou des objets SecretRef.
• Les instantanés de compte Slack exposent des champs de source/état pour chaque identifiant, tels que botTokenSource, botTokenStatus, appTokenStatus et, en mode HTTP, signingSecretStatus. configured_unavailable signifie que le compte est configuré au moyen de SecretRef, mais que la commande ou le chemin d’exécution actuel n’a pas pu résoudre la valeur du secret.
• configWrites: false bloque les écritures de configuration initiées par Slack.
• La valeur facultative channels.slack.defaultAccount remplace la sélection du compte par défaut lorsqu’elle correspond à l’identifiant d’un compte configuré.
• channels.slack.streaming.mode est la clé canonique du mode de diffusion Slack (valeur par défaut "partial"). channels.slack.streaming.nativeTransport contrôle le transport de diffusion natif de Slack (valeur par défaut true). Les anciennes valeurs streamMode, la valeur booléenne streaming, chunkMode, blockStreaming, blockStreamingCoalesce et nativeStreaming ne sont plus lues à l’exécution ; exécutez openclaw doctor --fix pour migrer la configuration persistante vers streaming.{mode,chunkMode,block.enabled,block.coalesce,nativeTransport}.
• unfurlLinks et unfurlMedia transmettent les valeurs booléennes de développement des liens et des médias de chat.postMessage de Slack pour les réponses du bot. La valeur par défaut de unfurlLinks est false, afin que les liens sortants du bot ne soient pas développés dans le message, sauf activation ; unfurlMedia est omis sauf s’il est configuré. Définissez l’une ou l’autre valeur dans channels.slack.accounts.<accountId> pour remplacer la valeur de premier niveau pour un compte.
• Utilisez user:<id> (message privé) ou channel:<id> pour les cibles de livraison.

Modes de notification des réactions : off, own (valeur par défaut), all, allowlist (provenant de reactionAllowlist).

Isolation des sessions de fil de discussion : thread.historyScope est propre à chaque fil de discussion (valeur par défaut) ou partagé à l’échelle du canal. thread.inheritParent copie la transcription du canal parent dans les nouveaux fils de discussion. thread.initialHistoryLimit (valeur par défaut 20) limite le nombre de messages existants du fil récupérés au démarrage d’une nouvelle session de fil ; 0 désactive la récupération de l’historique du fil.

• La diffusion native de Slack et le statut de fil « is typing... » de type assistant Slack nécessitent une cible de réponse dans un fil. Par défaut, les messages privés de premier niveau restent hors fil ; ils peuvent donc toujours être diffusés au moyen des aperçus de brouillon Slack publiés puis modifiés, au lieu d’afficher l’aperçu natif de diffusion/statut propre aux fils.
• typingReaction ajoute une réaction temporaire au message Slack entrant pendant la génération d’une réponse, puis la supprime lorsqu’elle est terminée. Utilisez un code court d’émoji Slack tel que "hourglass_flowing_sand".
• channels.slack.execApprovals : livraison du client d’approbation native de Slack et autorisation des approbateurs d’exécution. Même schéma que Discord : enabled (true/false/"auto"), approvers (identifiants d’utilisateurs Slack), agentFilter, sessionFilter et target ("dm", "channel" ou "both"). Les approbations de Plugin peuvent utiliser ce chemin de client natif pour les requêtes provenant de Slack lorsque les approbateurs du Plugin Slack sont résolus ; la livraison native Slack des approbations de Plugin peut également être activée via approvals.plugin pour les sessions provenant de Slack ou les cibles Slack. Les approbations de Plugin utilisent les approbateurs du Plugin Slack issus de allowFrom et le routage par défaut, et non les approbateurs d’exécution.

Mattermost

Mattermost s’installe comme un Plugin distinct, de la même manière que Discord, Slack et WhatsApp :

openclaw plugins install @openclaw/mattermost

Consultez npmjs.com/package/@openclaw/mattermost pour connaître les dist-tags actuels avant de fixer une version.

{  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, // activation explicite        nativeSkills: true,        callbackPath: "/api/channels/mattermost/command",        // URL explicite facultative pour les déploiements avec proxy inverse/publics        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",      },      textChunkLimit: 4000,      chunkMode: "length",    },  },}

Modes de discussion : oncall (répondre lors d’une @mention, valeur par défaut), onmessage (chaque message), onchar (messages commençant par le préfixe déclencheur).

Lorsque les commandes natives Mattermost sont activées :

• commands.callbackPath doit être un chemin (par exemple /api/channels/mattermost/command), et non une URL complète.
• commands.callbackUrl doit correspondre au point de terminaison du Gateway OpenClaw et être accessible depuis le serveur Mattermost.
• Les rappels de commandes slash natives sont authentifiés avec les jetons propres à chaque commande renvoyés par Mattermost lors de l’enregistrement des commandes slash. Si l’enregistrement échoue ou si aucune commande n’est activée, OpenClaw rejette les rappels avec Unauthorized: invalid command token.
• Pour les hôtes de rappel privés, de tailnet ou internes, Mattermost peut exiger que ServiceSettings.AllowedUntrustedInternalConnections inclue l’hôte ou le domaine de rappel. Utilisez des valeurs d’hôte ou de domaine, et non des URL complètes.
• channels.mattermost.configWrites : autoriser ou refuser les écritures de configuration initiées par Mattermost.
• channels.mattermost.requireMention : exiger une @mention avant de répondre dans les canaux.
• channels.mattermost.groups.<channelId>.requireMention : remplacement par canal de l’exigence de mention ("*" pour la valeur par défaut).
• La valeur facultative channels.mattermost.defaultAccount remplace la sélection du compte par défaut lorsqu’elle correspond à l’identifiant d’un compte configuré.

Signal

{  channels: {    signal: {      enabled: true,      account: "+15555550123", // liaison facultative du compte      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,    },  },}

Modes de notification des réactions : off, own (valeur par défaut), all, allowlist (provenant de reactionAllowlist).

• channels.signal.account : associer le démarrage du canal à l’identité d’un compte Signal spécifique.
• channels.signal.configWrites : autoriser ou refuser les écritures de configuration initiées par Signal.
• La valeur facultative channels.signal.defaultAccount remplace la sélection du compte par défaut lorsqu’elle correspond à l’identifiant d’un compte configuré.

iMessage

OpenClaw lance imsg rpc (JSON-RPC via stdio). Aucun démon ni port n’est requis. Il s’agit du chemin privilégié pour les nouvelles configurations iMessage d’OpenClaw lorsque l’hôte peut accorder les autorisations d’accès à la base de données Messages et d’Automation.

La prise en charge de BlueBubbles a été supprimée. channels.bluebubbles n’est pas une surface de configuration d’exécution prise en charge dans la version actuelle d’OpenClaw. Migrez les anciennes configurations vers channels.imessage ; consultez Suppression de BlueBubbles et chemin iMessage avec imsg pour la version courte et Migration depuis BlueBubbles pour le tableau de correspondance complet.

Si le Gateway ne s’exécute pas sur le Mac connecté à Messages, conservez channels.imessage.enabled=true et définissez channels.imessage.cliPath sur un wrapper SSH qui exécute imsg "$@" sur ce Mac. Le chemin imsg local par défaut est réservé à macOS.

Avant de dépendre d’un wrapper SSH pour les envois en production, vérifiez l’exécution d’un imsg send sortant via ce wrapper précis. Certains états TCC de macOS attribuent l’Automation de Messages à /usr/libexec/sshd-keygen-wrapper, ce qui peut permettre aux lectures et aux sondes de fonctionner alors que les envois échouent avec l’erreur AppleEvents -1743 ; consultez la section de dépannage du wrapper SSH sur 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,      },    },  },}

• L’option channels.imessage.defaultAccount remplace la sélection du compte par défaut lorsqu’elle correspond à l’identifiant d’un compte configuré.
• Nécessite l’accès complet au disque pour la base de données de Messages.
• Privilégiez les cibles chat_id:<id>. Utilisez imsg chats --limit 20 pour répertorier les conversations.
• cliPath peut pointer vers un wrapper SSH ; définissez remoteHost (host ou user@host) pour récupérer les pièces jointes via SCP.
• attachmentRoots et remoteAttachmentRoots limitent les chemins des pièces jointes entrantes (valeur par défaut : /Users/*/Library/Messages/Attachments).
• SCP utilise une vérification stricte de la clé de l’hôte ; assurez-vous donc que la clé de l’hôte relais existe déjà dans ~/.ssh/known_hosts.
• channels.imessage.configWrites : autorise ou refuse les écritures de configuration initiées depuis iMessage.
• channels.imessage.sendTransport : transport d’envoi RPC imsg privilégié pour les réponses sortantes normales. auto (valeur par défaut) utilise le pont IMCore pour les conversations existantes lorsqu’il est en cours d’exécution, puis se rabat sur AppleScript ; bridge exige une livraison par API privée ; applescript impose le chemin d’automatisation public de Messages.
• channels.imessage.actions.* : active les actions de l’API privée, également conditionnées par imsg status / openclaw channels status --probe.
• channels.imessage.includeAttachments est désactivé par défaut ; définissez-le sur true avant de vous attendre à recevoir des médias entrants dans les tours de l’agent.
• La récupération des messages entrants après un redémarrage du pont/Gateway est automatique (déduplication par GUID et limite d’ancienneté du retard accumulé). Les configurations existantes avec channels.imessage.catchup.enabled: true restent prises en charge en tant que profil de compatibilité obsolète ; catchup est désactivé par défaut.
• channels.imessage.groups : registre des groupes et paramètres propres à chaque groupe. Avec groupPolicy: "allowlist", configurez soit des clés chat_id explicites, soit une entrée générique "*" afin que les messages de groupe puissent franchir le contrôle du registre.
• Les entrées bindings[] de niveau supérieur avec type: "acp" peuvent lier des conversations iMessage à des sessions ACP persistantes. Utilisez un identifiant normalisé ou une cible de conversation explicite (chat_id:*, chat_guid:*, chat_identifier:*) dans match.peer.id. Sémantique des champs partagés : Agents ACP.

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

Matrix

Matrix repose sur un Plugin et se configure sous 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: "Ops",          userId: "@ops:example.org",          accessToken: "syt_ops_xxx",        },        alerts: {          userId: "@alerts:example.org",          password: "secret",          proxy: "http://127.0.0.1:7891",        },      },    },  },}

• L’authentification par jeton utilise accessToken ; l’authentification par mot de passe utilise userId + password.
• channels.matrix.proxy achemine le trafic HTTP de Matrix via un proxy HTTP(S) explicite. Les comptes nommés peuvent le remplacer avec channels.matrix.accounts.<id>.proxy.
• channels.matrix.network.dangerouslyAllowPrivateNetwork autorise les serveurs d’accueil privés/internes. proxy et cette autorisation réseau sont des contrôles indépendants.
• channels.matrix.defaultAccount sélectionne le compte privilégié dans les configurations multicomptes.
• channels.matrix.autoJoin vaut "off" par défaut ; les salons auxquels le compte est invité et les nouvelles invitations de type message privé sont donc ignorés jusqu’à ce que vous définissiez autoJoin: "allowlist" avec autoJoinAllowlist, ou autoJoin: "always".
• channels.matrix.execApprovals : envoi natif Matrix des demandes d’approbation d’exécution et autorisation des approbateurs.
  • enabled : true, false ou "auto" (valeur par défaut). En mode automatique, les approbations d’exécution sont activées lorsque les approbateurs peuvent être déterminés à partir de approvers ou commands.ownerAllowFrom.
  • approvers : identifiants d’utilisateurs Matrix (par exemple @owner:example.org) autorisés à approuver les demandes d’exécution.
  • agentFilter : liste facultative des identifiants d’agents autorisés. Omettez-la pour transférer les approbations de tous les agents.
  • sessionFilter : motifs facultatifs de clés de session (sous-chaîne ou expression régulière).
  • target : emplacement auquel envoyer les demandes d’approbation. "dm" (valeur par défaut), "channel" (salon d’origine) ou "both".
  • Remplacements par compte : channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope détermine comment les messages privés Matrix sont regroupés en sessions : per-user (valeur par défaut) partage la session selon le pair de routage, tandis que per-room isole chaque salon de messages privés.
• Les sondes d’état de Matrix et les recherches en direct dans l’annuaire utilisent la même politique de proxy que le trafic d’exécution.
• La configuration complète de Matrix, les règles de ciblage et les exemples de mise en place sont documentés dans Matrix.

Microsoft Teams

Microsoft Teams repose sur un Plugin et se configure sous channels.msteams.

{  channels: {    msteams: {      enabled: true,      configWrites: true,      // appId, appPassword, tenantId, webhook, team/channel policies:      // see /channels/msteams    },  },}

• Principaux chemins de clés abordés ici : channels.msteams, channels.msteams.configWrites.
• La configuration complète de Teams (identifiants, Webhook, politique des messages privés/groupes, remplacements par équipe et par canal) est documentée dans Microsoft Teams.

IRC

IRC repose sur un Plugin et se configure sous 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",      },    },  },}

• Principaux chemins de clés abordés ici : channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• L’option channels.irc.defaultAccount remplace la sélection du compte par défaut lorsqu’elle correspond à l’identifiant d’un compte configuré.
• La configuration complète du canal IRC (hôte/port/TLS/canaux/listes d’autorisation/contrôle des mentions) est documentée dans IRC.

Multicompte (tous les canaux)

Exécutez plusieurs comptes par canal (chacun avec son propre accountId) :

{  channels: {    telegram: {      accounts: {        default: {          name: "Primary bot",          botToken: "123456:ABC...",        },        alerts: {          name: "Alerts bot",          botToken: "987654:XYZ...",        },      },    },  },}

• default est utilisé lorsque accountId est omis (CLI + routage).
• Les jetons d’environnement ne s’appliquent qu’au compte par défaut.
• Les paramètres de base du canal s’appliquent à tous les comptes, sauf s’ils sont remplacés pour un compte donné.
• Utilisez bindings[].match.accountId pour acheminer chaque compte vers un agent différent.
• Si vous ajoutez un compte autre que celui par défaut via openclaw channels add (ou l’intégration guidée d’un canal) alors que vous utilisez encore une configuration de canal monocompte de niveau supérieur, OpenClaw déplace d’abord les valeurs monocomptes de niveau supérieur propres au compte vers la table des comptes du canal afin que le compte d’origine continue de fonctionner. La plupart des canaux les déplacent dans channels.<channel>.accounts.default ; Matrix peut conserver une cible nommée/par défaut existante qui correspond.
• Les liaisons existantes limitées au canal (sans accountId) continuent de correspondre au compte par défaut ; les liaisons propres à un compte restent facultatives.
• openclaw doctor --fix répare également les structures mixtes en déplaçant les valeurs monocomptes de niveau supérieur propres au compte vers le compte promu choisi pour ce canal. La plupart des canaux utilisent accounts.default ; Matrix peut conserver une cible nommée/par défaut existante qui correspond.

Autres canaux de Plugin

De nombreux canaux de Plugin sont configurés sous la forme channels.<id> et documentés dans leurs pages dédiées (par exemple Feishu, LINE, Nextcloud Talk, Nostr, QQ Bot, Synology Chat, Twitch et Zalo). Consultez l’index complet des canaux : Canaux.

Contrôle des mentions dans les conversations de groupe

Par défaut, les messages de groupe exigent une mention (mention dans les métadonnées ou motifs d’expression régulière sûrs). Cela s’applique aux conversations de groupe WhatsApp, Telegram, Discord, Google Chat et iMessage.

Les réponses visibles sont contrôlées séparément. Les requêtes directes normales de groupe, de canal et du WebChat interne utilisent par défaut la livraison automatique de la réponse finale : le texte final de l’assistant est publié via le chemin historique des réponses visibles. Activez messages.visibleReplies: "message_tool" ou messages.groupChat.visibleReplies: "message_tool" lorsque la sortie visible ne doit être publiée qu’après l’appel de message(action=send) par l’agent. Si le modèle renvoie une réponse finale substantielle sans appeler l’outil de messagerie dans un mode activé qui impose l’outil, ce texte final reste privé, le journal détaillé du Gateway enregistre les métadonnées de la charge utile supprimée, et OpenClaw met en file d’attente une unique nouvelle tentative de récupération demandant au modèle de transmettre la même réponse via message(action=send).

Les réponses visibles reposant uniquement sur l’outil nécessitent un modèle/environnement d’exécution qui appelle les outils de manière fiable et sont recommandées pour les salons partagés ambiants avec des modèles de dernière génération tels que GPT-5.6 Sol. Certains modèles moins performants peuvent fournir un texte final, mais ne pas comprendre que la sortie visible par la source doit être envoyée avec message(action=send). Par défaut, OpenClaw récupère le cas courant d’une réponse finale bloquée uniquement lorsque celle-ci est substantielle, que le tour source n’était pas un événement de salon, que la politique d’envoi n’a pas refusé la livraison et qu’aucune réponse à la source n’a déjà été envoyée. La récupération est limitée à une seule nouvelle tentative ; elle empêche la persistance de l’invite synthétique de nouvelle tentative et exclut cette dernière du regroupement de collecte afin qu’elle ne puisse pas fusionner avec des invites en file d’attente sans rapport. Si la nouvelle tentative reste elle aussi bloquée ou ne peut pas être mise en file d’attente, OpenClaw transmet uniquement un diagnostic assaini tel que « J’ai généré une réponse, mais je n’ai pas pu la transmettre à cette conversation. Veuillez réessayer. » Le texte final privé d’origine n’est jamais marqué pour une livraison automatique à la source. Pour les modèles qui bloquent les réponses de manière répétée, utilisez "automatic" afin que le tour final de l’assistant constitue le chemin de réponse visible, passez à un modèle plus performant pour l’appel d’outils, consultez le journal détaillé du Gateway pour obtenir le résumé de la charge utile supprimée, ou définissez messages.groupChat.visibleReplies: "automatic" afin d’utiliser des réponses finales visibles pour chaque requête de groupe/canal.

Si l’outil de messagerie n’est pas disponible selon la politique d’outils active, OpenClaw se rabat sur les réponses visibles automatiques au lieu de supprimer silencieusement la réponse. openclaw doctor signale cette incohérence.

Cette règle s’applique au texte final normal de l’agent. Les liaisons de conversation gérées par un Plugin utilisent la réponse renvoyée par le Plugin propriétaire comme réponse visible pour les tours de fils liés revendiqués ; le Plugin n’a pas besoin d’appeler message(action=send) pour ces réponses de liaison.

Dépannage : une @mention de groupe déclenche l’indicateur de saisie, puis plus rien (aucune erreur)

Symptôme : une @mention dans un groupe/canal affiche l’indicateur de saisie et le journal du Gateway indique dispatch complete (queuedFinal=false, replies=0), mais aucun message n’arrive dans le salon. Les messages privés envoyés au même agent reçoivent une réponse normale.

Cause : le mode de réponse visible du groupe/canal prend la valeur "message_tool" ; OpenClaw exécute donc le tour, mais supprime le texte final de l’assistant sauf si l’agent appelle message(action=send). Il n’existe aucun contrat NO_REPLY dans ce mode ; en l’absence d’appel à l’outil de messagerie, le texte final d’origine reste privé. Pour les tours source substantiels, OpenClaw tente désormais une nouvelle tentative de récupération contrôlée ; les courtes notes, le silence explicite, les événements de salon, les tours dont la politique d’envoi refuse la livraison et les tours déjà livrés ne font pas l’objet d’une nouvelle tentative. Les tours normaux de groupe et de canal utilisent "automatic" par défaut ; ce symptôme n’apparaît donc que lorsque messages.groupChat.visibleReplies (ou le paramètre global messages.visibleReplies) est explicitement défini sur "message_tool". Le paramètre defaultVisibleReplies du harnais ne s’applique pas ici — le résolveur de groupe/canal l’ignore ; il n’affecte que les conversations directes/source (le harnais Codex supprime ainsi les réponses finales des conversations directes).

Correctif : choisissez un modèle plus performant pour les appels d’outils, supprimez la substitution explicite "message_tool" pour revenir à la valeur par défaut "automatic", ou définissez messages.groupChat.visibleReplies: "automatic" afin de forcer les réponses visibles pour chaque requête de groupe/canal. Une réponse finale substantielle restée sans livraison ne devrait plus se terminer par un succès silencieux ; elle devrait soit récupérer au moyen d’une nouvelle tentative unique avec message(action=send), soit afficher le diagnostic assaini d’échec de livraison. Le Gateway recharge à chaud la configuration messages après l’enregistrement du fichier ; ne redémarrez le Gateway que si la surveillance des fichiers ou le rechargement de la configuration est désactivé dans le déploiement.

Types de mentions :

• Mentions dans les métadonnées : @-mentions natives de la plateforme. Ignorées en mode d’auto-conversation WhatsApp.
• Motifs textuels : motifs d’expression régulière sûrs dans agents.list[].groupChat.mentionPatterns. Les motifs non valides et les répétitions imbriquées dangereuses sont ignorés.
• Le filtrage par mention n’est appliqué que lorsque la détection est possible (mentions natives ou au moins un motif).

{  messages: {    visibleReplies: "automatic", // forcer les anciennes réponses finales automatiques pour les conversations directes/sources    groupChat: {      historyLimit: 50,      unmentionedInbound: "room_event", // les échanges sans mention d’un salon toujours actif deviennent un contexte discret      visibleReplies: "message_tool", // activation explicite ; exiger message(action=send) pour les réponses visibles dans le salon    },  },  agents: {    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],  },}

messages.groupChat.historyLimit définit la valeur globale par défaut. Les canaux peuvent la remplacer avec channels.<channel>.historyLimit (ou par compte). Définissez-la sur 0 pour désactiver cette fonctionnalité.

messages.groupChat.unmentionedInbound: "room_event" soumet les messages sans mention des groupes/canaux toujours actifs en tant que contexte discret du salon sur les canaux pris en charge. Les messages avec mention, les commandes et les messages directs restent des requêtes utilisateur. Consultez Événements ambiants des salons pour obtenir des exemples complets concernant Discord, Slack et Telegram.

messages.visibleReplies est la valeur globale par défaut pour les événements sources ; messages.groupChat.visibleReplies la remplace pour les événements sources de groupe/canal. Lorsque messages.visibleReplies n’est pas défini, les conversations directes/sources utilisent la valeur par défaut de l’environnement d’exécution ou du banc d’essai sélectionné, mais les tours directs internes de WebChat utilisent la livraison finale automatique afin de garantir la parité des prompts Pi/Codex. Définissez intentionnellement messages.visibleReplies: "message_tool" pour exiger message(action=send) afin de produire une sortie visible. Les listes d’autorisation des canaux et le filtrage par mention déterminent toujours si un événement est traité.

Limites d’historique des messages directs

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

Résolution : substitution par message direct → valeur par défaut du fournisseur → aucune limite (tout est conservé).

Ce résolveur lit channels.<provider>.dmHistoryLimit et channels.<provider>.dms.<id>.historyLimit pour tout canal dont la clé de session respecte la forme standard provider:direct:<id> (ou la forme héritée provider:dm:<id>). Il fonctionne donc aussi bien pour les canaux intégrés que pour les canaux de Plugin, et pas seulement pour une liste fixe.

Mode d’auto-conversation

Incluez votre propre numéro dans allowFrom pour activer le mode d’auto-conversation (ignore les @-mentions natives et répond uniquement aux motifs textuels) :

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

Commandes (traitement des commandes de conversation)

{  commands: {    native: "auto", // enregistrer les commandes natives lorsqu’elles sont prises en charge    nativeSkills: "auto", // enregistrer les commandes natives de Skills lorsqu’elles sont prises en charge    text: true, // analyser les /commandes dans les messages de conversation    bash: false, // autoriser ! (alias : /bash)    bashForegroundMs: 2000,    config: false, // autoriser /config    mcp: false, // autoriser /mcp    plugins: false, // autoriser /plugins    debug: false, // autoriser /debug    restart: true, // autoriser /restart + l’outil de redémarrage du Gateway    ownerAllowFrom: ["discord:123456789012345678"],    ownerDisplay: "raw", // raw | hash    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",    allowFrom: {      "*": ["user1"],      discord: ["user:123"],    },    useAccessGroups: true,  },}

Pages connexes

• Référence de configuration — clés de premier niveau
• Configuration — agents
• Vue d’ensemble des canaux