إعداد المطور

الإعداد

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

آخر تحديث: 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/<agentId>/sessions/
    • السجلات: /tmp/openclaw/

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

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

  • WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
  • رمز Telegram bot: في التكوين/env أو channels.telegram.tokenFile
  • رمز Discord bot: في التكوين/env أو SecretRef (مزودي env/file/exec)
  • رموز Slack: في التكوين/env (channels.slack.*)
  • قوائم السماح بالاقتران:
    • ~/.openclaw/credentials/<channel>-allowFrom.json (الحساب الافتراضي)
    • ~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json (الحسابات غير الافتراضية)
  • ملفات تعريف مصادقة النموذج: ~/.openclaw/agents/<agentId>/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