Makale IRC Genel

Hızlı başlangıç​

1. ~/.openclaw/openclaw.json içinde IRC yapılandırmasını etkinleştirin.
2. En az şunları ayarlayın:

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

1. Gateway'i başlatın/yeniden başlatın:

openclaw gateway run

Güvenlik varsayılanları​

• IRC, OpenClaw operatörü tarafından yönetilen ileri proxy yönlendirmesinin dışında ham TCP/TLS soketleri kullanır. Tüm çıkış trafiğinin bu ileri proxy üzerinden geçmesini gerektiren dağıtımlarda, doğrudan IRC çıkışı açıkça onaylanmadıkça channels.irc.enabled=false ayarlayın.
• channels.irc.dmPolicy varsayılan olarak "pairing" değerini kullanır.
• channels.irc.groupPolicy varsayılan olarak "allowlist" değerini kullanır.
• groupPolicy="allowlist" ile izin verilen kanalları tanımlamak için channels.irc.groups ayarlayın.
• Düz metin aktarımı bilerek kabul etmiyorsanız TLS (channels.irc.tls=true) kullanın.

Erişim denetimi​

1. Kanal erişimi (groupPolicy + groups): botun bir kanaldan mesaj kabul edip etmeyeceği.
2. Gönderen erişimi (groupAllowFrom / kanal başına groups["#channel"].allowFrom): o kanal içinde botu kimin tetikleyebileceği.

• DM izin listesi (DM gönderen erişimi): channels.irc.allowFrom
• Grup gönderen izin listesi (kanal gönderen erişimi): channels.irc.groupAllowFrom
• Kanal başına denetimler (kanal + gönderen + bahsetme kuralları): channels.irc.groups["#channel"]
• channels.irc.groupPolicy="open" yapılandırılmamış kanallara izin verir (varsayılan olarak yine de bahsetme kapılıdır)

Yaygın tuzak:​

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

• channels.irc.groupAllowFrom ayarlayarak (tüm kanallar için genel), veya
• kanal başına gönderen izin listeleri ayarlayarak: channels.irc.groups["#channel"].allowFrom

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

Yanıt tetikleme (bahsetmeler)​

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

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

Güvenlik notu (herkese açık kanallar için önerilir)​

Kanaldaki herkes için aynı araçlar​

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

Gönderen başına farklı araçlar (sahip daha fazla yetki alır)​

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

• toolsBySender anahtarları IRC gönderen kimliği değerleri için id: kullanmalıdır: daha güçlü eşleştirme için id:eigen veya id:eigen!~[email protected].
• Eski, öneksiz anahtarlar hâlâ kabul edilir ve yalnızca id: olarak eşleştirilir.
• İlk eşleşen gönderen ilkesi kazanır; "*" joker geri dönüşüdür.

NickServ​

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

{
  channels: {
    irc: {
      nickserv: {
        register: true,
        registerEmail: "[email protected]",
      },
    },
  },
}

Ortam değişkenleri​

• IRC_HOST
• IRC_PORT
• IRC_TLS
• IRC_NICK
• IRC_USERNAME
• IRC_REALNAME
• IRC_PASSWORD
• IRC_CHANNELS (virgülle ayrılmış)
• IRC_NICKSERV_PASSWORD
• IRC_NICKSERV_REGISTER_EMAIL

Sorun giderme​

• Bot bağlanıyor ancak kanallarda hiç yanıt vermiyorsa channels.irc.groups değerini ve bahsetme kapısının mesajları düşürüp düşürmediğini (missing-mention) doğrulayın. Ping'ler olmadan yanıt vermesini istiyorsanız kanal için requireMention:false ayarlayın.
• Oturum açma başarısız olursa nick kullanılabilirliğini ve sunucu parolasını doğrulayın.
• Özel bir ağda TLS başarısız olursa ana makine/bağlantı noktası ve sertifika kurulumunu doğrulayın.