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

إعداد المطور

الإعداد

ℹ️ إذا كنت تقوم بالإعداد لأول مرة، ابدأ بـ الشروع في العمل. للتفاصيل حول المعالج، راجع معالج الإعداد الأولي.

آخر تحديث: 2026-01-01

ملخص سريع​

  • التخصيص خارج المستودع: ~/.openclaw/workspace (مساحة العمل) + ~/.openclaw/openclaw.json (التكوين).
  • سير العمل المستقر: قم بتثبيت تطبيق macOS؛ ودعه يشغل Gateway المرفق.
  • سير العمل المتقدمة: شغل Gateway بنفسك عبر pnpm gateway:watch، ثم دع تطبيق macOS يتصل في وضع المحلي.

المتطلبات المسبقة (من المصدر)​

  • Node >=22
  • pnpm
  • Docker (اختياري؛ فقط للإعداد المعتمد على الحاويات/اختبارات النهاية إلى النهاية — راجع Docker)

استراتيجية التخصيص (حتى لا تؤثر التحديثات)​

إذا كنت تريد "تخصيص 100٪ لي" و تحديثات سهلة، احتفظ بتخصيصاتك في:

  • التكوين: ~/.openclaw/openclaw.json (JSON/JSON5-ish)
  • مساحة العمل: ~/.openclaw/workspace (المهارات، المطالبات، الذكريات؛ اجعلها مستودع git خاص)

قم بالتهيئة مرة واحدة:

openclaw setup

من داخل هذا المستودع، استخدم نقطة دخول CLI المحلية:

openclaw setup

إذا لم يكن لديك تثبيت عام بعد، شغله عبر pnpm openclaw setup.

تشغيل Gateway من هذا المستودع​

بعد pnpm build، يمكنك تشغيل CLI المعبأ مباشرة:

node openclaw.mjs gateway --port 18789 --verbose

سير العمل المستقر (تطبيق macOS أولاً)​

  1. قم بتثبيت + تشغيل OpenClaw.app (شريط القوائم).
  2. أكمل قائمة التحقق من الإعداد الأولي/الصلاحيات (مطالبات TCC).
  3. تأكد من أن Gateway في وضع المحلي ويعمل (التطبيق يديره).
  4. ربط القنوات (مثال: WhatsApp):
openclaw channels login
  1. فحص السلامة:
openclaw health

إذا لم يكن الإعداد الأولي متاحًا في بنيتك:

  • شغل openclaw setup، ثم openclaw channels login، ثم ابدأ Gateway يدويًا (openclaw gateway).

سير العمل المتقدمة (Gateway في طرفية)​

الهدف: العمل على Gateway المكتوب بـ TypeScript، الحصول على إعادة تحميل فورية، والحفاظ على واجهة تطبيق macOS متصلة.

0) (اختياري) تشغيل تطبيق macOS من المصدر أيضًا​

إذا كنت تريد أيضًا تطبيق macOS في الإصدار المتقدم:

./scripts/restart-mac.sh

1) ابدأ Gateway للتطوير​

pnpm install
pnpm gateway:watch

gateway:watch يشغل gateway في وضع المراقبة ويعيد التحميل عند تغييرات TypeScript.

2) وجه تطبيق macOS إلى Gateway الذي يعمل لديك​

في OpenClaw.app:

  • وضع الاتصال: المحلي سيتصل التطبيق بـ gateway الذي يعمل على المنفذ المُكوَّن.

3) التحقق​

  • يجب أن يقرأ حالة Gateway داخل التطبيق "باستخدام gateway موجود …"
  • أو عبر CLI:
openclaw health

الأخطاء الشائعة​

  • المنفذ الخطأ: Gateway WS يستخدم افتراضيًا ws://127.0.0.1:18789؛ حافظ على تطبيق + CLI على نفس المنفذ.
  • مكان تخزين الحالة:
    • بيانات الاعتماد: ~/.openclaw/credentials/
    • الجلسات: ~/.openclaw/agents//sessions/
    • السجلات: /tmp/openclaw/

خريطة تخزين بيانات الاعتماد​

استخدم هذا عند تصحيح أخطاء المصادقة أو عند اتخاذ قرار بشأن ما يجب نسخه احتياطيًا:

  • WhatsApp: ~/.openclaw/credentials/whatsapp//creds.json
  • رمز Telegram bot: في التكوين/env أو channels.telegram.tokenFile
  • رمز Discord bot: في التكوين/env أو SecretRef (مزودي env/file/exec)
  • رموز Slack: في التكوين/env (channels.slack.*)
  • قوائم السماح بالاقتران:
    • ~/.openclaw/credentials/-allowFrom.json (الحساب الافتراضي)
    • ~/.openclaw/credentials/--allowFrom.json (الحسابات غير الافتراضية)
  • ملفات تعريف مصادقة النموذج: ~/.openclaw/agents//agent/auth-profiles.json
  • حمولة الأسرار المدعومة بملف (اختياري): ~/.openclaw/secrets.json
  • استيراد OAuth القديم: ~/.openclaw/credentials/oauth.json المزيد من التفاصيل: الأمان.

التحديث (دون إفساد إعدادك)​

  • احتفظ بـ ~/.openclaw/workspace و ~/.openclaw/ على أنها "أشياءك الخاصة"؛ لا تضع مطالب/تكوينات شخصية في مستودع openclaw.
  • تحديث المصدر: git pull + pnpm install (عند تغيير ملف القفل) + استمر في استخدام pnpm gateway:watch.

Linux (خدمة مستخدم systemd)​

تستخدم تثبيتات Linux خدمة مستخدم systemd. افتراضيًا، يوقف systemd خدمات المستخدم عند تسجيل الخروج/عدم النشاط، مما يؤدي إلى إيقاف Gateway. يحاول الإعداد الأولي تمكين التمهل نيابة عنك (قد يطلب sudo). إذا كان لا يزال معطلًا، شغل:

sudo loginctl enable-linger $USER

للخوادم دائمة التشغيل أو متعددة المستخدمين، فكر في استخدام خدمة نظام بدلاً من خدمة مستخدم (لا حاجة للتمهل). راجع دفتر تشغيل Gateway للحصول على ملاحظات systemd.

وثائق ذات صلة​

الغوص العميق في إدارة الجلساتسير عمل تطوير Pi