الانتقال إلى المحتوى الرئيسي

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.

لوحة معلومات Gateway هي واجهة التحكم في المتصفح التي تُقدَّم افتراضيًا على / (يمكن تجاوز ذلك باستخدام gateway.controlUi.basePath). فتح سريع (Gateway المحلي): مراجع رئيسية: يُفرض التحقق من الهوية عند مصافحة WebSocket عبر مسار مصادقة Gateway المكوَّن:
  • connect.params.auth.token
  • connect.params.auth.password
  • ترويسات هوية Tailscale Serve عند gateway.auth.allowTailscale: true
  • ترويسات هوية الوكيل الموثوق عند gateway.auth.mode: "trusted-proxy"
راجع gateway.auth في تكوين Gateway. ملاحظة أمان: واجهة التحكم هي سطح إدارة (دردشة، تكوين، موافقات التنفيذ). لا تعرضها للعامة. تحتفظ الواجهة برموز URL للوحة المعلومات في sessionStorage لجلسة تبويب المتصفح الحالية وعنوان Gateway المحدد، وتزيلها من URL بعد التحميل. فضّل localhost أو Tailscale Serve أو نفق SSH.

​
المسار السريع (موصى به)

  • بعد الإعداد الأولي، يفتح CLI لوحة المعلومات تلقائيًا ويطبع رابطًا نظيفًا (بلا رمز).
  • أعد الفتح في أي وقت: openclaw dashboard (ينسخ الرابط، ويفتح المتصفح إن أمكن، ويعرض تلميح SSH إذا كان بلا واجهة).
  • إذا فشل التسليم عبر الحافظة والمتصفح، يظل openclaw dashboard يطبع URL النظيف ويخبرك باستخدام الرمز من OPENCLAW_GATEWAY_TOKEN أو gateway.auth.token كمفتاح جزء URL باسم token؛ ولا يطبع قيم الرموز في السجلات.
  • إذا طالبتك الواجهة بمصادقة السر المشترك، فالصق الرمز أو كلمة المرور المكوَّنة في إعدادات واجهة التحكم.

​
أساسيات المصادقة (محلي مقابل بعيد)

  • Localhost: افتح http://127.0.0.1:18789/.
  • TLS لـ Gateway: عند gateway.tls.enabled: true، تستخدم روابط لوحة المعلومات/الحالة https:// وتستخدم روابط WebSocket في واجهة التحكم wss://.
  • مصدر رمز السر المشترك: gateway.auth.token (أو OPENCLAW_GATEWAY_TOKEN)؛ يمكن لـ openclaw dashboard تمريره عبر جزء URL للإقلاع الأولي لمرة واحدة، وتحتفظ به واجهة التحكم في sessionStorage لجلسة تبويب المتصفح الحالية وعنوان Gateway المحدد بدلًا من localStorage.
  • إذا كان gateway.auth.token مُدارًا بواسطة SecretRef، فإن openclaw dashboard يطبع/ينسخ/يفتح URL بلا رمز حسب التصميم. يتجنب ذلك كشف الرموز المُدارة خارجيًا في سجلات الطرفية أو سجل الحافظة أو وسائط تشغيل المتصفح.
  • إذا كان gateway.auth.token مكوَّنًا كـ SecretRef وغير محلول في الصدفة الحالية لديك، يظل openclaw dashboard يطبع URL بلا رمز مع إرشادات قابلة للتنفيذ لإعداد المصادقة.
  • كلمة مرور السر المشترك: استخدم gateway.auth.password المكوَّنة (أو OPENCLAW_GATEWAY_PASSWORD). لا تحتفظ لوحة المعلومات بكلمات المرور عبر عمليات إعادة التحميل.
  • الأوضاع الحاملة للهوية: يمكن لـ Tailscale Serve تلبية مصادقة واجهة التحكم/WebSocket عبر ترويسات الهوية عند gateway.auth.allowTailscale: true، ويمكن لوكيل عكسي غير loopback ومدرك للهوية تلبية gateway.auth.mode: "trusted-proxy". في هذه الأوضاع لا تحتاج لوحة المعلومات إلى لصق سر مشترك من أجل WebSocket.
  • ليس localhost: استخدم Tailscale Serve، أو ربط سر مشترك غير loopback، أو وكيلًا عكسيًا غير loopback ومدركًا للهوية مع gateway.auth.mode: "trusted-proxy"، أو نفق SSH. تظل واجهات HTTP البرمجية تستخدم مصادقة السر المشترك ما لم تُشغّل عمدًا gateway.auth.mode: "none" للدخول الخاص أو مصادقة HTTP عبر الوكيل الموثوق. راجع أسطح الويب.

​
إذا رأيت “unauthorized” / 1008

  • تأكد من إمكانية الوصول إلى Gateway (محليًا: openclaw status؛ وعن بُعد: نفق SSH ssh -N -L 18789:127.0.0.1:18789 user@host ثم افتح http://127.0.0.1:18789/).
  • بالنسبة إلى AUTH_TOKEN_MISMATCH، قد تجري العملاء إعادة محاولة موثوقة واحدة باستخدام رمز جهاز مخبأ عندما يعيد Gateway تلميحات إعادة المحاولة. تعيد إعادة المحاولة بالرمز المخبأ استخدام النطاقات المعتمدة المخبأة لذلك الرمز؛ أما المستدعون الذين يمررون deviceToken صريحًا / scopes صريحة فيحتفظون بمجموعة النطاقات المطلوبة لديهم. إذا استمرت المصادقة في الفشل بعد إعادة المحاولة تلك، فحلّ انحراف الرمز يدويًا.
  • بالنسبة إلى AUTH_SCOPE_MISMATCH، تم التعرف على رمز الجهاز لكنه لا يحمل النطاقات التي تطلبها لوحة المعلومات؛ أعد الإقران أو وافق على عقد النطاق المطلوب بدلًا من تدوير رمز Gateway المشترك.
  • خارج مسار إعادة المحاولة ذلك، تكون أولوية مصادقة الاتصال هي الرمز/كلمة المرور المشتركة الصريحة أولًا، ثم deviceToken الصريح، ثم رمز الجهاز المخزن، ثم رمز الإقلاع الأولي.
  • في مسار واجهة تحكم Tailscale Serve غير المتزامن، تُسلسل المحاولات الفاشلة لنفس {scope, ip} قبل أن يسجلها محدد المصادقة الفاشلة، لذلك قد تُظهر إعادة المحاولة السيئة المتزامنة الثانية بالفعل retry later.
  • لخطوات إصلاح انحراف الرمز، اتبع قائمة تحقق استرداد انحراف الرمز.
  • استرجع السر المشترك أو قدّمه من مضيف Gateway:
    • الرمز: openclaw config get gateway.auth.token
    • كلمة المرور: حلّ gateway.auth.password المكوَّنة أو OPENCLAW_GATEWAY_PASSWORD
    • رمز مُدار بواسطة SecretRef: حلّ مزود الأسرار الخارجي أو صدّر OPENCLAW_GATEWAY_TOKEN في هذه الصدفة، ثم أعد تشغيل openclaw dashboard
    • لا يوجد سر مشترك مكوَّن: openclaw doctor --generate-gateway-token
  • في إعدادات لوحة المعلومات، الصق الرمز أو كلمة المرور في حقل المصادقة، ثم اتصل.
  • منتقي لغة الواجهة موجود في نظرة عامة -> وصول Gateway -> اللغة. وهو جزء من بطاقة الوصول، وليس قسم المظهر.

​
ذات صلة