​

التحديث

​

الموصى به: إعادة تشغيل مُثبّت الموقع (ترقية في المكان)

curl -fsSL https://openclaw.ai/install.sh | bash

• أضِف --no-onboard إذا كنت لا تريد تشغيل معالج الإعداد الأولي مرة أخرى.
• بالنسبة إلى تثبيتات المصدر، استخدم:
  curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
  
  سيقوم المُثبّت بـ git pull --rebase فقط إذا كان المستودع نظيفًا.
• بالنسبة إلى التثبيتات العامة، يستخدم السكربت npm install -g openclaw@latest داخليًا.
• ملاحظة قديمة: يظل clawdbot متاحًا كطبقة توافق.

​

قبل التحديث

• اعرف طريقة التثبيت: عام (npm/pnpm) مقابل من المصدر (git clone).
• اعرف كيف يعمل Gateway لديك: طرفية أمامية مقابل خدمة مُشرف عليها (launchd/systemd).
• خذ لقطات من تخصيصاتك:
  • التهيئة: ~/.openclaw/openclaw.json
  • بيانات الاعتماد: ~/.openclaw/credentials/
  • مساحة العمل: ~/.openclaw/workspace

​

التحديث (تثبيت عام)

npm i -g openclaw@latest

pnpm add -g openclaw@latest

openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable

openclaw doctor
openclaw gateway restart
openclaw health

• إذا كان Gateway يعمل كخدمة، فـ openclaw gateway restart مُفضّل على قتل أرقام العمليات.
• إذا كنت مثبتًا على إصدار محدد، فراجع «التراجع / التثبيت» أدناه.

​

التحديث (openclaw update)

openclaw update

• يتطلب شجرة عمل نظيفة.
• ينتقل إلى القناة المحددة (وسم أو فرع).
• يجلب التحديثات ويُعيد الدمج (rebase) مقابل upstream المُهيّأ (قناة التطوير).
• يثبّت الاعتمادات، ويبني، ويبني واجهة التحكم، ويشغّل openclaw doctor.
• يعيد تشغيل Gateway افتراضيًا (استخدم --no-restart للتخطي).

​

التحديث (واجهة التحكم / RPC)

1. يشغّل تدفق تحديث المصدر نفسه مثل openclaw update (git checkout فقط).
2. يكتب إشارة إعادة تشغيل مع تقرير مُنظّم (ذيل stdout/stderr).
3. يعيد تشغيل Gateway ويُرسل التقرير إلى آخر جلسة نشطة.

​

التحديث (من المصدر)

openclaw update

git pull
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw doctor
openclaw health

• pnpm build مهم عندما تشغّل الملف الثنائي المُعبّأ openclaw (openclaw.mjs) أو تستخدم Node لتشغيل dist/.
• إذا كنت تشغّل من نسخة مستودع دون تثبيت عام، فاستخدم pnpm openclaw ... لأوامر CLI.
• إذا كنت تشغّل مباشرة من TypeScript (pnpm openclaw ...)، فإعادة البناء غالبًا غير ضرورية، لكن ترحيلات التهيئة ما تزال مطبّقة → شغّل doctor.
• التبديل بين التثبيت العام وتثبيت git سهل: ثبّت النكهة الأخرى، ثم شغّل openclaw doctor حتى يُعاد كتابة نقطة دخول خدمة Gateway إلى التثبيت الحالي.

​

شغّل دائمًا: openclaw doctor

• ترحيل مفاتيح التهيئة المُهملة / مواقع ملفات التهيئة القديمة.
• تدقيق سياسات الرسائل الخاصة (DM) والتحذير من الإعدادات «المفتوحة» الخطِرة.
• فحص صحة Gateway وقد يعرض إعادة التشغيل.
• اكتشاف وترحيل خدمات Gateway الأقدم (launchd/systemd؛ schtasks القديمة) إلى خدمات OpenClaw الحالية.
• على Linux، التأكد من تمكين systemd user lingering (حتى يستمر Gateway بعد تسجيل الخروج).

​

بدء / إيقاف / إعادة تشغيل Gateway

openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow

• macOS launchd (LaunchAgent مُضمّن بالتطبيق): launchctl kickstart -k gui/$UID/bot.molt.gateway (استخدم bot.molt.<profile>؛ ولا يزال com.openclaw.* القديم يعمل)
• خدمة مستخدم systemd على لينكس: systemctl --user restart openclaw-gateway[-<profile>].service
• ويندوز (WSL2): systemctl --user restart openclaw-gateway[-<profile>].service
  • يعمل launchctl/systemctl فقط إذا كانت الخدمة مُثبّتة؛ وإلا فشغّل openclaw gateway install.

​

التراجع / التثبيت (عند توقف شيء)

​

التثبيت (تثبيت عام)

npm i -g openclaw@<version>

pnpm add -g openclaw@<version>

openclaw doctor
openclaw gateway restart

​

التثبيت (من المصدر) حسب التاريخ

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"

pnpm install
pnpm build
openclaw gateway restart

git checkout main
git pull

​

إذا علِقت

• شغّل openclaw doctor مرة أخرى واقرأ المخرجات بعناية (غالبًا ما تخبرك بالحل).
• تحقّق من: استكشاف الأخطاء وإصلاحها
• اسأل في Discord: https://discord.gg/clawd