دليل تشغيل إتاحة Gateway

​

اختر نمط الكشف

​

جرد ما قبل التشغيل

• مضيف Gateway، ومستخدم نظام التشغيل، ودليل الحالة (الافتراضي ~/.openclaw).
• عنوان URL الخاص بـ Gateway ووضع الربط (gateway.bind؛ المنفذ الافتراضي 18789).
• وضع المصادقة، أو مصدر الرمز المميز/كلمة المرور، أو مصدر هوية الوكيل الموثوق.
• كل قناة مفعّلة وما إذا كانت تقبل الرسائل المباشرة أو المجموعات أو Webhook.
• الوكلاء الذين يمكن للمرسلين غير المحليين الوصول إليهم.
• ملف تعريف الأدوات، ووضع العزل، وسياسة الأدوات ذات الصلاحيات المرتفعة لكل وكيل يمكن الوصول إليه.
• بيانات الاعتماد الخارجية المتاحة لهؤلاء الوكلاء.
• موقع النسخة الاحتياطية من ~/.openclaw/openclaw.json وبيانات الاعتماد.

​

فحوصات خط الأساس

openclaw doctor
openclaw security audit
openclaw security audit --deep
openclaw health

openclaw gateway probe --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

​

الحد الأدنى الآمن لخط الأساس

{
  gateway: {
    bind: "loopback",
    auth: {
      mode: "token",
      token: "replace-with-a-long-random-token",
    },
  },
  session: {
    dmScope: "per-channel-peer",
  },
  agents: {
    defaults: {
      sandbox: { mode: "non-main" },
    },
  },
  tools: {
    profile: "messaging",
    exec: { security: "deny", ask: "always" },
    elevated: { enabled: false },
  },
}

​

كشف الرسائل المباشرة والمجموعات

• فضّل dmPolicy: "pairing" أو قائمة allowFrom صارمة على dmPolicy: "open".
• لا تجمع قوائم السماح "*" مع وصول واسع إلى الأدوات.
• اشترط الإشارات في المجموعات ما لم تكن الغرفة خاضعة لرقابة محكمة.
• اضبط session.dmScope: "per-channel-peer" (أو "per-account-channel-peer" للقنوات متعددة الحسابات) عندما يمكن لعدة أشخاص إرسال رسائل مباشرة إلى الروبوت، كي لا تشترك جلسات الرسائل المباشرة في السياق.
• وجّه القنوات المشتركة إلى وكلاء يملكون الحد الأدنى من الأدوات ولا يملكون بيانات اعتماد شخصية.

​

فحوصات الوكيل العكسي

• يجب أن يصادق الوكيل المستخدمين قبل إعادة التوجيه إلى Gateway.
• يجب أن يحظر جدار الحماية أو نهج الشبكة الوصول المباشر إلى منفذ Gateway.
• يجب ألا تتضمن gateway.trustedProxies سوى عناوين IP المصدرية للوكيل.
• يجب أن يزيل الوكيل ترويسات الهوية وإعادة التوجيه المقدمة من العميل أو يستبدلها.
• اضبط gateway.auth.trustedProxy.allowUsers عندما يخدم الوكيل أكثر من فئة واحدة من المستخدمين.
• لا تستخدم gateway.auth.trustedProxy.allowLoopback إلا لوكيل على المضيف نفسه عندما تكون العمليات المحلية موثوقة ويكون الوكيل مالكًا لترويسات الهوية.

​

مراجعة الأدوات والعزل

• تأكد من الجلسات التي تعمل على المضيف وتلك التي تعمل ضمن العزل.
• ارفض التنفيذ على المضيف أو اشترط الموافقة عليه.
• أبقِ الأدوات ذات الصلاحيات المرتفعة معطلة ما لم يحتج إليها مرسل موثوق ومحدد.
• تجنّب أدوات المتصفح واللوحة وNode وCron وGateway وإنشاء الجلسات لأسطح المراسلة المفتوحة أو شبه المفتوحة.
• أبقِ نقاط الربط ضيقة؛ وتجنّب مسارات بيانات الاعتماد والدليل الرئيسي ومقبس Docker والنظام.
• استخدم بوابات أو مستخدمي نظام تشغيل أو مضيفين منفصلين لحدود الثقة المختلفة اختلافًا جوهريًا.

​

التحقق بعد التغيير

1. أعِد تشغيل openclaw security audit --deep.
2. تأكد من نجاح اتصال مصرح له.
3. تأكد من رفض مرسل غير مصرح له أو جلسة متصفح غير مصرح لها.
4. تأكد من أن السجلات تحجب الأسرار.
5. تأكد من أن توجيه الرسائل المباشرة/المجموعات يصل إلى الوكيل المقصود فقط.
6. تأكد من أن الأدوات عالية التأثير تطلب الموافقة أو تُرفض.
7. وثّق التحذيرات المتبقية المقبولة.

​

خطة التراجع

{
  gateway: {
    bind: "loopback",
  },
  channels: {
    whatsapp: { dmPolicy: "disabled" },
    telegram: { dmPolicy: "disabled" },
    discord: { dmPolicy: "disabled" },
    slack: { dmPolicy: "disabled" },
  },
  tools: {
    exec: { security: "deny", ask: "always" },
    elevated: { enabled: false },
  },
}

1. أوقف إعادة التوجيه العامة أو Tailscale Funnel أو مسارات الوكيل العكسي.
2. بدّل رموز Gateway المميزة/كلمات المرور وبيانات اعتماد عمليات التكامل المتأثرة.
3. أزل "*" والمرسلين غير المتوقعين من قوائم السماح.
4. راجع سجلات التدقيق الحديثة، وسجل التشغيل، واستدعاءات الأدوات، وتغييرات الإعداد.
5. أعِد تشغيل openclaw security audit --deep.
6. أعِد تمكين الوصول بأضيق نمط يلبّي سير العمل.

​

قائمة التحقق للمراجعة

• يظل Gateway مقتصرًا على local loopback ما لم يوجد سبب موثّق.
• يتمتع الوصول من خارج local loopback بالمصادقة وجدار الحماية، ولا يملك مسارًا عامًا مباشرًا.
• تملك عمليات نشر الوكيل الموثوق عناوين IP صارمة للوكيل وضوابط للترويسات.
• تستخدم الرسائل المباشرة الاقتران أو قوائم السماح، وليس الوصول المفتوح افتراضيًا.
• تتطلب المجموعات إشارات أو قوائم سماح صريحة.
• لا تصل القنوات المشتركة إلى بيانات الاعتماد الشخصية.
• تعمل الجلسات غير الرئيسية في وضع العزل.
• يُرفض التنفيذ على المضيف والأدوات ذات الصلاحيات المرتفعة أو تخضع لبوابة موافقة.
• تحجب السجلات الأسرار.
• تمت معالجة نتائج التدقيق الحرجة.
• تم اختبار خطوات التراجع وتوثيقها.