IRC

Utilisez IRC lorsque vous souhaitez utiliser OpenClaw dans des canaux classiques (#room) et des messages directs. Installez le plugin IRC officiel, puis configurez-le sous channels.irc.

Démarrage rapide

1. Installez le plugin :

openclaw plugins install @openclaw/irc

2. Définissez au minimum l’hôte, le pseudonyme et les canaux à rejoindre dans ~/.openclaw/openclaw.json :

{  channels: {    irc: {      enabled: true,      host: "irc.example.com",      port: 6697,      tls: true,      nick: "openclaw-bot",      channels: ["#openclaw"],    },  },}

3. Démarrez ou redémarrez le Gateway :

openclaw gateway run

Privilégiez un serveur IRC privé pour la coordination des bots. Si vous utilisez volontairement un réseau IRC public, Libera.Chat, OFTC et Snoonet figurent parmi les choix courants. Évitez les canaux publics prévisibles pour le trafic de communication secondaire des bots ou des essaims.

Paramètres de connexion

Paramètres de sécurité par défaut

• IRC utilise des sockets TCP/TLS brutes en dehors du routage par proxy direct géré par l’opérateur OpenClaw. Pour les déploiements qui exigent que tout le trafic sortant passe par ce proxy direct, définissez channels.irc.enabled=false, sauf si une sortie IRC directe est explicitement approuvée.
• channels.irc.dmPolicy vaut par défaut "pairing" : les expéditeurs inconnus de messages directs reçoivent un code d’association que vous approuvez avec openclaw pairing approve irc <code>.
• channels.irc.groupPolicy vaut par défaut "allowlist".
• Avec groupPolicy="allowlist", définissez channels.irc.groups pour indiquer les canaux autorisés.
• Utilisez TLS (channels.irc.tls=true), sauf si vous acceptez volontairement un transport en clair.

Contrôle d’accès

Il existe deux « barrières » distinctes pour les canaux IRC :

1. Accès au canal (groupPolicy + groups) : détermine si le bot accepte les messages provenant d’un canal.
2. Accès de l’expéditeur (groupAllowFrom / groups["#channel"].allowFrom propre à chaque canal) : détermine qui est autorisé à déclencher le bot dans ce canal.

Clés de configuration :

• Liste d’autorisation des messages directs (accès des expéditeurs de messages directs) : channels.irc.allowFrom
• Liste d’autorisation des expéditeurs de groupe (accès des expéditeurs du canal) : channels.irc.groupAllowFrom
• Contrôles propres à chaque canal (règles de canal, d’expéditeur et de mention) : channels.irc.groups["#channel"] avec requireMention, allowFrom, enabled, tools, toolsBySender, skills et systemPrompt
• channels.irc.groupPolicy="open" autorise les canaux non configurés (les mentions restent obligatoires par défaut)

Les entrées des listes d’autorisation doivent utiliser des identités d’expéditeur stables (nick!user@host). La correspondance basée uniquement sur le pseudonyme est modifiable et n’est activée que lorsque channels.irc.dangerouslyAllowNameMatching: true.

Piège courant : allowFrom concerne les messages directs, pas les canaux

Si vous voyez des journaux tels que :

• irc: drop group sender alice!ident@host (policy=allowlist)

...cela signifie que l’expéditeur n’était pas autorisé pour les messages de groupe/canal. Corrigez ce problème de l’une des manières suivantes :

• définissez channels.irc.groupAllowFrom (globalement pour tous les canaux), ou
• définissez des listes d’autorisation d’expéditeurs propres à chaque canal : channels.irc.groups["#channel"].allowFrom

Exemple (autoriser tous les membres de #openclaw à parler au bot) :

{  channels: {    irc: {      groupPolicy: "allowlist",      groups: {        "#openclaw": { allowFrom: ["*"] },      },    },  },}

Déclenchement des réponses (mentions)

Même si un canal est autorisé (par groupPolicy + groups) et que l’expéditeur l’est également, OpenClaw exige par défaut une mention dans les contextes de groupe. Le bot est considéré comme mentionné lorsque le message contient le pseudonyme du bot connecté ou correspond aux motifs de mention configurés.

Vous pouvez donc voir des journaux tels que drop channel … (missing-mention), sauf si le message contient un motif de mention correspondant au bot.

Pour que le bot réponde dans un canal IRC sans qu’une mention soit nécessaire, désactivez l’exigence de mention pour ce canal :

{  channels: {    irc: {      groupPolicy: "allowlist",      groups: {        "#openclaw": {          requireMention: false,          allowFrom: ["*"],        },      },    },  },}

Ou, pour autoriser tous les canaux IRC (sans liste d’autorisation propre à chaque canal) tout en répondant sans mention :

{  channels: {    irc: {      groupPolicy: "open",      groups: {        "*": { requireMention: false, allowFrom: ["*"] },      },    },  },}

Remarque de sécurité (recommandée pour les canaux publics)

Si vous autorisez allowFrom: ["*"] dans un canal public, n’importe qui peut envoyer une requête au bot. Pour réduire les risques, limitez les outils disponibles dans ce canal.

Mêmes outils pour tous les membres du canal

{  channels: {    irc: {      groups: {        "#openclaw": {          allowFrom: ["*"],          tools: {            deny: ["group:runtime", "group:fs", "gateway", "nodes", "cron", "browser"],          },        },      },    },  },}

Outils différents selon l’expéditeur (le propriétaire dispose de davantage de possibilités)

Utilisez toolsBySender pour appliquer une politique plus stricte à "*" et une politique plus souple à votre pseudonyme :

{  channels: {    irc: {      groups: {        "#openclaw": {          allowFrom: ["*"],          toolsBySender: {            "*": {              deny: ["group:runtime", "group:fs", "gateway", "nodes", "cron", "browser"],            },            "id:alice": {              deny: ["gateway", "nodes", "cron"],            },          },        },      },    },  },}

Remarques :

• Les clés de toolsBySender doivent utiliser des préfixes explicites (channel:, id:, e164:, username:, name:). Pour IRC, utilisez id: avec la valeur d’identité de l’expéditeur : id:alice ou id:alice!~alice@203.0.113.7 pour une correspondance plus stricte.
• Les anciennes clés sans préfixe sont toujours acceptées, correspondent uniquement comme id: et émettent un avertissement d’obsolescence.
• La première politique d’expéditeur correspondante l’emporte ; "*" est la règle générique de repli.

Pour en savoir plus sur l’accès aux groupes, l’exigence de mention et leur interaction, consultez : /channels/groups.

NickServ

Pour vous identifier auprès de NickServ après la connexion :

{  channels: {    irc: {      nickserv: {        enabled: true,        service: "NickServ",        password: "your-nickserv-password",      },    },  },}

L’identification NickServ s’exécute par défaut dès qu’un mot de passe est défini (enabled ne doit être défini sur false que pour la désactiver). service vaut par défaut NickServ ; passwordFile constitue une alternative à un password intégré à la configuration.

Inscription unique facultative lors de la connexion (register: true nécessite registerEmail) :

{  channels: {    irc: {      nickserv: {        register: true,        registerEmail: "bot@example.com",      },    },  },}

Désactivez register après l’enregistrement du pseudonyme afin d’éviter des tentatives répétées de REGISTER.

Variables d’environnement

Le compte par défaut prend en charge :

• IRC_HOST
• IRC_PORT
• IRC_TLS
• IRC_NICK
• IRC_USERNAME
• IRC_REALNAME
• IRC_PASSWORD
• IRC_CHANNELS (séparés par des virgules)
• IRC_NICKSERV_PASSWORD
• IRC_NICKSERV_REGISTER_EMAIL

IRC_HOST ne peut pas être défini depuis un fichier .env d’espace de travail ; consultez Fichiers .env d’espace de travail.

Dépannage

• Si le bot se connecte mais ne répond jamais dans les canaux, vérifiez channels.irc.groups ainsi que si l’exigence de mention rejette les messages (missing-mention). Si vous souhaitez qu’il réponde sans mention, définissez requireMention:false pour le canal.
• Si la connexion échoue, vérifiez la disponibilité du pseudonyme et le mot de passe du serveur.
• Si TLS échoue sur un réseau personnalisé, vérifiez l’hôte, le port et la configuration du certificat.

Pages connexes

• Vue d’ensemble des canaux — tous les canaux pris en charge
• Association — authentification des messages directs et processus d’association
• Groupes — comportement des discussions de groupe et exigence de mention
• Routage des canaux — routage des sessions pour les messages
• Sécurité — modèle d’accès et durcissement