لا حاجة لملف إعداد: اضبط OpenClaw بالكامل من واجهة الويب

4 min read

كثير من الدروس تطلب منك تعديل JSON في اليوم الأول، ثم تتساءل لماذا يهرب المبتدئون. هذه المقالة تُظهر الأخبار الأفضل: هناك واجهة مستخدم يمكنك النقر عليها.

ما الذي ستتعلمه

  • فتح واجهة الويب وإتمام المصادقة
  • فهم وضع النموذج مقابل وضع Raw JSON
  • ضبط توجيه مساحات عمل متعددة من واجهة المستخدم
  • معرفة أين تعيش الميزات الرئيسية

فتح واجهة الويب

الخطوة 1: تأكد من تشغيل Gateway

openclaw gateway

الخطوة 2: افتح متصفحك

http://127.0.0.1:18789/

إذا أعددت basePath، مثلاً /openclaw:

http://127.0.0.1:18789/openclaw

الخطوة 3: تعامل مع المصادقة

ما تراه الحل
pairing required شغّل openclaw devices list، ثم openclaw devices approve <requestId>
طلب رمز الصق رمز الإعداد

💡 يمكنك تغيير لغة واجهة المستخدم في قسم Access.


طريقتان لتعديل الإعداد: وضع النموذج مقابل Raw JSON

اذهب إلى صفحة Config وسترى أسلوبَي تعديل:

وضع النموذج: حقول منظمة بصرياً، مثالي للمبتدئين أو التغييرات الصغيرة.

وضع Raw JSON: تعديل مباشر للإعداد، الأفضل للمستخدمين المتقدمين أو التعديلات الكبيرة.

كلا الوضعَين يعدّلان نفس الملف: ~/.openclaw/openclaw.json.


أكثر إعداد شائع: مجموعات Telegram مختلفة تستخدم مساعدين مختلفين

السيناريو أ: نفس البوت، مجموعات مختلفة، مساحات عمل مختلفة

انتقل إلى Raw JSON وأضف هذا الهيكل:

{
  "agents": {
    "list": [
      { "id": "main",      "name": "رئيسي",    "workspace": "~/.openclaw/workspace-main",      "default": true },
      { "id": "project-a", "name": "المشروع أ", "workspace": "~/.openclaw/workspace-project-a" },
      { "id": "project-b", "name": "المشروع ب", "workspace": "~/.openclaw/workspace-project-b" }
    ]
  },
  "bindings": [
    { "agentId": "project-a", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1001234567890" } } },
    { "agentId": "project-b", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1009876543210" } } },
    { "agentId": "main",      "match": { "channel": "telegram" } }
  ],
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "رمز البوت الخاص بك",
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

كيف تجد معرّف المجموعة؟

  • الطريقة 1: أرسل رسالة في المجموعة وشغّل openclaw logs --follow، ثم افحص chat.id
  • الطريقة 2: أعد توجيه أي رسالة إلى @userinfobot

السيناريو ب: حسابات بوت مختلفة، مساحات عمل مختلفة

{
  "agents": {
    "list": [
      { "id": "main",   "workspace": "~/.openclaw/workspace-main" },
      { "id": "alerts", "workspace": "~/.openclaw/workspace-alerts" }
    ]
  },
  "bindings": [
    { "agentId": "main",   "match": { "channel": "telegram", "accountId": "default" } },
    { "agentId": "alerts", "match": { "channel": "telegram", "accountId": "alerts" } }
  ],
  "channels": {
    "telegram": {
      "accounts": {
        "default": { "botToken": "123456:ABC...", "dmPolicy": "pairing" },
        "alerts":  { "botToken": "987654:XYZ...", "dmPolicy": "allowlist", "allowFrom": ["tg:123456789"] }
      }
    }
  }
}

لا تنسَ الحفظ

انقر Save / Apply. سيقوم OpenClaw بـ:

  1. التحقق من صحة الإعداد
  2. تطبيقه، عادةً مع hot reload

⚠️ إذا حصلت على تعارض baseHash، فقد غيّر شخص ما أو شيء ما الإعداد في مكان آخر. أعد تحميل الإعداد وحاول مجدداً.


ماذا يمكن لواجهة الويب فعله أيضاً؟

القسم ما يفعله
Chat تحدث مع المساعد مباشرةً في المتصفح
Sessions راجع وأدر الجلسات
Cron أضف أو عدّل أو شغّل المهام المجدولة
Skills فعّل أو عطّل أو ثبّت المهارات
Channels افحص حالة القنوات
Debug / Logs عرض السجلات وتشغيل إجراءات RPC يدوية

مرجع سريع

أريد أن... أين أبحث في واجهة الويب
أوجّه مجموعات Telegram مختلفة إلى مساحات عمل مختلفة Config → Raw JSON → agents + bindings
أوجّه حسابات بوت مختلفة إلى مساحات عمل مختلفة Config → channels.telegram.accounts + bindings
أغيّر رمز البوت Config → channels.telegram.botToken
أدير الجداول الزمنية تبويب Cron
أعرض السجلات الفورية تبويب Debug / Logs

الفكرة الأساسية لتذكرها: توجيه مساحة العمل يتحدد دائماً بـ agents بالإضافة إلى bindings. واجهة الويب تمنحك فقط طريقة أكثر ودية لتعديله.


قراءة ذات صلة