IRC

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

البدء السريع

1. فعّل إعدادات IRC في ~/.openclaw/openclaw.json.
2. اضبط على الأقل:

{
  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".
• القيمة الافتراضية لـ 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 على شبكة مخصصة، فتحقق من المضيف/المنفذ وإعداد الشهادة.

​

ذات صلة

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