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"],
    },
  },
}

4. ابدأ/أعد تشغيل Gateway:

openclaw gateway run

​

الإعدادات الأمنية الافتراضية

• يستخدم IRC مآخذ TCP/TLS خامًا خارج توجيه وكيل التمرير الأمامي المُدار بواسطة مشغّل OpenClaw. في عمليات النشر التي تتطلب مرور كل الخروج عبر وكيل التمرير الأمامي هذا، اضبط channels.irc.enabled=false ما لم تتم الموافقة صراحةً على خروج IRC المباشر.
• القيمة الافتراضية لـ channels.irc.dmPolicy هي "pairing".
• القيمة الافتراضية لـ channels.irc.groupPolicy هي "allowlist".
• مع groupPolicy="allowlist"، اضبط channels.irc.groups لتعريف القنوات المسموح بها.
• استخدم TLS (channels.irc.tls=true) ما لم تكن تقبل النقل بنص صريح عن قصد.

​

التحكم في الوصول

1. الوصول إلى القناة (groupPolicy + groups): ما إذا كان البوت يقبل الرسائل من قناة أصلًا.
2. وصول المرسل (groupAllowFrom / لكل قناة groups["#channel"].allowFrom): من يُسمح له بتشغيل البوت داخل تلك القناة.

• قائمة السماح للرسائل المباشرة (وصول مرسل الرسائل المباشرة): channels.irc.allowFrom
• قائمة السماح لمرسلي المجموعة (وصول مرسل القناة): channels.irc.groupAllowFrom
• عناصر التحكم لكل قناة (قواعد القناة + المرسل + الإشارة): channels.irc.groups["#channel"]
• يسمح channels.irc.groupPolicy="open" بالقنوات غير المضبوطة (مع استمرار اشتراط الإشارة افتراضيًا)

​

خطأ شائع: allowFrom مخصص للرسائل المباشرة، وليس للقنوات

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

• ضبط channels.irc.groupAllowFrom (عام لكل القنوات)، أو
• ضبط قوائم السماح للمرسلين لكل قناة: channels.irc.groups["#channel"].allowFrom

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

​

تشغيل الردود (الإشارات)

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

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

​

ملاحظة أمنية (موصى بها للقنوات العامة)

​

الأدوات نفسها لكل شخص في القناة

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

​

أدوات مختلفة لكل مرسل (يحصل المالك على صلاحيات أكبر)

{
  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: فقط.
• أول سياسة مرسل مطابقة هي التي تفوز؛ ويمثل "*" خيار الرجوع الشامل.

​

NickServ

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

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

​

متغيرات البيئة

• IRC_HOST
• IRC_PORT
• IRC_TLS
• IRC_NICK
• IRC_USERNAME
• IRC_REALNAME
• IRC_PASSWORD
• IRC_CHANNELS (مفصولة بفواصل)
• IRC_NICKSERV_PASSWORD
• IRC_NICKSERV_REGISTER_EMAIL

​

استكشاف الأخطاء وإصلاحها

• إذا اتصل البوت لكنه لا يرد أبدًا في القنوات، فتحقق من channels.irc.groups وكذلك مما إذا كانت بوابة الإشارة تُسقط الرسائل (missing-mention). إذا كنت تريده أن يرد دون تنبيهات، فاضبط requireMention:false للقناة.
• إذا فشل تسجيل الدخول، فتحقق من توفر الاسم المستعار وكلمة مرور الخادم.
• إذا فشل TLS على شبكة مخصصة، فتحقق من المضيف/المنفذ وإعداد الشهادة.

​

ذو صلة

• نظرة عامة على القنوات — كل القنوات المدعومة
• الاقتران — مصادقة الرسائل المباشرة وتدفق الاقتران
• المجموعات — سلوك دردشة المجموعات وبوابة الإشارة
• توجيه القنوات — توجيه الجلسات للرسائل
• الأمان — نموذج الوصول والتقوية