IRC

استخدم IRC عندما تريد تشغيل OpenClaw في القنوات التقليدية (#room) والرسائل المباشرة. ثبّت Plugin الرسمي لـ IRC، ثم اضبطه ضمن channels.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 خاص لتنسيق عمل الروبوتات. إذا كنت تستخدم شبكة IRC عامة عن قصد، فمن الخيارات الشائعة Libera.Chat وOFTC وSnoonet. تجنّب القنوات العامة التي يسهل توقّعها لحركة اتصالات القناة الخلفية للروبوتات أو الأسراب.

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

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

• يستخدم 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) ما لم تكن تقبل النقل بنص صريح عن قصد.

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

توجد «بوابتان» منفصلتان لقنوات IRC:

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" بالقنوات غير المضبوطة (مع استمرار اشتراط الإشارة افتراضيًا)

يجب أن تستخدم إدخالات قائمة السماح هويات مرسل ثابتة (nick!user@host). يمكن تغيير المطابقة بالاسم المستعار وحده، ولا تُفعّل إلا عندما تكون channels.irc.dangerouslyAllowNameMatching: true.

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

إذا رأيت سجلات مثل:

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

...فهذا يعني أن المرسل لم يكن مسموحًا له بإرسال رسائل المجموعة/القناة. أصلح ذلك بإحدى الطريقتين:

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

مثال (السماح لأي شخص في #openclaw بالتحدث إلى الروبوت):

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

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

حتى إذا كانت القناة مسموحًا بها (عبر groupPolicy + groups) وكان المرسل مسموحًا له، يشترط OpenClaw افتراضيًا الإشارة في سياقات المجموعات. يُعدّ الروبوت مُشارًا إليه عندما تحتوي الرسالة على الاسم المستعار المتصل للروبوت أو تطابق أنماط الإشارة المضبوطة لديك.

يعني ذلك أنك قد ترى سجلات مثل drop channel … (missing-mention) ما لم تتضمن الرسالة نمط إشارة يطابق الروبوت.

لجعل الروبوت يرد في قناة IRC من دون الحاجة إلى إشارة، عطّل اشتراط الإشارة لتلك القناة:

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

أو للسماح بجميع قنوات IRC (من دون قائمة سماح لكل قناة) مع الاستمرار في الرد من دون إشارات:

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

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

إذا سمحت بـ allowFrom: ["*"] في قناة عامة، فيمكن لأي شخص توجيه مطالبات إلى الروبوت. لتقليل المخاطر، قيّد الأدوات لتلك القناة.

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

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

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

استخدم toolsBySender لتطبيق سياسة أكثر صرامة على "*" وسياسة أكثر تساهلًا على اسمك المستعار:

{  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: فقط، وتصدر تحذير إيقاف تدريجي.
• تسود أول سياسة مرسل مطابقة؛ وتكون "*" هي الخيار الاحتياطي لحرف البدل.

لمزيد من المعلومات حول الوصول إلى المجموعات مقارنةً باشتراط الإشارة (وكيفية تفاعلهما)، راجع: /channels/groups.

NickServ

للتعريف لدى NickServ بعد الاتصال:

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

يُنفّذ تعريف NickServ افتراضيًا كلما عُيّنت كلمة مرور (لا يلزم ضبط enabled على false إلا لإلغاء الاشتراك). تكون القيمة الافتراضية لـ service هي NickServ؛ ويُعد passwordFile بديلًا عن password المضمّنة.

تسجيل اختياري لمرة واحدة عند الاتصال (يتطلب register: true وجود registerEmail):

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

عطّل register بعد تسجيل الاسم المستعار لتجنب محاولات REGISTER المتكررة.

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

يدعم الحساب الافتراضي:

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

لا يمكن ضبط IRC_HOST من ملف .env لمساحة عمل؛ راجع ملفات .env لمساحة العمل.

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

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

ذو صلة

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