خيارات التثبيت والنشر

وكيلك لا يكون مفيداً إلا بقدر جودة البيئة التي يعمل فيها. الإعداد الخاطئ يعني رسائل مفقودة وعمليات متعطلة ووكيلاً ينسى كل شيء عندما ينام حاسوبك المحمول. الحصول على الأساس الصحيح هو ما يفصل بين عرض توضيحي بسيط ونظام إنتاجي حقيقي.

أين تشغّل وكيلك

لديك خياران رئيسيان لاستضافة وكيلك: جهازك المحلي أو خادم VPS (خادم افتراضي خاص) عن بُعد.

العامل	الجهاز المحلي	VPS
التكلفة	مجاني (عتاد تملكه بالفعل)	رسوم شهرية (تختلف حسب المزود)
وقت التشغيل	محدود بوقت تشغيل جهازك	متاح على مدار الساعة
زمن الاستجابة	سريع للأدوات المحلية، أبطأ لواجهات API البعيدة	ثابت، قريب من خوادم API
الخصوصية	البيانات تبقى على عتادك	البيانات على بنية المزود التحتية
تعقيد الإعداد	بسيط	يتطلب معرفة بـ SSH وإدارة الخوادم
الأفضل لـ	التطوير والاختبار	الإنتاج، الوكلاء الذين يعملون دائماً

للتعلم والتطوير، ابدأ على جهازك المحلي. عندما تكون مستعداً للعمل المستمر، انتقل إلى VPS. كثير من الممارسين يشغّلون كليهما — محلي للتطوير، VPS للإنتاج.

المتطلبات الأساسية

قبل تثبيت OpenClaw، تأكد من توفر هذه الأدوات:

على macOS:

# تثبيت Homebrew (مدير حزم macOS)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# تثبيت Node.js (بيئة التشغيل المطلوبة)
brew install node

# التحقق من التثبيت
node --version
npm --version

على Ubuntu/Debian (VPS):

# تحديث قوائم الحزم
sudo apt update

# تثبيت Node.js عبر NodeSource
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# التحقق من التثبيت
node --version
npm --version

بمجرد تثبيت Node.js، ثبّت OpenClaw بشكل عام:

npm install -g openclaw

التشغيل الأول والإعداد

بعد التثبيت، قم بتهيئة مساحة عمل وكيلك:

# إنشاء مجلد المشروع
mkdir my-agent && cd my-agent

# تهيئة إعدادات OpenClaw
openclaw init

يُنشئ هذا ملف إعدادات تحدد فيه هوية وكيلك ومزود النموذج والأدوات المتصلة. التشغيل الأول يرشدك عبر الإعدادات الأساسية — اسم وكيلك والغرض الرئيسي منه والنموذج المراد استخدامه.

خيارات النماذج

إحدى نقاط قوة OpenClaw هي مرونة النماذج. لديك ثلاثة مسارات لربط نموذج ذكاء اصطناعي:

1. نموذج الاشتراك (OpenClaw Max)

يقدم OpenClaw مستوى اشتراك يجمع الوصول إلى نماذج متعددة دون الحاجة لمفاتيح API منفصلة. هذا هو المسار الأبسط — تسجل، تصادق، والإطار يتولى توجيه النماذج.

المقايضة: مريح وتكلفة شهرية متوقعة، لكنك مقيد بالنماذج التي يشملها الاشتراك.

2. مفتاح API (أحضر مفتاحك الخاص)

يمكنك الاتصال مباشرة بمزودي النماذج مثل Anthropic أو OpenAI باستخدام مفاتيح API الخاصة بك:

# في إعدادات OpenClaw
model:
  provider: anthropic
  api_key: ${ANTHROPIC_API_KEY}
  default_model: claude-sonnet-4-20250514

# تعيين مفتاح API كمتغير بيئة
export ANTHROPIC_API_KEY="your-key-here"

المقايضة: التسعير حسب الاستخدام يمنحك تحكماً دقيقاً بالتكلفة ووصولاً لأحدث النماذج، لكن التكاليف قد تكون غير متوقعة مع الاستخدام الكثيف.

3. النماذج المحلية (عبر Ollama)

لأقصى خصوصية وتكلفة API صفرية، شغّل النماذج محلياً باستخدام Ollama:

# تثبيت Ollama
brew install ollama

# تنزيل نموذج
ollama pull llama3

# إعداد OpenClaw لاستخدام النموذج المحلي

model:
  provider: ollama
  endpoint: http://localhost:11434
  default_model: llama3

المقايضة: خصوصية كاملة وبدون تكاليف متكررة، لكن النماذج المحلية عموماً أقل قدرة من النماذج السحابية المتقدمة وتتطلب عتاداً كبيراً (GPU بذاكرة VRAM كافية).

نظام التصحيح بالشريك

تقنية قوية في تنسيق الوكلاء هي نظام التصحيح بالشريك — استخدام نموذج ثانوي للتحقق من مخرجات النموذج الأساسي قبل وصولها للعالم الحقيقي.

إليك كيف يعمل: النموذج الأساسي يُنتج رداً أو خطة عمل. قبل التنفيذ، نموذج ثانٍ يراجع المخرجات بحثاً عن الأخطاء أو الهلوسات أو انتهاكات السياسات. فقط إذا وافق المُراجع ينتقل الإجراء للتنفيذ.

# إعداد التصحيح بالشريك
models:
  primary:
    provider: anthropic
    model: claude-sonnet-4-20250514
  validator:
    provider: openai
    model: gpt-4o
    role: "مراجعة مخرجات النموذج الأساسي للتحقق من الدقة الواقعية والسلامة"

هذا قيّم بشكل خاص للإجراءات عالية المخاطر مثل إرسال البريد الإلكتروني أو نشر المحتوى أو تعديل الملفات. تكلفة استدعاء نموذج ثانٍ تافهة مقارنة بتكلفة إجراء مستقل خاطئ.

اعتبارات عملية

إدارة التكلفة: ابدأ بسقف ميزانية على مزود API الخاص بك. معظم المزودين يوفرون حدود استخدام وتنبيهات. للتطوير، النماذج المحلية مجانية. للإنتاج، تكاليف API تتراوح عادة من بضعة دولارات إلى عشرات الدولارات شهرياً حسب الحجم.

زمن الاستجابة: النماذج السحابية تضيف زمن استجابة شبكي (عادة أقل من ثانية لمعظم المزودين). النماذج المحلية تلغي زمن استجابة الشبكة لكن قد يكون استنتاجها أبطأ حسب عتادك. للتفاعلات الفورية (الدردشة، الصوت)، زمن الاستجابة مهم. للمهام الخلفية (صياغة البريد الإلكتروني، البحث)، أقل أهمية.

الخصوصية: إذا تعاملت مع بيانات حساسة، النماذج المحلية تبقي كل شيء على عتادك. النماذج المعتمدة على API ترسل البيانات لخوادم خارجية. راجع سياسات احتفاظ البيانات والتدريب لكل مزود قبل إرسال معلومات حساسة.

النقطة الرئيسية: خيار النشر — محلي أو VPS أو هجين — يعتمد على احتياجاتك المحددة لوقت التشغيل والخصوصية والتكلفة. ابدأ ببساطة بإعداد محلي ومزود نموذج واحد، ثم وسّع مع نمو متطلباتك.

التالي: ربط وكيلك بقنوات الاتصال — إعداد تيليجرام وديسكورد للتفاعل الفوري. :::