IRC - OpenClaw

Gunakan IRC saat Anda menginginkan OpenClaw di channel klasik (#room) dan pesan langsung. Instal Plugin IRC resmi, lalu konfigurasikan di bawah channels.irc.

Mulai cepat

Instal Plugin:

openclaw plugins install @openclaw/irc

Aktifkan konfigurasi IRC di ~/.openclaw/openclaw.json.
Tetapkan setidaknya:

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

Utamakan server IRC privat untuk koordinasi bot. Jika Anda sengaja menggunakan jaringan IRC publik, pilihan umum mencakup Libera.Chat, OFTC, dan Snoonet. Hindari channel publik yang mudah ditebak untuk lalu lintas backchannel bot atau swarm.

Mulai/jalankan ulang gateway:

openclaw gateway run

Default keamanan

IRC menggunakan soket TCP/TLS mentah di luar perutean forward proxy yang dikelola operator OpenClaw. Dalam deployment yang mewajibkan semua egress melalui forward proxy tersebut, tetapkan channels.irc.enabled=false kecuali egress IRC langsung disetujui secara eksplisit.
channels.irc.dmPolicy default ke "pairing".
channels.irc.groupPolicy default ke "allowlist".
Dengan groupPolicy="allowlist", tetapkan channels.irc.groups untuk mendefinisikan channel yang diizinkan.
Gunakan TLS (channels.irc.tls=true) kecuali Anda sengaja menerima transport plaintext.

Kontrol akses

Ada dua “gerbang” terpisah untuk channel IRC:

Akses channel (groupPolicy + groups): apakah bot menerima pesan dari sebuah channel sama sekali.
Akses pengirim (groupAllowFrom / per-channel groups["#channel"].allowFrom): siapa yang diizinkan memicu bot di dalam channel tersebut.

Kunci konfigurasi:

Allowlist DM (akses pengirim DM): channels.irc.allowFrom
Allowlist pengirim grup (akses pengirim channel): channels.irc.groupAllowFrom
Kontrol per-channel (aturan channel + pengirim + mention): channels.irc.groups["#channel"]
channels.irc.groupPolicy="open" mengizinkan channel yang tidak dikonfigurasi (tetap dibatasi mention secara default)

Entri allowlist harus menggunakan identitas pengirim yang stabil (nick!user@host). Pencocokan nick saja dapat berubah dan hanya diaktifkan saat channels.irc.dangerouslyAllowNameMatching: true.

Kesalahan umum: `allowFrom` untuk DM, bukan channel

Jika Anda melihat log seperti:

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

…itu berarti pengirim tidak diizinkan untuk pesan grup/channel. Perbaiki dengan salah satu cara berikut:

menetapkan channels.irc.groupAllowFrom (global untuk semua channel), atau
menetapkan allowlist pengirim per-channel: channels.irc.groups["#channel"].allowFrom

Contoh (izinkan siapa pun di #tuirc-dev berbicara dengan bot):

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

Pemicu balasan (mention)

Meskipun sebuah channel diizinkan (melalui groupPolicy + groups) dan pengirim diizinkan, OpenClaw secara default menggunakan pembatasan mention dalam konteks grup. Artinya, Anda mungkin melihat log seperti drop channel … (missing-mention) kecuali pesan menyertakan pola mention yang cocok dengan bot. Agar bot membalas di channel IRC tanpa memerlukan mention, nonaktifkan pembatasan mention untuk channel tersebut:

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

Atau untuk mengizinkan semua channel IRC (tanpa allowlist per-channel) dan tetap membalas tanpa mention:

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

Catatan keamanan (direkomendasikan untuk channel publik)

Jika Anda mengizinkan allowFrom: ["*"] di channel publik, siapa pun dapat memberi prompt kepada bot. Untuk mengurangi risiko, batasi tools untuk channel tersebut.

Tools yang sama untuk semua orang di channel

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

Tools berbeda per pengirim (pemilik mendapatkan kuasa lebih besar)

Gunakan toolsBySender untuk menerapkan kebijakan yang lebih ketat pada "*" dan yang lebih longgar pada nick Anda:

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

Catatan:

Kunci toolsBySender harus menggunakan id: untuk nilai identitas pengirim IRC: id:eigen atau id:eigen!~eigen@174.127.248.171 untuk pencocokan yang lebih kuat.
Kunci lama tanpa prefiks masih diterima dan dicocokkan hanya sebagai id:.
Kebijakan pengirim pertama yang cocok akan berlaku; "*" adalah fallback wildcard.

Untuk selengkapnya tentang akses grup vs pembatasan mention (dan bagaimana keduanya berinteraksi), lihat: /channels/groups.

NickServ

Untuk mengidentifikasi dengan NickServ setelah tersambung:

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

Registrasi satu kali opsional saat tersambung:

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

Nonaktifkan register setelah nick terdaftar untuk menghindari upaya REGISTER berulang.

Variabel lingkungan

Akun default mendukung:

IRC_HOST
IRC_PORT
IRC_TLS
IRC_NICK
IRC_USERNAME
IRC_REALNAME
IRC_PASSWORD
IRC_CHANNELS (dipisahkan koma)
IRC_NICKSERV_PASSWORD
IRC_NICKSERV_REGISTER_EMAIL

IRC_HOST tidak dapat ditetapkan dari .env workspace; lihat File .env workspace.

Pemecahan masalah

Jika bot tersambung tetapi tidak pernah membalas di channel, verifikasi channels.irc.groups dan apakah pembatasan mention menjatuhkan pesan (missing-mention). Jika Anda ingin bot membalas tanpa ping, tetapkan requireMention:false untuk channel tersebut.
Jika login gagal, verifikasi ketersediaan nick dan kata sandi server.
Jika TLS gagal pada jaringan kustom, verifikasi host/port dan penyiapan sertifikat.

Terkait

Ikhtisar Channel — semua channel yang didukung
Pairing — autentikasi DM dan alur pairing
Grup — perilaku chat grup dan pembatasan mention
Perutean Channel — perutean sesi untuk pesan
Keamanan — model akses dan hardening

​Mulai cepat

​Default keamanan

​Kontrol akses

​Kesalahan umum: allowFrom untuk DM, bukan channel

​Pemicu balasan (mention)

​Catatan keamanan (direkomendasikan untuk channel publik)

​Tools yang sama untuk semua orang di channel

​Tools berbeda per pengirim (pemilik mendapatkan kuasa lebih besar)

​NickServ

​Variabel lingkungan

​Pemecahan masalah

​Terkait