chore(i18n): refresh ar translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-19 07:25:15 +00:00
parent d712045c62
commit d6ba46b643
4 changed files with 1220 additions and 1203 deletions

File diff suppressed because it is too large Load Diff

View File

@ -1,24 +1,24 @@
---
read_when:
- تحتاج إلى طريقة تثبيت غير البدء السريع في Getting Started
- تريد النشر على منصة سحابية
- تحتاج إلى التحديث أو الترحيل أو إلغاء التثبيت
summary: تثبيت OpenClaw — script التثبيت، وnpm/pnpm/bun، ومن المصدر، وDocker، وغير ذلك
title: التثبيت
- أنت بحاجة إلى طريقة تثبيت غير البدء السريع في قسم Getting Started
- تريد النشر إلى منصة سحابية
- تحتاج إلى التحديث، أو الترحيل، أو إلغاء التثبيت
summary: ثبّت OpenClaw — نص التثبيت البرمجي، وnpm/pnpm/bun، ومن المصدر، وDocker، والمزيد
title: ثبّت
x-i18n:
generated_at: "2026-04-05T12:47:16Z"
generated_at: "2026-04-19T07:16:05Z"
model: gpt-5.4
provider: openai
source_hash: eca17c76a2a66166b3d8cda9dc3144ab920d30ad0ed2a220eb9389d7a383ba5d
source_hash: ad0a5fdbbf13dcaf2fed6840f35aa22b2e9e458509509f98303c8d87c2556a6f
source_path: install/index.md
workflow: 15
---
# التثبيت
## الموصى به: script التثبيت
## الموصى به: نص التثبيت البرمجي
أسرع طريقة للتثبيت. يكتشف نظام التشغيل لديك، ويثبت Node عند الحاجة، ويثبت OpenClaw، ثم يشغّل onboarding.
أسرع طريقة للتثبيت. يكتشف نظام التشغيل لديك، ويثبّت Node إذا لزم الأمر، ويثبّت OpenClaw، ثم يبدأ الإعداد الأوّلي.
<Tabs>
<Tab title="macOS / Linux / WSL2">
@ -33,7 +33,7 @@ x-i18n:
</Tab>
</Tabs>
للتثبيت من دون تشغيل onboarding:
للتثبيت بدون تشغيل الإعداد الأوّلي:
<Tabs>
<Tab title="macOS / Linux / WSL2">
@ -48,27 +48,26 @@ x-i18n:
</Tab>
</Tabs>
للاطلاع على جميع العلامات وخيارات CI/الأتمتة، راجع [الجوانب الداخلية للمثبّت](/install/installer).
للاطّلاع على جميع العلامات وخيارات CI/الأتمتة، راجع [تفاصيل أداة التثبيت](/ar/install/installer).
## متطلبات النظام
- **Node 24** (موصى به) أو Node 22.14+ — يتولى script التثبيت ذلك تلقائيًا
- **macOS أو Linux أو Windows**يدعم كلًا من Windows الأصلي وWSL2؛ ويكون WSL2 أكثر استقرارًا. راجع [Windows](/platforms/windows).
- يلزم `pnpm` فقط إذا كنت ستبني من المصدر
- **Node 24** (موصى به) أو Node 22.14+ — يتولى نص التثبيت البرمجي هذا تلقائيًا
- **macOS أو Linux أو Windows**كل من Windows الأصلي وWSL2 مدعومان؛ WSL2 أكثر استقرارًا. راجع [Windows](/ar/platforms/windows).
- لا تكون `pnpm` مطلوبة إلا إذا كنت ستبني من المصدر
## طرق التثبيت البديلة
### مثبّت local prefix (`install-cli.sh`)
### أداة التثبيت ذات البادئة المحلية (`install-cli.sh`)
استخدمه عندما تريد الاحتفاظ بـ OpenClaw وNode تحت local prefix مثل
استخدم هذا عندما تريد الاحتفاظ بـ OpenClaw وNode ضمن بادئة محلية مثل
`~/.openclaw`، من دون الاعتماد على تثبيت Node على مستوى النظام:
```bash
curl -fsSL https://openclaw.ai/install-cli.sh | bash
```
يدعم هذا المسار تثبيتات npm افتراضيًا، بالإضافة إلى تثبيتات نسخة git المحلية ضمن
تدفق prefix نفسه. المرجع الكامل: [الجوانب الداخلية للمثبّت](/install/installer#install-clish).
وهي تدعم تثبيتات npm افتراضيًا، بالإضافة إلى التثبيتات من نسخة git checkout ضمن تدفق البادئة نفسه. المرجع الكامل: [تفاصيل أداة التثبيت](/ar/install/installer#install-clish).
### npm أو pnpm أو bun
@ -89,7 +88,7 @@ curl -fsSL https://openclaw.ai/install-cli.sh | bash
```
<Note>
يتطلب pnpm موافقة صريحة على الحزم التي تحتوي على scripts بناء. شغّل `pnpm approve-builds -g` بعد أول تثبيت.
يتطلب pnpm موافقة صريحة على الحزم التي تحتوي على نصوص بناء برمجية. شغّل `pnpm approve-builds -g` بعد أول تثبيت.
</Note>
</Tab>
@ -100,14 +99,14 @@ curl -fsSL https://openclaw.ai/install-cli.sh | bash
```
<Note>
يتم دعم Bun لمسار تثبيت CLI العام فقط. أما بالنسبة إلى وقت تشغيل Gateway، فما يزال Node هو بيئة daemon الموصى بها.
Bun مدعوم لمسار التثبيت العام لـ CLI. أمّا بالنسبة إلى بيئة تشغيل Gateway، فما يزال Node هو بيئة daemon الموصى بها.
</Note>
</Tab>
</Tabs>
<Accordion title="استكشاف الأخطاء وإصلاحها: أخطاء بناء sharp (npm)">
إذا فشل `sharp` بسبب libvips مثبّتة على مستوى النظام:
<Accordion title="استكشاف الأخطاء وإصلاحها: أخطاء بناء sharp (npm)">
إذا فشل `sharp` بسبب وجود libvips مثبّتة على مستوى النظام:
```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
@ -117,17 +116,17 @@ SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
### من المصدر
للمساهمين أو لأي شخص يريد التشغيل من نسخة محلية:
للمساهمين أو لأي شخص يريد التشغيل من نسخة checkout محلية:
```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
```
أو تخطَّ الربط واستخدم `pnpm openclaw ...` من داخل المستودع. راجع [الإعداد](/start/setup) للحصول على تدفقات التطوير الكاملة.
أو يمكنك تخطي الربط واستخدام `pnpm openclaw ...` من داخل المستودع. راجع [الإعداد](/ar/start/setup) للاطّلاع على مسارات العمل التطويرية الكاملة.
### التثبيت من GitHub main
@ -138,82 +137,82 @@ npm install -g github:openclaw/openclaw#main
### الحاويات ومديرو الحزم
<CardGroup cols={2}>
<Card title="Docker" href="/install/docker" icon="container">
عمليات نشر معبأة أو بلا واجهة.
<Card title="Docker" href="/ar/install/docker" icon="container">
عمليات نشر داخل حاويات أو بدون واجهة.
</Card>
<Card title="Podman" href="/install/podman" icon="container">
بديل حاويات rootless لـ Docker.
<Card title="Podman" href="/ar/install/podman" icon="container">
بديل حاويات بدون صلاحيات root لـ Docker.
</Card>
<Card title="Nix" href="/install/nix" icon="snowflake">
<Card title="Nix" href="/ar/install/nix" icon="snowflake">
تثبيت تصريحي عبر Nix flake.
</Card>
<Card title="Ansible" href="/install/ansible" icon="server">
تجهيز آلي للأساطيل.
<Card title="Ansible" href="/ar/install/ansible" icon="server">
تجهيز آلي على نطاق واسع.
</Card>
<Card title="Bun" href="/install/bun" icon="zap">
استخدام CLI فقط عبر وقت تشغيل Bun.
<Card title="Bun" href="/ar/install/bun" icon="zap">
استخدام CLI فقط عبر بيئة Bun.
</Card>
</CardGroup>
## التحقق من التثبيت
```bash
openclaw --version # تأكيد توفر CLI
openclaw doctor # التحقق من مشكلات التكوين
openclaw gateway status # التحقق من أن Gateway تعمل
openclaw --version # تأكيد أن CLI متاح
openclaw doctor # التحقق من مشكلات الإعداد
openclaw gateway status # التحقق من أن Gateway يعمل
```
إذا كنت تريد بدء تشغيل مُدارًا بعد التثبيت:
إذا كنت تريد بدءًا مُدارًا بعد التثبيت:
- macOS: LaunchAgent عبر `openclaw onboard --install-daemon` أو `openclaw gateway install`
- Linux/WSL2: خدمة مستخدم systemd عبر الأوامر نفسها
- Windows الأصلي: Scheduled Task أولًا، مع بديل عنصر تسجيل دخول لكل مستخدم في Startup folder إذا تم رفض إنشاء المهمة
- macOS: LaunchAgent عبر `openclaw onboard --install-daemon` أو `openclaw gateway install`
- Linux/WSL2: خدمة systemd على مستوى المستخدم عبر الأوامر نفسها
- Windows الأصلي: Scheduled Task أولًا، مع بديل عنصر تسجيل دخول لكل مستخدم في مجلد Startup إذا تم رفض إنشاء المهمة
## الاستضافة والنشر
انشر OpenClaw على خادم سحابي أو VPS:
<CardGroup cols={3}>
<Card title="VPS" href="/vps">أي Linux VPS</Card>
<Card title="Docker VM" href="/install/docker-vm-runtime">خطوات Docker المشتركة</Card>
<Card title="Kubernetes" href="/install/kubernetes">K8s</Card>
<Card title="Fly.io" href="/install/fly">Fly.io</Card>
<Card title="Hetzner" href="/install/hetzner">Hetzner</Card>
<Card title="GCP" href="/install/gcp">Google Cloud</Card>
<Card title="Azure" href="/install/azure">Azure</Card>
<Card title="Railway" href="/install/railway">Railway</Card>
<Card title="Render" href="/install/render">Render</Card>
<Card title="Northflank" href="/install/northflank">Northflank</Card>
<Card title="VPS" href="/ar/vps">أي VPS يعمل بنظام Linux</Card>
<Card title="Docker VM" href="/ar/install/docker-vm-runtime">خطوات Docker المشتركة</Card>
<Card title="Kubernetes" href="/ar/install/kubernetes">K8s</Card>
<Card title="Fly.io" href="/ar/install/fly">Fly.io</Card>
<Card title="Hetzner" href="/ar/install/hetzner">Hetzner</Card>
<Card title="GCP" href="/ar/install/gcp">Google Cloud</Card>
<Card title="Azure" href="/ar/install/azure">Azure</Card>
<Card title="Railway" href="/ar/install/railway">Railway</Card>
<Card title="Render" href="/ar/install/render">Render</Card>
<Card title="Northflank" href="/ar/install/northflank">Northflank</Card>
</CardGroup>
## التحديث أو الترحيل أو إلغاء التثبيت
<CardGroup cols={3}>
<Card title="التحديث" href="/install/updating" icon="refresh-cw">
حافظ على تحديث OpenClaw.
<Card title="التحديث" href="/ar/install/updating" icon="refresh-cw">
حافظ على OpenClaw محدّثًا.
</Card>
<Card title="الترحيل" href="/install/migrating" icon="arrow-right">
الانتقال إلى جهاز جديد.
<Card title="الترحيل" href="/ar/install/migrating" icon="arrow-right">
انقل إلى جهاز جديد.
</Card>
<Card title="إلغاء التثبيت" href="/install/uninstall" icon="trash-2">
إزالة OpenClaw بالكامل.
<Card title="إلغاء التثبيت" href="/ar/install/uninstall" icon="trash-2">
أزل OpenClaw بالكامل.
</Card>
</CardGroup>
## استكشاف الأخطاء وإصلاحها: تعذر العثور على `openclaw`
## استكشاف الأخطاء وإصلاحها: تعذّر العثور على `openclaw`
إذا نجح التثبيت لكن تعذر العثور على `openclaw` في طرفيتك:
إذا نجح التثبيت لكن تعذّر العثور على `openclaw` في الطرفية لديك:
```bash
node -v # هل Node مثبت؟
node -v # هل Node مثبّت؟
npm prefix -g # أين توجد الحزم العامة؟
echo "$PATH" # هل يوجد دليل bin العام في PATH؟
echo "$PATH" # هل دليل bin العام موجود في PATH؟
```
إذا لم يكن `$(npm prefix -g)/bin` موجودًا في `$PATH` لديك، فأضفه إلى ملف بدء shell (`~/.zshrc` أو `~/.bashrc`):
إذا لم يكن `$(npm prefix -g)/bin` موجودًا في `$PATH` لديك، فأضفه إلى ملف بدء تشغيل الصدفة (`~/.zshrc` أو `~/.bashrc`):
```bash
export PATH="$(npm prefix -g)/bin:$PATH"
```
ثم افتح طرفية جديدة. راجع [إعداد Node](/install/node) لمزيد من التفاصيل.
ثم افتح طرفية جديدة. راجع [إعداد Node](/ar/install/node) لمزيد من التفاصيل.

View File

@ -1,43 +1,43 @@
---
read_when:
- تثبيت OpenClaw على Windows
- الاختيار بين Windows الأصلية وWSL2
- الاختيار بين Windows الأصلي وWSL2
- البحث عن حالة التطبيق المرافق لـ Windows
summary: 'دعم Windows: مسارات التثبيت الأصلية وWSL2، وdaemon، والمحاذير الحالية'
summary: 'دعم Windows: مسارات التثبيت الأصلية وWSL2، الخدمة الخلفية، والمحاذير الحالية'
title: Windows
x-i18n:
generated_at: "2026-04-05T12:50:48Z"
generated_at: "2026-04-19T07:16:04Z"
model: gpt-5.4
provider: openai
source_hash: 7d9819206bdd65cf03519c1bc73ed0c7889b0ab842215ea94343262300adfd14
source_hash: 1e7451c785a1d75c809522ad93e2c44a00b211f77f14c5c489fd0b01840d3fe2
source_path: platforms/windows.md
workflow: 15
---
# Windows
يدعم OpenClaw كلاً من **Windows الأصلية** و**WSL2**. ويُعد WSL2 المسار الأكثر
استقرارًا والموصى به للحصول على التجربة الكاملة — حيث تعمل CLI وGateway
والأدوات داخل Linux مع توافق كامل. أما Windows الأصلية فتعامل بشكل جيد
مع CLI الأساسية واستخدامات Gateway، مع بعض المحاذير المذكورة أدناه.
يدعم OpenClaw كلاً من **Windows الأصلي** و**WSL2**. يُعد WSL2 المسار الأكثر
استقرارًا ويوصى به للحصول على التجربة الكاملة — إذ تعمل CLI وGateway وأدوات
العمل داخل Linux مع توافق كامل. يعمل Windows الأصلي مع استخدامات CLI وGateway
الأساسية، مع بعض المحاذير الموضحة أدناه.
من المخطط توفير تطبيقات مرافقة أصلية لـ Windows.
تطبيقات Windows المرافقة الأصلية مخطط لها.
## WSL2 (موصى به)
- [Getting Started](/ar/start/getting-started) (استخدمه داخل WSL)
- [Install & updates](/install/updating)
- [البدء](/ar/start/getting-started) (استخدمه داخل WSL)
- [التثبيت والتحديثات](/ar/install/updating)
- دليل WSL2 الرسمي (Microsoft): [https://learn.microsoft.com/windows/wsl/install](https://learn.microsoft.com/windows/wsl/install)
## حالة Windows الأصلية
## حالة Windows الأصلي
تتحسن تدفقات CLI الأصلية على Windows، لكن WSL2 ما تزال المسار الموصى به.
تتحسن تدفقات CLI الأصلية على Windows، لكن WSL2 لا يزال هو المسار الموصى به.
ما الذي يعمل جيدًا على Windows الأصلية اليوم:
ما الذي يعمل جيدًا على Windows الأصلي اليوم:
- مثبّت الموقع عبر `install.ps1`
- مُثبّت الموقع عبر `install.ps1`
- استخدام CLI المحلي مثل `openclaw --version` و`openclaw doctor` و`openclaw plugins list --json`
- اختبارات smoke المحلية للوكيل/المزوّد المضمّنين مثل:
- اختبارات local-agent/provider المضمنة مثل:
```powershell
openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK."
@ -45,34 +45,34 @@ openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOW
المحاذير الحالية:
- ما يزال `openclaw onboard --non-interactive` يتوقع gateway محلية قابلة للوصول ما لم تمرر `--skip-health`
- يحاول `openclaw onboard --non-interactive --install-daemon` و`openclaw gateway install` استخدام Windows Scheduled Tasks أولًا
- إذا تم رفض إنشاء Scheduled Task، يعود OpenClaw إلى عنصر تسجيل دخول لكل مستخدم في مجلد Startup ويبدأ gateway فورًا
- إذا تعطلت `schtasks` نفسها أو توقفت عن الاستجابة، يوقف OpenClaw هذا المسار بسرعة الآن ويعود إلى الرجوع الاحتياطي بدلًا من التعليق إلى الأبد
- ما تزال Scheduled Tasks هي المفضلة عندما تكون متاحة لأنها توفّر حالة مشرف أفضل
- لا يزال `openclaw onboard --non-interactive` يتوقع وجود Gateway محلي قابل للوصول ما لم تمرر `--skip-health`
- يحاول `openclaw onboard --non-interactive --install-daemon` و`openclaw gateway install` استخدام Windows Scheduled Tasks أولاً
- إذا تم رفض إنشاء Scheduled Task، يعود OpenClaw إلى عنصر تسجيل دخول لكل مستخدم داخل مجلد Startup ويبدأ Gateway فورًا
- إذا تعطل `schtasks` نفسه أو توقف عن الاستجابة، فإن OpenClaw يوقف هذا المسار الآن بسرعة ويعود إلى البديل بدلًا من التعليق إلى الأبد
- لا تزال Scheduled Tasks هي الخيار المفضل عند توفرها لأنها توفّر حالة إشراف أفضل
إذا كنت تريد CLI الأصلية فقط، من دون تثبيت خدمة gateway، فاستخدم أحد هذين:
إذا كنت تريد CLI الأصلي فقط، من دون تثبيت خدمة Gateway، فاستخدم أحد هذين الأمرين:
```powershell
openclaw onboard --non-interactive --skip-health
openclaw gateway run
```
إذا كنت تريد بدءًا مُدارًا على Windows الأصلية:
إذا كنت تريد تشغيلًا مُدارًا عند بدء التشغيل على Windows الأصلي:
```powershell
openclaw gateway install
openclaw gateway status --json
```
إذا تم حظر إنشاء Scheduled Task، فسيظل وضع الخدمة الاحتياطية يبدأ تلقائيًا بعد تسجيل الدخول عبر مجلد Startup الخاص بالمستخدم الحالي.
إذا كان إنشاء Scheduled Task محظورًا، فسيظل وضع الخدمة الاحتياطي يبدأ تلقائيًا بعد تسجيل الدخول عبر مجلد Startup الخاص بالمستخدم الحالي.
## Gateway
- [Gateway runbook](/gateway)
- [Configuration](/gateway/configuration)
- [دليل تشغيل Gateway](/ar/gateway)
- [الإعدادات](/ar/gateway/configuration)
## تثبيت خدمة Gateway (CLI)
## تثبيت خدمة Gateway (CLI)
داخل WSL2:
@ -92,7 +92,7 @@ openclaw gateway install
openclaw configure
```
اختر **Gateway service** عند مطالبتك.
اختر **خدمة Gateway** عند ظهور المطالبة.
الإصلاح/الترحيل:
@ -100,12 +100,12 @@ openclaw configure
openclaw doctor
```
## التشغيل التلقائي لـ Gateway قبل تسجيل الدخول إلى Windows
## البدء التلقائي لـ Gateway قبل تسجيل الدخول إلى Windows
بالنسبة إلى الإعدادات بدون واجهة، تأكد من أن سلسلة الإقلاع الكاملة تعمل حتى عندما لا يسجّل أحد الدخول إلى
Windows.
لإعدادات التشغيل دون واجهة، تأكد من أن سلسلة الإقلاع الكاملة تعمل حتى عندما لا
يقوم أحد بتسجيل الدخول إلى Windows.
### 1) إبقاء خدمات المستخدم تعمل من دون تسجيل الدخول
### 1) إبقاء خدمات المستخدم قيد التشغيل دون تسجيل دخول
داخل WSL:
@ -121,15 +121,15 @@ sudo loginctl enable-linger "$(whoami)"
openclaw gateway install
```
### 3) بدء WSL تلقائيًا عند إقلاع Windows
### 3) تشغيل WSL تلقائيًا عند إقلاع Windows
في PowerShell بصلاحية المسؤول:
في PowerShell بصلاحيات Administrator:
```powershell
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM
```
استبدل `Ubuntu` باسم التوزيعة لديك من:
استبدل `Ubuntu` باسم توزيعتك من:
```powershell
wsl --list --verbose
@ -144,14 +144,14 @@ systemctl --user is-enabled openclaw-gateway.service
systemctl --user status openclaw-gateway.service --no-pager
```
## متقدم: كشف خدمات WSL عبر LAN (portproxy)
## متقدم: إتاحة خدمات WSL عبر LAN (portproxy)
تملك WSL شبكتها الافتراضية الخاصة. إذا كان جهاز آخر يحتاج إلى الوصول إلى خدمة
تعمل **داخل WSL** (SSH أو خادم TTS محلي أو Gateway)، فيجب
تمرير منفذ من Windows إلى عنوان IP الحالي الخاص بـ WSL. ويتغير عنوان IP الخاص بـ WSL بعد إعادة التشغيل،
لذا قد تحتاج إلى تحديث قاعدة التمرير.
يمتلك WSL شبكته الافتراضية الخاصة. إذا كانت هناك حاجة لأن يصل جهاز آخر إلى خدمة
تعمل **داخل WSL** (مثل SSH أو خادم TTS محلي أو Gateway)، فيجب عليك إعادة توجيه
منفذ في Windows إلى عنوان IP الحالي لـ WSL. يتغير عنوان IP الخاص بـ WSL بعد
إعادة التشغيل، لذا قد تحتاج إلى تحديث قاعدة إعادة التوجيه.
مثال (PowerShell **بصلاحية المسؤول**):
مثال (PowerShell **بصلاحيات Administrator**):
```powershell
$Distro = "Ubuntu-24.04"
@ -165,7 +165,7 @@ netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPor
connectaddress=$WslIp connectport=$TargetPort
```
اسمح بالمنفذ عبر Windows Firewall (مرة واحدة):
اسمح بمرور المنفذ عبر Windows Firewall (مرة واحدة):
```powershell
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
@ -182,29 +182,29 @@ netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.
ملاحظات:
- يستهدف SSH من جهاز آخر **عنوان IP الخاص بمضيف Windows** (مثال: `ssh user@windows-host -p 2222`).
- يجب أن تشير العقد البعيدة إلى عنوان URL لـ Gateway **يمكن الوصول إليه** (وليس `127.0.0.1`)؛ استخدم
`openclaw status --all` للتأكيد.
- يستهدف SSH من جهاز آخر **عنوان IP لمضيف Windows** (مثال: `ssh user@windows-host -p 2222`).
- يجب أن تشير Node البعيدة إلى عنوان URL لـ Gateway **قابل للوصول** (وليس `127.0.0.1`)؛ استخدم
`openclaw status --all` للتأكد.
- استخدم `listenaddress=0.0.0.0` للوصول عبر LAN؛ أما `127.0.0.1` فيبقيه محليًا فقط.
- إذا كنت تريد تنفيذ ذلك تلقائيًا، فسجّل Scheduled Task لتشغيل
- إذا أردت أن يتم هذا تلقائيًا، فسجّل Scheduled Task لتشغيل
خطوة التحديث عند تسجيل الدخول.
## تثبيت WSL2 خطوة بخطوة
### 1) تثبيت WSL2 + Ubuntu
افتح PowerShell (المسؤول):
افتح PowerShell (بصلاحيات Admin):
```powershell
wsl --install
# Or pick a distro explicitly:
# أو اختر توزيعة بشكل صريح:
wsl --list --online
wsl --install -d Ubuntu-24.04
```
أعد التشغيل إذا طلب Windows ذلك.
### 2) تمكين systemd (مطلوب لتثبيت gateway)
### 2) تفعيل systemd (مطلوب لتثبيت Gateway)
في طرفية WSL لديك:
@ -227,22 +227,32 @@ wsl --shutdown
systemctl --user status
```
### 3) تثبيت OpenClaw (داخل WSL)
### 3) تثبيت OpenClaw (داخل WSL)
اتبع تدفق Linux Getting Started داخل WSL:
لإعداد أولي عادي داخل WSL، اتبع تدفق البدء الخاص بـ Linux:
```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
openclaw onboard
pnpm ui:build
pnpm openclaw onboard --install-daemon
```
الدليل الكامل: [Getting Started](/ar/start/getting-started)
إذا كنت تطور من المصدر بدلًا من تنفيذ الإعداد الأولي لأول مرة، فاستخدم
حلقة تطوير المصدر من [الإعداد](/ar/start/setup):
## التطبيق المرافق لـ Windows
```bash
pnpm install
# التشغيل الأول فقط (أو بعد إعادة تعيين إعدادات/مساحة عمل OpenClaw المحلية)
pnpm openclaw setup
pnpm gateway:watch
```
ليس لدينا تطبيق مرافق لـ Windows حتى الآن. المساهمات مرحب بها إذا كنت تريد
الدليل الكامل: [البدء](/ar/start/getting-started)
## تطبيق Windows المرافق
لا نملك تطبيق Windows مرافقًا بعد. نرحب بالمساهمات إذا كنت تريد
المساعدة في تحقيق ذلك.

View File

@ -1,14 +1,14 @@
---
read_when:
- إعداد جهاز جديد
- تريد "أحدث وأفضل" دون كسر إعدادك الشخصي
summary: إعدادات متقدمة ومسارات عمل التطوير لـ OpenClaw
- تريد الحصول على «أحدث وأفضل» إصدار من دون تعطيل إعدادك الشخصي.
summary: إعدادات متقدمة وسير عمل التطوير لـ OpenClaw
title: الإعداد
x-i18n:
generated_at: "2026-04-05T12:56:56Z"
generated_at: "2026-04-19T07:16:05Z"
model: gpt-5.4
provider: openai
source_hash: be4e280dde7f3a224345ca557ef2fb35a9c9db8520454ff63794ac6f8d4e71e7
source_hash: 773cdbef5f38b069303b5e13fca5fcdc28f082746869f17b8b92aab1610b95a8
source_path: start/setup.md
workflow: 15
---
@ -16,44 +16,44 @@ x-i18n:
# الإعداد
<Note>
إذا كنت تُعد النظام لأول مرة، فابدأ بـ [البدء](/ar/start/getting-started).
للحصول على تفاصيل الإعداد الأولي، راجع [الإعداد الأولي (CLI)](/ar/start/wizard).
إذا كنت تُجري الإعداد لأول مرة، فابدأ من [البدء](/ar/start/getting-started).
للاطلاع على تفاصيل التهيئة الأولية، راجع [التهيئة الأولية (CLI)](/ar/start/wizard).
</Note>
## الخلاصة
- **التخصيص يوجد خارج المستودع:** `~/.openclaw/workspace` (مساحة العمل) + `~/.openclaw/openclaw.json` (التهيئة).
- **مسار العمل المستقر:** ثبّت تطبيق macOS ودعه يشغّل Gateway المضمّن.
- **مسار العمل الأحدث:** شغّل Gateway بنفسك عبر `pnpm gateway:watch`، ثم دع تطبيق macOS يتصل في الوضع المحلي.
- **التخصيص يوجد خارج المستودع:** `~/.openclaw/workspace` (مساحة العمل) + `~/.openclaw/openclaw.json` (الإعدادات).
- **سير العمل المستقر:** ثبّت تطبيق macOS ودعه يشغّل Gateway المضمّن.
- **سير عمل أحدث الإصدارات:** شغّل Gateway بنفسك عبر `pnpm gateway:watch`، ثم دع تطبيق macOS يتصل به في وضع Local.
## المتطلبات المسبقة (من المصدر)
- يوصى باستخدام Node 24 (ولا يزال Node 22 LTS، حاليًا `22.14+`، مدعومًا)
- يُفضّل `pnpm` (أو Bun إذا كنت تستخدم عمدًا [مسار عمل Bun](/ar/install/bun))
- Docker (اختياري؛ فقط للإعداد/اختبارات e2e داخل الحاويات — راجع [Docker](/ar/install/docker))
- يُوصى باستخدام Node 24 (ولا يزال Node 22 LTS، حاليًا `22.14+`، مدعومًا)
- يُفضَّل `pnpm` (أو Bun إذا كنت تستخدم عمدًا [سير عمل Bun](/ar/install/bun))
- Docker (اختياري؛ فقط للإعداد داخل الحاويات/اختبارات e2e — راجع [Docker](/ar/install/docker))
## استراتيجية التخصيص (حتى لا تضر التحديثات)
## استراتيجية التخصيص (حتى لا تضرّك التحديثات)
إذا كنت تريد "مخصصًا لي 100%" _ تحديثات سهلة، فاحتفظ بتخصيصك في:
إذا كنت تريد إعدادًا «مخصصًا لي 100%» _وفي الوقت نفسه_ تحديثات سهلة، فاحتفظ بتخصيصاتك في:
- **التهيئة:** `~/.openclaw/openclaw.json` (JSON/بصيغة شبيهة بـ JSON5)
- **مساحة العمل:** `~/.openclaw/workspace` (Skills، والموجّهات، والذكريات؛ اجعلها مستودع git خاصًا)
- **الإعدادات:** `~/.openclaw/openclaw.json` (بصيغة JSON/مشابهة لـ JSON5)
- **مساحة العمل:** `~/.openclaw/workspace` (Skills، وprompts، وmemories؛ اجعلها مستودع git خاصًا)
نفّذ التمهيد مرة واحدة:
هيّئ مرة واحدة:
```bash
openclaw setup
```
من داخل هذا المستودع، استخدم نقطة إدخال CLI المحلية:
من داخل هذا المستودع، استخدم مدخل CLI المحلي:
```bash
openclaw setup
```
إذا لم يكن لديك تثبيت عام بعد، فشغّله عبر `pnpm openclaw setup` (أو `bun run openclaw setup` إذا كنت تستخدم مسار عمل Bun).
إذا لم يكن لديك تثبيت عام بعد، فشغّله عبر `pnpm openclaw setup` (أو `bun run openclaw setup` إذا كنت تستخدم سير عمل Bun).
## تشغيل Gateway من هذا المستودع
## شغّل Gateway من هذا المستودع
بعد `pnpm build`، يمكنك تشغيل CLI المجمّع مباشرة:
@ -61,11 +61,11 @@ openclaw setup
node openclaw.mjs gateway --port 18789 --verbose
```
## مسار العمل المستقر (تطبيق macOS أولًا)
## سير العمل المستقر (تطبيق macOS أولًا)
1. ثبّت وشغّل **OpenClaw.app** (شريط القوائم).
2. أكمل قائمة التحقق الخاصة بالإعداد الأولي/الأذونات (مطالبات TCC).
3. تأكد من أن Gateway مضبوط على **Local** ويعمل (يتولى التطبيق إدارته).
2. أكمل قائمة التحقق الخاصة بالتهيئة الأولية/الأذونات (مطالبات TCC).
3. تأكد من أن Gateway مضبوط على **Local** ويعمل (التطبيق يديره).
4. اربط الواجهات (مثال: WhatsApp):
```bash
@ -78,17 +78,17 @@ openclaw channels login
openclaw health
```
إذا لم يكن الإعداد الأولي متاحًا في نسختك:
إذا لم تكن التهيئة الأولية متاحة في نسختك:
- شغّل `openclaw setup`، ثم `openclaw channels login`، ثم ابدأ Gateway يدويًا (`openclaw gateway`).
## مسار العمل الأحدث (Gateway في طرفية)
## سير عمل أحدث الإصدارات (Gateway في الطرفية)
الهدف: العمل على TypeScript Gateway، والحصول على إعادة تحميل فورية، مع إبقاء واجهة تطبيق macOS متصلة.
الهدف: العمل على Gateway المكتوب بـ TypeScript، والحصول على إعادة تحميل فورية، مع إبقاء واجهة تطبيق macOS متصلة.
### 0) (اختياري) شغّل تطبيق macOS من المصدر أيضًا
إذا كنت تريد أيضًا أن يكون تطبيق macOS على أحدث نسخة:
إذا كنت تريد أيضًا أن يكون تطبيق macOS على أحدث إصدار:
```bash
./scripts/restart-mac.sh
@ -98,82 +98,88 @@ openclaw health
```bash
pnpm install
# التشغيل الأول فقط (أو بعد إعادة تعيين إعدادات/مساحة عمل OpenClaw المحلية)
pnpm openclaw setup
pnpm gateway:watch
```
يقوم `gateway:watch` بتشغيل gateway في وضع المراقبة ويعيد التحميل عند تغييرات المصدر،
والتهيئة، وبيانات تعريف plugin المجمّعة ذات الصلة.
يشغّل `gateway:watch` البوابة في وضع المراقبة ويعيد تحميلها عند تغيّر المصدر ذي الصلة،
أو الإعدادات، أو بيانات Plugin المضمّنة.
وتُعد `pnpm openclaw setup` خطوة تهيئة محلية تُنفَّذ مرة واحدة لإعداد الإعدادات/مساحة العمل في نسخة checkout جديدة.
ولا يعيد `pnpm gateway:watch` بناء `dist/control-ui`، لذا أعد تشغيل `pnpm ui:build` بعد تغييرات `ui/` أو استخدم `pnpm ui:dev` أثناء تطوير Control UI.
إذا كنت تستخدم عمدًا مسار عمل Bun، فالأوامر المكافئة هي:
إذا كنت تستخدم عمدًا سير عمل Bun، فالأوامر المكافئة هي:
```bash
bun install
# التشغيل الأول فقط (أو بعد إعادة تعيين إعدادات/مساحة عمل OpenClaw المحلية)
bun run openclaw setup
bun run gateway:watch
```
### 2) وجّه تطبيق macOS إلى Gateway الذي تشغّله
### 2) وجّه تطبيق macOS إلى Gateway الذي تعمل عليه
في **OpenClaw.app**:
- وضع الاتصال: **Local**
سيتصل التطبيق بالـ gateway الجاري تشغيله على المنفذ المهيأ.
سيتصل التطبيق بالبوابة العاملة على المنفذ المُعَد.
### 3) تحقّق
- يجب أن تعرض حالة Gateway داخل التطبيق: **“Using existing gateway …”**
- يجب أن تظهر حالة Gateway داخل التطبيق على أنها **«استخدام بوابة موجودة …»**
- أو عبر CLI:
```bash
openclaw health
```
### الأخطاء الشائعة
### أخطاء شائعة
- **منفذ خاطئ:** يستخدم Gateway WS افتراضيًا `ws://127.0.0.1:18789`؛ حافظ على التطبيق وCLI على المنفذ نفسه.
- **مكان تخزين الحالة:**
- حالة القناة/الموفر: `~/.openclaw/credentials/`
- ملفات تعريف مصادقة النموذج: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
- **منفذ خاطئ:** يستخدم Gateway WS افتراضيًا `ws://127.0.0.1:18789`؛ احرص على أن يستخدم التطبيق وCLI المنفذ نفسه.
- **مكان وجود الحالة:**
- حالة القنوات/المزوّدين: `~/.openclaw/credentials/`
- ملفات تعريف مصادقة النماذج: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
- الجلسات: `~/.openclaw/agents/<agentId>/sessions/`
- السجلات: `/tmp/openclaw/`
## خريطة تخزين بيانات الاعتماد
استخدم هذا عند تصحيح أخطاء المصادقة أو عند تحديد ما يجب نسخه احتياطيًا:
استخدم هذا عند تصحيح أخطاء المصادقة أو عند تقرير ما ينبغي نسخه احتياطيًا:
- **WhatsApp**: `~/.openclaw/credentials/whatsapp/<accountId>/creds.json`
- **رمز bot الخاص بـ Telegram**: التهيئة/البيئة أو `channels.telegram.tokenFile` (ملف عادي فقط؛ الروابط الرمزية مرفوضة)
- **رمز bot الخاص بـ Discord**: التهيئة/البيئة أو SecretRef (موفرو env/file/exec)
- **رموز Slack**: التهيئة/البيئة (`channels.slack.*`)
- **قوائم السماح للإقران**:
- **WhatsApp**: `~/.openclaw/credentials/whatsapp/<accountId>/creds.json`
- **رمز bot الخاص بـ Telegram**: الإعدادات/المتغيرات البيئية أو `channels.telegram.tokenFile` (ملف عادي فقط؛ تُرفَض الروابط الرمزية)
- **رمز bot الخاص بـ Discord**: الإعدادات/المتغيرات البيئية أو SecretRef (موفرو env/file/exec)
- **رموز Slack**: الإعدادات/المتغيرات البيئية (`channels.slack.*`)
- **قوائم السماح بالاقتران**:
- `~/.openclaw/credentials/<channel>-allowFrom.json` (الحساب الافتراضي)
- `~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json` (للحسابات غير الافتراضية)
- **ملفات تعريف مصادقة النموذج**: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
- **حمولة الأسرار المعتمدة على الملفات (اختياري)**: `~/.openclaw/secrets.json`
- `~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json` (الحسابات غير الافتراضية)
- **ملفات تعريف مصادقة النماذج**: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
- **حمولة الأسرار المخزنة في ملف (اختياري)**: `~/.openclaw/secrets.json`
- **استيراد OAuth القديم**: `~/.openclaw/credentials/oauth.json`
مزيد من التفاصيل: [الأمان](/ar/gateway/security#credential-storage-map).
## التحديث (من دون إفساد إعدادك)
- احتفظ بـ `~/.openclaw/workspace` و`~/.openclaw/` باعتبارهما "أغراضك الخاصة"؛ لا تضع الموجّهات/التهيئة الشخصية داخل مستودع `openclaw`.
- تحديث المصدر: `git pull` + خطوة تثبيت مدير الحزم الذي اخترته (`pnpm install` افتراضيًا؛ `bun install` لمسار عمل Bun) + الاستمرار في استخدام أمر `gateway:watch` المطابق.
- احتفظ بـ `~/.openclaw/workspace` و`~/.openclaw/` باعتبارهما «أشياءك الخاصة»؛ لا تضع prompts أو إعداداتك الشخصية داخل مستودع `openclaw`.
- لتحديث المصدر: `git pull` + خطوة تثبيت مدير الحزم التي اخترتها (`pnpm install` افتراضيًا؛ أو `bun install` لسير عمل Bun) + واصل استخدام أمر `gateway:watch` المطابق.
## Linux (خدمة مستخدم systemd)
## Linux (خدمة systemd للمستخدم)
تستخدم تثبيتات Linux خدمة مستخدم **systemd**. بشكل افتراضي، يوقف systemd خدمات المستخدم
عند تسجيل الخروج/الخمول، مما يؤدي إلى إيقاف Gateway. يحاول الإعداد الأولي تمكين
الاستمرار نيابةً عنك (وقد يطلب sudo). إذا ظل معطّلًا، فشغّل:
تستخدم عمليات التثبيت على Linux خدمة systemd **للمستخدم**. افتراضيًا، يوقف systemd
خدمات المستخدم عند تسجيل الخروج/الخمول، مما يؤدي إلى إيقاف Gateway. تحاول
التهيئة الأولية تفعيل خاصية الاستمرار لك (وقد تطلب sudo). إذا كانت لا تزال معطلة، فشغّل:
```bash
sudo loginctl enable-linger $USER
```
بالنسبة للخوادم الدائمة التشغيل أو متعددة المستخدمين، فكر في استخدام خدمة **system** بدلًا من
خدمة مستخدم (ولا حاجة إلى الاستمرار). راجع [دليل تشغيل Gateway](/ar/gateway) لملاحظات systemd.
بالنسبة إلى الخوادم التي تعمل دائمًا أو متعددة المستخدمين، فكّر في استخدام خدمة **نظام**
بدلًا من خدمة مستخدم (ولا حاجة عندها إلى خاصية الاستمرار). راجع [دليل تشغيل Gateway](/ar/gateway) للاطلاع على ملاحظات systemd.
## مستندات ذات صلة
- [دليل تشغيل Gateway](/ar/gateway) (العلامات، والإشراف، والمنافذ)
- [تهيئة Gateway](/ar/gateway/configuration) (مخطط التهيئة + أمثلة)
- [Discord](/ar/channels/discord) و[Telegram](/ar/channels/telegram) (علامات الرد + إعدادات replyToMode)
- [إعداد مساعد OpenClaw](/start/openclaw)
- [تطبيق macOS](/ar/platforms/macos) (دورة حياة gateway)
- [دليل تشغيل Gateway](/ar/gateway) (الخيارات، والإشراف، والمنافذ)
- [إعدادات Gateway](/ar/gateway/configuration) (مخطط الإعدادات + أمثلة)
- [Discord](/ar/channels/discord) و[Telegram](/ar/channels/telegram) (وسوم الرد + إعدادات replyToMode)
- [إعداد مساعد OpenClaw](/ar/start/openclaw)
- [تطبيق macOS](/ar/platforms/macos) (دورة حياة البوابة)