مجموعات الوصول

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.

​

مجموعات مرسلي الرسائل الثابتة

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        "*": ["global-owner-id"],
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
        whatsapp: ["+15551234567"],
      },
    },
  },
}

​

الإحالة إلى المجموعات من قوائم السماح

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
      },
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators"],
    },
    telegram: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators"],
    },
  },
}

{
  accessGroups: {
    oncall: {
      type: "message.senders",
      members: {
        whatsapp: ["+15551234567"],
        googlechat: ["users/1234567890"],
      },
    },
  },
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["accessGroup:oncall"],
    },
    googlechat: {
      spaces: {
        "spaces/AAA": {
          users: ["accessGroup:oncall"],
        },
      },
    },
  },
}

{
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators", "discord:123456789012345678"],
    },
  },
}

​

مسارات قنوات الرسائل المدعومة

• قوائم سماح مرسلي الرسائل المباشرة مثل channels.<channel>.allowFrom
• قوائم سماح مرسلي المجموعات مثل channels.<channel>.groupAllowFrom
• قوائم سماح المرسلين لكل غرفة والخاصة بالقناة التي تستخدم قواعد مطابقة المرسلين نفسها
• مسارات تفويض الأوامر التي تعيد استخدام قوائم سماح مرسلي قنوات الرسائل

​

جماهير قنوات Discord

{
  accessGroups: {
    maintainers: {
      type: "discord.channelAudience",
      guildId: "1456350064065904867",
      channelId: "1456744319972282449",
      membership: "canViewChannel",
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:maintainers"],
    },
  },
}

• يحتاج البوت إلى الوصول إلى النقابة والقناة.
• يحتاج البوت إلى Server Members Intent في Discord Developer Portal.
• تفشل مجموعة الوصول بإغلاق الصلاحية عندما يعيد Discord القيمة Missing Access، أو لا يمكن حل المرسل كعضو في النقابة، أو تنتمي القناة إلى نقابة أخرى.

​

ملاحظات الأمان

• مجموعات الوصول هي أسماء بديلة لقوائم السماح، وليست أدوارًا. فهي لا تنشئ مالكين، ولا توافق على طلبات الاقتران، ولا تمنح أذونات الأدوات بمفردها.
• لا تزال dmPolicy: "open" تتطلب "*" في قائمة سماح الرسائل المباشرة الفعالة. الإحالة إلى مجموعة وصول ليست مثل الوصول العام.
• تفشل أسماء المجموعات المفقودة بإغلاق الصلاحية. إذا كان allowFrom يحتوي على accessGroup:operators وكان accessGroups.operators غائبًا، فلن يفوّض ذلك الإدخال أي شخص.
• حافظ على ثبات معرّفات القنوات. فضّل المعرّفات الرقمية/معرّفات المستخدمين على أسماء العرض عندما تدعم القناة كليهما.

​

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

1. تأكد من أن حقل قائمة السماح يحتوي على مرجع accessGroup:<name> الدقيق.
2. تأكد من أن accessGroups.<name>.type صحيح.
3. تأكد من أن معرّف المرسل مدرج تحت مفتاح القناة المطابق، أو تحت "*".
4. تأكد من أن الإدخال يستخدم صيغة قائمة السماح العادية لتلك القناة.
5. بالنسبة إلى جماهير قنوات Discord، تأكد من أن البوت يستطيع رؤية قناة النقابة وأن Server Members Intent مفعّل.