IRC

​

البدء السريع

1. ثبّت Plugin:

openclaw plugins install @openclaw/irc

2. عيّن على الأقل المضيف والاسم المستعار والقنوات المطلوب الانضمام إليها في ~/.openclaw/openclaw.json:

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

3. شغّل Gateway أو أعد تشغيله:

openclaw gateway run

​

إعدادات الاتصال

​

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

• يستخدم IRC مقابس TCP/TLS خام خارج توجيه الوكيل الأمامي الذي يديره مشغّل OpenClaw. في عمليات النشر التي تشترط مرور كل حركة الخروج عبر ذلك الوكيل الأمامي، اضبط channels.irc.enabled=false ما لم تُعتمد حركة خروج IRC المباشرة صراحةً.
• تكون القيمة الافتراضية لـ channels.irc.dmPolicy هي "pairing": يحصل مرسلو الرسائل المباشرة غير المعروفين على رمز إقران توافق عليه باستخدام openclaw pairing approve irc <code>.
• تكون القيمة الافتراضية لـ 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"] مع requireMention وallowFrom وenabled وtools وtoolsBySender وskills وsystemPrompt
• يسمح 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: {
        "#openclaw": { allowFrom: ["*"] },
      },
    },
  },
}

​

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

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

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

​

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

​

الأدوات نفسها لجميع الموجودين في القناة

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

​

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

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

• يجب أن تستخدم مفاتيح toolsBySender بادئات صريحة (channel: وid: وe164: وusername: وname:). بالنسبة إلى IRC، استخدم id: مع قيمة هوية المرسل: id:alice أو id:alice!~alice@203.0.113.7 لمطابقة أقوى.
• ما تزال المفاتيح القديمة بلا بادئات مقبولة، وتُطابق بوصفها 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 على شبكة مخصصة، فتحقق من إعدادات المضيف والمنفذ والشهادة.

​

ذو صلة

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