IRC

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

Mulai cepat

1. Instal Plugin:

openclaw plugins install @openclaw/irc

2. Tetapkan setidaknya host, nama panggilan, dan saluran yang akan diikuti di ~/.openclaw/openclaw.json:

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

3. Mulai/mulai ulang Gateway:

openclaw gateway run

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

Pengaturan koneksi

Bawaan keamanan

• IRC menggunakan soket TCP/TLS mentah di luar perutean proksi penerusan yang dikelola operator OpenClaw. Dalam penerapan yang mengharuskan semua lalu lintas keluar melalui proksi penerusan tersebut, tetapkan channels.irc.enabled=false kecuali lalu lintas IRC langsung telah disetujui secara eksplisit.
• channels.irc.dmPolicy secara bawaan adalah "pairing": pengirim pesan langsung yang tidak dikenal menerima kode pemasangan yang Anda setujui dengan openclaw pairing approve irc <code>.
• channels.irc.groupPolicy secara bawaan adalah "allowlist".
• Dengan groupPolicy="allowlist", tetapkan channels.irc.groups untuk menentukan saluran yang diizinkan.
• Gunakan TLS (channels.irc.tls=true) kecuali Anda sengaja menerima transmisi teks biasa.

Kontrol akses

Ada dua "gerbang" terpisah untuk saluran IRC:

1. Akses saluran (groupPolicy + groups): apakah bot menerima pesan dari suatu saluran.
2. Akses pengirim (groupAllowFrom / groups["#channel"].allowFrom per saluran): siapa yang diizinkan memicu bot di dalam saluran tersebut.

Kunci konfigurasi:

• Daftar izin pesan langsung (akses pengirim pesan langsung): channels.irc.allowFrom
• Daftar izin pengirim grup (akses pengirim saluran): channels.irc.groupAllowFrom
• Kontrol per saluran (aturan saluran + pengirim + penyebutan): channels.irc.groups["#channel"] dengan requireMention, allowFrom, enabled, tools, toolsBySender, skills, dan systemPrompt
• channels.irc.groupPolicy="open" mengizinkan saluran yang belum dikonfigurasi (secara bawaan tetap memerlukan penyebutan)

Entri daftar izin sebaiknya menggunakan identitas pengirim yang stabil (nick!user@host). Pencocokan nama panggilan saja dapat berubah dan hanya diaktifkan jika channels.irc.dangerouslyAllowNameMatching: true.

Kendala umum: allowFrom untuk pesan langsung, bukan saluran

Jika Anda melihat log seperti:

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

...artinya pengirim tidak diizinkan untuk pesan grup/saluran. Perbaiki dengan salah satu cara berikut:

• menetapkan channels.irc.groupAllowFrom (berlaku global untuk semua saluran), atau
• menetapkan daftar izin pengirim per saluran: channels.irc.groups["#channel"].allowFrom

Contoh (izinkan siapa pun di #openclaw berbicara dengan bot):

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

Pemicu balasan (penyebutan)

Meskipun suatu saluran diizinkan (melalui groupPolicy + groups) dan pengirim diizinkan, secara bawaan OpenClaw menerapkan gerbang penyebutan dalam konteks grup. Bot dianggap disebutkan ketika pesan berisi nama panggilan bot yang terhubung atau cocok dengan pola penyebutan yang Anda konfigurasikan.

Artinya, Anda mungkin melihat log seperti drop channel … (missing-mention) kecuali pesan menyertakan pola penyebutan yang cocok dengan bot.

Agar bot membalas di saluran IRC tanpa memerlukan penyebutan, nonaktifkan gerbang penyebutan untuk saluran tersebut:

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

Atau, untuk mengizinkan semua saluran IRC (tanpa daftar izin per saluran) dan tetap membalas tanpa penyebutan:

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

Catatan keamanan (disarankan untuk saluran publik)

Jika Anda mengizinkan allowFrom: ["*"] di saluran publik, siapa pun dapat memberikan perintah kepada bot. Untuk mengurangi risiko, batasi alat untuk saluran tersebut.

Alat yang sama untuk semua orang di saluran

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

Alat berbeda per pengirim (pemilik mendapat kewenangan lebih besar)

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

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

Catatan:

• Kunci toolsBySender sebaiknya menggunakan prefiks eksplisit (channel:, id:, e164:, username:, name:). Untuk IRC, gunakan id: dengan nilai identitas pengirim: id:alice atau id:alice!~alice@203.0.113.7 untuk pencocokan yang lebih kuat.
• Kunci lama tanpa prefiks masih diterima, hanya dicocokkan sebagai id:, dan menghasilkan peringatan penghentian penggunaan.
• Kebijakan pengirim pertama yang cocok akan digunakan; "*" adalah pengganti umum.

Untuk informasi selengkapnya tentang akses grup dibandingkan dengan gerbang penyebutan (dan cara keduanya berinteraksi), lihat: /channels/groups.

NickServ

Untuk mengidentifikasi diri dengan NickServ setelah terhubung:

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

Identifikasi NickServ dijalankan secara bawaan setiap kali kata sandi ditetapkan (enabled hanya perlu diatur ke false untuk menonaktifkannya). service secara bawaan adalah NickServ; passwordFile merupakan alternatif untuk password sebaris.

Pendaftaran satu kali opsional saat terhubung (register: true memerlukan registerEmail):

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

Nonaktifkan register setelah nama panggilan terdaftar untuk menghindari upaya REGISTER berulang.

Variabel lingkungan

Akun bawaan 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 ruang kerja; lihat Berkas .env ruang kerja.

Pemecahan masalah

• Jika bot terhubung tetapi tidak pernah membalas di saluran, periksa channels.irc.groups dan apakah gerbang penyebutan membuang pesan (missing-mention). Jika Anda ingin bot membalas tanpa panggilan, tetapkan requireMention:false untuk saluran tersebut.
• Jika proses masuk gagal, periksa ketersediaan nama panggilan dan kata sandi server.
• Jika TLS gagal di jaringan khusus, periksa host/port dan penyiapan sertifikat.

Terkait

• Ikhtisar saluran — semua saluran yang didukung
• Pemasangan — autentikasi pesan langsung dan alur pemasangan
• Grup — perilaku obrolan grup dan gerbang penyebutan
• Perutean saluran — perutean sesi untuk pesan
• Keamanan — model akses dan penguatan