التكوين والعمليات

التكوين

يقرأ OpenClaw ملف تكوين JSON5 اختياريًا من ~/.openclaw/openclaw.json. إذا كان الملف مفقودًا، يستخدم OpenClaw إعدادات افتراضية آمنة. الأسباب الشائعة لإضافة تكوين:

  • توصيل القنوات والتحكم في من يمكنه مراسلة البوت
  • تعيين النماذج، الأدوات، العزل، أو الأتمتة (وظائف مجدولة، خطافات)
  • ضبط الجلسات، الوسائط، الشبكات، أو واجهة المستخدم

راجع المرجع الكامل لكل حقل متاح.

💡 جديد في التكوين؟ ابدأ بـ openclaw onboard للإعداد التفاعلي، أو تحقق من دليل أمثلة التكوين للحصول على تكوينات كاملة قابلة للنسخ واللصق.

التكوين الأدنى

// ~/.openclaw/openclaw.json
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

تحرير التكوين

openclaw onboard       # معالج الإعداد الكامل
openclaw configure     # معالج التكوين

التحقق الصارم

⚠️ يقبل OpenClaw فقط التكوينات التي تطابق المخطط بالكامل. المفاتيح غير المعروفة، أو الأنواع غير الصحيحة، أو القيم غير الصالحة تتسبب في رفض البوابة البدء. الاستثناء الوحيد على مستوى الجذر هو $schema (سلسلة نصية)، حتى يتمكن المحررون من إرفاق بيانات تعريف مخطط JSON.

عند فشل التحقق:

  • لا يتم تشغيل البوابة
  • تعمل أوامر التشخيص فقط (openclaw doctor, openclaw logs, openclaw health, openclaw status)
  • قم بتشغيل openclaw doctor لرؤية المشكلات بالضبط
  • قم بتشغيل openclaw doctor --fix (أو --yes) لتطبيق الإصلاحات

المهام الشائعة

إعادة التحميل الساخن للتكوين

تراقب البوابة ملف ~/.openclaw/openclaw.json وتطبق التغييرات تلقائيًا — لا حاجة لإعادة تشغيل يدوية لمعظم الإعدادات.

أوضاع إعادة التحميل

الوضعالسلوك
hybrid (الافتراضي)يطبق التغييرات الآمنة على الفور. يعيد التشغيل تلقائيًا للتغييرات الحرجة.
hotيطبق التغييرات الآمنة فقط. يسجل تحذيرًا عندما تكون هناك حاجة لإعادة تشغيل — عليك التعامل معها.
restartيعيد تشغيل البوابة عند أي تغيير في التكوين، آمنًا كان أم لا.
offيعطل مراقبة الملف. التغييرات سارية المفعول عند إعادة التشغيل اليدوية التالية.
{
  gateway: {
    reload: { mode: "hybrid", debounceMs: 300 },
  },
}

ما الذي يتم تطبيقه ساخنًا مقابل ما يحتاج إلى إعادة تشغيل

معظم الحقول تطبق ساخنًا دون توقف. في وضع hybrid، يتم التعامل مع التغييرات التي تتطلب إعادة تشغيل تلقائيًا.

الفئةالحقولهل تحتاج إلى إعادة تشغيل؟
القنواتchannels.*, web (WhatsApp) — جميع القنوات المدمجة وامتدادات القنواتلا
الوكيل والنماذجagent, agents, models, routingلا
الأتمتةhooks, cron, agent.heartbeatلا
الجلسات والرسائلsession, messagesلا
الأدوات والوسائطtools, browser, skills, audio, talkلا
واجهة المستخدم ومتنوعاتui, logging, identity, bindingsلا
خادم البوابةgateway.* (المنفذ، الربط، المصادقة، tailscale، TLS، HTTP)نعم
البنية التحتيةdiscovery, canvasHost, pluginsنعم

ℹ️ gateway.reload و gateway.remote استثناءات — تغييرها لا يؤدي إلى إعادة تشغيل.

تكوين RPC (تحديثات برمجية)

ℹ️ عمليات كتابة RPC لمستوى التحكم (config.apply, config.patch, update.run) محدودة بمعدل 3 طلبات لكل 60 ثانية لكل deviceId+clientIp. عند التحديد، ترجع RPC UNAVAILABLE مع retryAfterMs.

متغيرات البيئة

يقرأ OpenClaw متغيرات البيئة من العملية الأصل بالإضافة إلى:

  • .env من دليل العمل الحالي (إذا كان موجودًا)
  • ~/.openclaw/.env (الرجوع العالمي)

لا يتجاوز أي ملف متغيرات البيئة الموجودة. يمكنك أيضًا تعيين متغيرات بيئة مضمنة في التكوين:

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}

راجع البيئة للحصول على الأسبقية والمصادر الكاملة.

المرجع الكامل

للحصول على المرجع الكامل حقلًا بحقل، راجع مرجع التكوين.

ذات صلة: أمثلة التكوين · مرجع التكوين · Doctor

دفتر تشغيل البوابةمرجع التكوين