واجهة التحكم

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.

• الافتراضي: http://<host>:18789/
• بادئة اختيارية: عيّن gateway.controlUi.basePath (مثلًا /openclaw)

​

فتح سريع (محلي)

• http://127.0.0.1:18789/ (أو http://localhost:18789/)

• connect.params.auth.token
• connect.params.auth.password
• ترويسات هوية Tailscale Serve عندما تكون gateway.auth.allowTailscale: true
• ترويسات هوية الوكيل الموثوق عندما تكون gateway.auth.mode: "trusted-proxy"

​

إقران الجهاز (الاتصال الأول)

openclaw devices list

openclaw devices approve <requestId>

​

الهوية الشخصية (محلية للمتصفح)

​

نقطة نهاية إعداد وقت التشغيل

​

دعم اللغة

• اللغات المدعومة: en, zh-CN, zh-TW, pt-BR, de, es, ja-JP, ko, fr, ar, it, tr, uk, id, pl, th, vi, nl, fa
• تُحمَّل الترجمات غير الإنجليزية بشكل كسول في المتصفح.
• تُحفَظ اللغة المحددة في تخزين المتصفح ويُعاد استخدامها في الزيارات المستقبلية.
• تعود مفاتيح الترجمة المفقودة إلى الإنجليزية.

​

سمات المظهر

​

ما يمكنها فعله (اليوم)

​

سلوك الدردشة

​

تثبيت PWA والدفع الويب

• OPENCLAW_VAPID_PUBLIC_KEY
• OPENCLAW_VAPID_PRIVATE_KEY
• OPENCLAW_VAPID_SUBJECT (افتراضيا mailto:openclaw@localhost)

• push.web.vapidPublicKey — يجلب مفتاح VAPID العام النشط.
• push.web.subscribe — يسجل endpoint بالإضافة إلى keys.p256dh/keys.auth.
• push.web.unsubscribe — يزيل نقطة نهاية مسجلة.
• push.web.test — يرسل إشعار اختبار إلى اشتراك المستدعي.

​

التضمينات المستضافة

{
  gateway: {
    controlUi: {
      embedSandbox: "scripts",
    },
  },
}

​

عرض رسالة الدردشة

{
  gateway: {
    controlUi: {
      chatMessageMaxWidth: "min(1280px, 82%)",
    },
  },
}

​

وصول Tailnet (موصى به)

openclaw gateway --tailscale serve

openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"

​

HTTP غير آمن

• توافق HTTP غير الآمن المقتصر على localhost مع gateway.controlUi.allowInsecureAuth=true
• مصادقة مشغّل واجهة التحكم الناجحة عبر gateway.auth.mode: "trusted-proxy"
• خيار الطوارئ gateway.controlUi.dangerouslyDisableDeviceAuth=true

• https://<magicdns>/ (Serve)
• http://127.0.0.1:18789/ (على مضيف Gateway)

{
  gateway: {
    controlUi: { allowInsecureAuth: true },
    bind: "tailnet",
    auth: { mode: "token", token: "replace-me" },
  },
}

{
  gateway: {
    controlUi: { dangerouslyDisableDeviceAuth: true },
    bind: "tailnet",
    auth: { mode: "token", token: "replace-me" },
  },
}

​

سياسة أمان المحتوى

• لا تزال الصور الرمزية والصور المقدمة ضمن مسارات نسبية (مثل /avatars/<id>) تظهر، بما في ذلك مسارات الصور الرمزية المصادق عليها التي تجلبها الواجهة وتحولها إلى عناوين URL محلية من نوع blob:.
• لا تزال عناوين URL المضمنة من نوع data:image/... تظهر (مفيدة للحمولات داخل البروتوكول).
• لا تزال عناوين URL المحلية من نوع blob: التي تنشئها واجهة التحكم تظهر.
• تُزال عناوين URL البعيدة للصور الرمزية التي تصدرها بيانات تعريف القناة في مساعدات الصور الرمزية الخاصة بواجهة التحكم وتُستبدل بالشعار/الشارة المدمجة، لذلك لا يمكن لقناة مخترقة أو خبيثة فرض عمليات جلب صور بعيدة عشوائية من متصفح المشغّل.

​

مصادقة مسار الصورة الرمزية

• يعيد GET /avatar/<agentId> صورة الصورة الرمزية للمتصلين المصادق عليهم فقط. يعيد GET /avatar/<agentId>?meta=1 بيانات تعريف الصورة الرمزية وفق القاعدة نفسها.
• تُرفض الطلبات غير المصادق عليها إلى أي من المسارين (بما يطابق مسار وسائط المساعد الشقيق). يمنع ذلك مسار الصورة الرمزية من تسريب هوية الوكيل على المضيفات المحمية بخلاف ذلك.
• تمرر واجهة التحكم نفسها رمز Gateway كترويسة bearer عند جلب الصور الرمزية، وتستخدم عناوين URL مصادقًا عليها من نوع blob بحيث تظل الصورة ظاهرة في لوحات المعلومات.

​

مصادقة مسار وسائط المساعد

• يتطلب GET /__openclaw__/assistant-media?meta=1&source=<path> مصادقة مشغّل واجهة التحكم العادية. يرسل المتصفح رمز Gateway كترويسة bearer عند التحقق من التوفر.
• تتضمن ردود بيانات التعريف الناجحة mediaTicket قصير العمر ومقيّدًا بذلك المسار المصدر المحدد.
• تستخدم عناوين URL للصور والصوت والفيديو والمستندات المعروضة في المتصفح mediaTicket=<ticket> بدلًا من رمز Gateway النشط أو كلمة المرور. تنتهي صلاحية التذكرة بسرعة ولا يمكنها تخويل مصدر مختلف.

​

بناء الواجهة

pnpm ui:build

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

pnpm ui:dev

​

صفحة واجهة التحكم الفارغة

• عطّل الإضافات التي تحقن في كل الصفحات، خاصة الإضافات ذات سكربتات محتوى <all_urls>.
• جرّب نافذة خاصة، أو ملف تعريف متصفح نظيفًا، أو متصفحًا آخر.
• أبقِ Gateway قيد التشغيل وتحقق من عنوان URL نفسه للوحة المعلومات بعد تغيير المتصفح.

​

التصحيح/الاختبار: خادم التطوير + Gateway بعيد

pnpm ui:dev

http://localhost:5173/?gatewayUrl=ws%3A%2F%2F<gateway-host>%3A18789

http://localhost:5173/?gatewayUrl=wss%3A%2F%2F<gateway-host>%3A18789#token=<gateway-token>

{
  gateway: {
    controlUi: {
      allowedOrigins: ["http://localhost:5173"],
    },
  },
}

​

ذات صلة

• لوحة المعلومات — لوحة معلومات Gateway
• فحوصات الصحة — مراقبة صحة Gateway
• TUI — واجهة مستخدم طرفية
• WebChat — واجهة دردشة مستندة إلى المتصفح