IRC

Використовуйте IRC, коли потрібен OpenClaw у класичних каналах (#room) і прямих повідомленнях. Установіть офіційний IRC Plugin, а потім налаштуйте його в channels.irc.

Швидкий старт

1. Установіть Plugin:

openclaw plugins install @openclaw/irc

2. Увімкніть конфігурацію IRC у ~/.openclaw/openclaw.json.
3. Задайте щонайменше:

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

Для координації ботів надавайте перевагу приватному IRC-серверу. Якщо ви свідомо використовуєте публічну IRC-мережу, поширені варіанти включають Libera.Chat, OFTC і Snoonet. Уникайте передбачуваних публічних каналів для зворотного службового трафіку ботів або роїв.

4. Запустіть/перезапустіть gateway:

openclaw gateway run

Безпечні типові значення

• IRC використовує сирі TCP/TLS-сокети поза маршрутизацією через керований оператором OpenClaw forward proxy. У розгортаннях, де весь вихідний трафік має проходити через цей forward proxy, задайте channels.irc.enabled=false, якщо прямий вихідний IRC-трафік явно не схвалено.
• Типове значення channels.irc.dmPolicy — "pairing".
• Типове значення channels.irc.groupPolicy — "allowlist".
• З groupPolicy="allowlist" задайте channels.irc.groups, щоб визначити дозволені канали.
• Використовуйте TLS (channels.irc.tls=true), якщо ви свідомо не приймаєте передавання відкритим текстом.

Керування доступом

Для IRC-каналів є два окремі «шлюзи»:

1. Доступ до каналу (groupPolicy + groups): чи бот взагалі приймає повідомлення з каналу.
2. Доступ відправника (groupAllowFrom / поканальне groups["#channel"].allowFrom): кому дозволено запускати бота всередині цього каналу.

Ключі конфігурації:

• Список дозволених для DM (доступ відправника DM): channels.irc.allowFrom
• Список дозволених відправників групи (доступ відправника в каналі): channels.irc.groupAllowFrom
• Поканальні елементи керування (канал + відправник + правила згадок): channels.irc.groups["#channel"]
• channels.irc.groupPolicy="open" дозволяє неналаштовані канали (типово все одно обмежено згадками)

Записи списку дозволених мають використовувати стабільні ідентичності відправників (nick!user@host). Зіставлення лише за nick є змінним і вмикається тільки коли channels.irc.dangerouslyAllowNameMatching: true.

Поширена пастка: allowFrom призначено для DM, а не каналів

Якщо ви бачите журнали на кшталт:

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

...це означає, що відправника не було дозволено для групових/канальних повідомлень. Виправте це одним зі способів:

• задайте channels.irc.groupAllowFrom (глобально для всіх каналів), або
• задайте поканальні списки дозволених відправників: channels.irc.groups["#channel"].allowFrom

Приклад (дозволити будь-кому в #tuirc-dev спілкуватися з ботом):

{  channels: {    irc: {      groupPolicy: "allowlist",      groups: {        "#tuirc-dev": { allowFrom: ["*"] },      },    },  },}

Запуск відповіді (згадки)

Навіть якщо канал дозволено (через groupPolicy + groups) і відправника дозволено, OpenClaw типово застосовує обмеження за згадкою в групових контекстах.

Це означає, що ви можете бачити журнали на кшталт drop channel … (missing-mention), якщо повідомлення не містить шаблон згадки, який відповідає боту.

Щоб бот відповідав в IRC-каналі без потреби в згадці, вимкніть обмеження за згадкою для цього каналу:

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

Або щоб дозволити всі IRC-канали (без поканального списку дозволених) і все одно відповідати без згадок:

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

Примітка з безпеки (рекомендовано для публічних каналів)

Якщо ви дозволяєте allowFrom: ["*"] у публічному каналі, будь-хто може надсилати запити боту. Щоб зменшити ризик, обмежте інструменти для цього каналу.

Однакові інструменти для всіх у каналі

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

Різні інструменти для кожного відправника (власник отримує більше повноважень)

Використовуйте toolsBySender, щоб застосувати суворішу політику до "*" і м’якшу до вашого nick:

{  channels: {    irc: {      groups: {        "#tuirc-dev": {          allowFrom: ["*"],          toolsBySender: {            "*": {              deny: ["group:runtime", "group:fs", "gateway", "nodes", "cron", "browser"],            },            "id:eigen": {              deny: ["gateway", "nodes", "cron"],            },          },        },      },    },  },}

Примітки:

• Ключі toolsBySender мають використовувати id: для значень ідентичності IRC-відправника: id:eigen або id:eigen!~eigen@174.127.248.171 для сильнішого зіставлення.
• Застарілі ключі без префікса все ще приймаються й зіставляються лише як id:.
• Перша політика відправника, що збігається, перемагає; "*" є резервним wildcard.

Докладніше про груповий доступ і обмеження за згадкою (та як вони взаємодіють) див.: /channels/groups.

NickServ

Щоб ідентифікуватися через NickServ після підключення:

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

Необов’язкова одноразова реєстрація під час підключення:

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

Вимкніть register після реєстрації nick, щоб уникнути повторних спроб REGISTER.

Змінні середовища

Типовий обліковий запис підтримує:

• IRC_HOST
• IRC_PORT
• IRC_TLS
• IRC_NICK
• IRC_USERNAME
• IRC_REALNAME
• IRC_PASSWORD
• IRC_CHANNELS (через кому)
• IRC_NICKSERV_PASSWORD
• IRC_NICKSERV_REGISTER_EMAIL

IRC_HOST не можна задавати з workspace .env; див. файли workspace .env.

Усунення несправностей

• Якщо бот підключається, але ніколи не відповідає в каналах, перевірте channels.irc.groups і чи обмеження за згадкою відкидає повідомлення (missing-mention). Якщо ви хочете, щоб він відповідав без пінгів, задайте requireMention:false для каналу.
• Якщо вхід не вдається, перевірте доступність nick і пароль сервера.
• Якщо TLS не працює в користувацькій мережі, перевірте host/port і налаштування сертифіката.

Пов’язане

• Огляд каналів — усі підтримувані канали
• Сполучення — автентифікація DM і потік сполучення
• Групи — поведінка групового чату та обмеження за згадкою
• Маршрутизація каналів — маршрутизація сесій для повідомлень
• Безпека — модель доступу та посилення захисту