​

واجهة التحكّم (المتصفح)

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

​

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

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

• connect.params.auth.token
• connect.params.auth.password تتيح لوحة إعدادات لوحة التحكّم تخزين رمز مميّز؛ ولا يتم حفظ كلمات المرور. يقوم معالج التهيئة الأولية بإنشاء رمز Gateway افتراضيًا، لذا الصقه هنا عند الاتصال الأول.

​

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

# List pending requests
openclaw devices list

# Approve by request ID
openclaw devices approve <requestId>

• الاتصالات المحلية (127.0.0.1) تتم الموافقة عليها تلقائيًا.
• الاتصالات عن بعد (الشبكة المحلية، تايلنيت، إلخ) يتطلب موافقة صريحة.
• يقوم كل ملف تعريف متصفح بإنشاء معرّف جهاز فريد، لذا فإن تبديل المتصفحات أو مسح بيانات المتصفح سيتطلّب إعادة الإقران.

​

ما الذي يمكنها فعله (حاليًا)

• الدردشة مع النموذج عبر Gateway WS (chat.history, chat.send, chat.abort, chat.inject)
• بثّ استدعاءات الأدوات + بطاقات إخراج الأدوات الحية في الدردشة (أحداث الوكيل)
• القنوات: حالة قنوات WhatsApp/Telegram/Discord/Slack + قنوات الإضافات (Mattermost، إلخ) + تسجيل الدخول عبر QR + تهيئة لكل قناة (channels.status, web.login.*, config.patch) القنوات: حالة قنوات WhatsApp/Telegram/Discord/Slack + قنوات الإضافات (Mattermost، إلخ) + تسجيل الدخول عبر QR + تهيئة لكل قناة (channels.status, web.login.*, config.patch) حالة + تسجيل الدخول QR + لكل قناة تهيئة (channels.status, web.login.*, config.patch)
• المثيلات: قائمة الحضور + تحديث (system-presence)
• الجلسات: قائمة + تجاوزات التفكير/الوضع المطوّل لكل جلسة (sessions.list, sessions.patch)
• مهام Cron: سرد/إضافة/تشغيل/تمكين/تعطيل + سجل التشغيل (cron.*)
• Skills: الحالة، تمكين/تعطيل، تثبيت، تحديثات مفاتيح API (skills.*)
• العُقد: قائمة + القدرات (node.list)
• موافقات التنفيذ: تحرير قوائم السماح لـ Gateway أو العُقد + طلب سياسة لـ exec host=gateway/node (exec.approvals.*)
• التهيئة: عرض/تحرير ~/.openclaw/openclaw.json (config.get, config.set)
• التهيئة: تطبيق + إعادة تشغيل مع التحقّق (config.apply) وإيقاظ آخر جلسة نشطة
• تتضمّن عمليات كتابة التهيئة حارس تجزئة أساسي لمنع الكتابة فوق تعديلات متزامنة
• مخطط التهيئة + عرض النماذج (config.schema، بما في ذلك مخططات الإضافات والقنوات)؛ يظل محرّر JSON الخام متاحًا
• التصحيح: لقطات الحالة/السلامة/النماذج + سجل الأحداث + استدعاءات RPC يدوية (status, health, models.list)
• السجلات: تتبّع مباشر لسجلات ملفات Gateway مع التصفية/التصدير (logs.tail)
• التحديث: تشغيل تحديث حزمة/مستودع git + إعادة تشغيل (update.run) مع تقرير إعادة التشغيل

• للمهام المعزولة، يكون التسليم افتراضيًا على إعلان ملخّص. يمكنك التبديل إلى «بدون» إذا أردت تشغيلًا داخليًا فقط.
• تظهر حقول القناة/الهدف عند اختيار «إعلان».

​

سلوك الدردشة

• chat.send غير حاجز: يتم الإقرار فورًا بـ { runId, status: "started" } ويتم بثّ الاستجابة عبر أحداث chat.
• إعادة الإرسال باستخدام نفس idempotencyKey تُرجع { status: "in_flight" } أثناء التشغيل، و{ status: "ok" } بعد الاكتمال.
• chat.inject يُلحق ملاحظة مساعد بنص الجلسة ويبث حدث chat لتحديثات واجهة المستخدم فقط (من دون تشغيل وكيل، ومن دون تسليم إلى قناة).
• الإيقاف:
  • انقر Stop (يستدعي chat.abort)
  • اكتب /stop (أو stop|esc|abort|wait|exit|interrupt) للإلغاء خارج النطاق
  • يدعم chat.abort { sessionKey } (من دون runId) لإلغاء جميع عمليات التشغيل النشطة لتلك الجلسة

​

الوصول عبر Tailnet (موصى به)

​

Tailscale Serve المدمج (المفضّل)

openclaw gateway --tailscale serve

• https://<magicdns>/ (أو gateway.controlUi.basePath الذي قمت بتهيئته)

​

الربط بـ tailnet + رمز

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

• http://<tailscale-ip>:18789/ (أو gateway.controlUi.basePath الذي قمت بتهيئته)

​

HTTP غير الآمن

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

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

​

بناء الواجهة

pnpm ui:build # auto-installs UI deps on first run

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

pnpm ui:dev # auto-installs UI deps on first run

​

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

1. ابدأ خادم تطوير الواجهة: pnpm ui:dev
2. افتح عنوان URL مثل:

http://localhost:5173/?gatewayUrl=ws://<gateway-host>:18789

http://localhost:5173/?gatewayUrl=wss://<gateway-host>:18789&token=<gateway-token>

• يتم تخزين gatewayUrl في localStorage بعد التحميل وإزالته من عنوان URL.
• يتم تخزين token في localStorage؛ بينما يُحتفظ بـ password في الذاكرة فقط.
• عند تعيين gatewayUrl، لا تعود الواجهة إلى بيانات اعتماد التهيئة أو البيئة. قدّم token (أو password) صراحةً. يُعد غياب بيانات اعتماد صريحة خطأً.
• استخدم wss:// عندما يكون Gateway خلف TLS (Tailscale Serve، وكيل HTTPS، إلخ).
• لا يُقبل gatewayUrl إلا في نافذة من المستوى الأعلى (غير مضمّنة) لمنع هجمات النقر الخادع.
• لإعدادات التطوير عبر أصول متعددة (على سبيل المثال: pnpm ui:dev إلى Gateway بعيد)، أضِف أصل الواجهة إلى gateway.controlUi.allowedOrigins.

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