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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
متطلبات النظام

  • Node 24 (موصى به) أو Node 22.16+ - يتولى نص التثبيت البرمجي ذلك تلقائيا
  • macOS أو Linux أو Windows - يدعم كل من Windows الأصلي و WSL2؛ و WSL2 أكثر استقرارا. راجع Windows.
  • لا تحتاج إلى pnpm إلا إذا كنت تبني من المصدر

​
موصى به: نص التثبيت البرمجي

أسرع طريقة للتثبيت. يكتشف نظام التشغيل لديك، ويثبت Node عند الحاجة، ويثبت OpenClaw، ويشغل الإعداد الأولي. 
curl -fsSL https://openclaw.ai/install.sh | bash
للتثبيت من دون تشغيل الإعداد الأولي: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
لجميع العلامات وخيارات CI/الأتمتة، راجع تفاصيل المثبت الداخلية.

​
طرق التثبيت البديلة

​
مثبت البادئة المحلية (install-cli.sh)

استخدم هذا عندما تريد إبقاء OpenClaw و Node ضمن بادئة محلية مثل ~/.openclaw، من دون الاعتماد على تثبيت Node على مستوى النظام: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
يدعم تثبيتات npm افتراضيا، إضافة إلى تثبيتات السحب من git ضمن تدفق البادئة نفسه. المرجع الكامل: تفاصيل المثبت الداخلية. مثبت بالفعل؟ بدّل بين تثبيتات الحزمة و git باستخدام openclaw update --channel dev و openclaw update --channel stable. راجع التحديث.

​
npm أو pnpm أو bun

إذا كنت تدير Node بنفسك بالفعل: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
إذا فشل sharp بسبب libvips مثبت عالميا:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
من المصدر

للمساهمين أو أي شخص يريد التشغيل من نسخة محلية: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
أو تجاوز الربط واستخدم pnpm openclaw ... من داخل المستودع. راجع الإعداد لتدفقات عمل التطوير الكاملة.

​
التثبيت من GitHub main

npm install -g github:openclaw/openclaw#main

​
الحاويات ومديرو الحزم

Docker

عمليات نشر ضمن حاويات أو بلا واجهة رسومية.

Podman

بديل حاويات بلا صلاحيات جذرية لـ Docker.

Nix

تثبيت تصريحي عبر Nix flake.

Ansible

توفير آلي لأسطول الأجهزة.

Bun

استخدام CLI فقط عبر وقت تشغيل Bun.

​
التحقق من التثبيت

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
إذا كنت تريد بدءا مداريا بعد التثبيت:
  • macOS: LaunchAgent عبر openclaw onboard --install-daemon أو openclaw gateway install
  • Linux/WSL2: خدمة systemd للمستخدم عبر الأوامر نفسها
  • Windows الأصلي: Scheduled Task أولا، مع عنصر تسجيل دخول في مجلد Startup لكل مستخدم كخيار احتياطي إذا رفض إنشاء المهمة

​
الاستضافة والنشر

انشر OpenClaw على خادم سحابي أو VPS:

VPS

أي VPS يعمل بنظام Linux

Docker VM

خطوات Docker المشتركة

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
التحديث أو الترحيل أو إلغاء التثبيت

Updating

حافظ على OpenClaw محدثا.

Migrating

الانتقال إلى جهاز جديد.

Uninstall

أزل OpenClaw بالكامل.

​
استكشاف الأخطاء وإصلاحها: لم يتم العثور على openclaw

إذا نجح التثبيت لكن لم يتم العثور على openclaw في الطرفية لديك: 
node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
إذا لم يكن $(npm prefix -g)/bin ضمن $PATH لديك، فأضفه إلى ملف بدء تشغيل الصدفة (~/.zshrc أو ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
ثم افتح طرفية جديدة. راجع إعداد Node لمزيد من التفاصيل.