دليل تركيب واستخدام OpenClaw Mini: بناء وكيل ذكاء اصطناعي عربي خطوة بخطوة
🦞 OpenClaw 核心架构的极简复现，涵盖 sessionKey 会话域、队列串行、工具化记忆检索、按需上下文加载、可扩展技能与主动心跳唤醒机制
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو OpenClaw Mini؟
- من يحتاج هذا المشروع ومن لا؟
- المميزات الرئيسية
- المتطلبات الأساسية
- خطوات التركيب والتشغيل
- شرح ملف .env وتكوين مفاتيح API
- تشغيل الوكيل لأول مرة
- أخطاء شائعة وحلولها
- استخدامات عملية في السياق السعودي
- هل يستحق التجربة؟
- بدائل مشابهة
- الأسئلة الشائعة
قبل أن تطبق
الفكرة التي تمنع التسرع
تعتقد أن مشاريع AI Agent على GitHub معقدة وتحتاج خبرة متقدمة؟ الحقيقة أن OpenClaw Mini صمم خصيصاً لتعلم الأساسيات، ويمكنك تشغيله في أقل من 10 دقائق.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل لديك Node.js 18+ و pnpm مثبتين؟
- هل حصلت على مفتاح API من OpenAI أو Anthropic؟
- هل استنسخت المستودع ونفذت pnpm install بنجاح؟
- هل نسخت .env.example إلى .env وأضفت المفتاح؟
- هل جربت تشغيل pnpm test للتأكد من التثبيت؟
- هل تريد استخدام مزود معين (OpenAI/Anthropic) ونموذج محدد؟
- هل تواجه خطأ في الاتصال أو عدم وجود موديول؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت مطوراً عربياً تبحث عن مشروع عملي لبناء وكيل ذكاء اصطناعي بذاكرة ونبض نشط، فـ OpenClaw Mini هو خيارك الأمثل. هذا المشروع مفتوح المصدر يقدم نسخة مبسطة من OpenClaw، مع تركيز على التعليم والفهم العميق لآليات عمل AI Agent. في هذا الدليل، سنأخذك خطوة بخطوة من التثبيت إلى التشغيل، مع أمثلة عملية تناسب السياق السعودي والخليجي.
لا تقلق إذا كنت مبتدئاً، فالخطوات واضحة ومباشرة، وكل ما تحتاجه هو جهاز كمبيوتر واتصال بالإنترنت. لنبدأ.
ما هو OpenClaw Mini؟
OpenClaw Mini هو مشروع مفتوح المصدر (رخصة MIT) يقدم نسخة مبسطة من OpenClaw، وهو إطار عمل لبناء وكلاء ذكاء اصطناعي. الهدف منه تعليم المطورين كيفية عمل AI Agent من الداخل، مع التركيز على أربعة محاور رئيسية: CLI (واجهة الأوامر)، Agent Loop (حلقة الوكيل)، Session (جلسات المستخدم)، Context (السياق)، وGateway (البوابة). المشروع مكتوب بلغة TypeScript ويستخدم pnpm كمدير حزم.
من يحتاج هذا المشروع ومن لا؟
يناسب: المطورين العرب المبتدئين والمتوسطين الذين يريدون فهم آلية عمل AI Agent عملياً. أيضاً مناسب للمهتمين بتجربة أدوات AI مفتوحة المصدر دون الحاجة إلى GPU أو سيرفرات قوية.
لا يناسب: من يبحث عن حل جاهز للإنتاج أو وكيل متكامل بواجهة مستخدم رسومية. OpenClaw Mini مشروع تعليمي، وليس منتجاً تجارياً.
المميزات الرئيسية
- تصميم تعليمي مع شرح وافٍ في الكود المصدري.
- يدعم sessionKey لفصل جلسات المستخدمين.
- ذاكرة أداة (tool memory) لاسترجاع المعلومات السابقة.
- تحميل السياق حسب الحاجة (on-demand context loading) لتوفير الموارد.
- قابلية توسيع المهارات (skills) عبر إضافة أدوات جديدة.
- آلية نبض نشط (heartbeat) تسمح بالتفاعل الدوري.
- يدعم مزودي LLM متعددين: OpenAI وAnthropic.
المتطلبات الأساسية
- Node.js (إصدار 18 أو أحدث).
- pnpm (يمكن تثبيته عبر npm install -g pnpm).
- مفتاح API من OpenAI أو Anthropic (أو أي مزود متوافق).
- اتصال بالإنترنت لتحميل الحزم.
خطوات التركيب والتشغيل
- استنساخ المستودع:
git clone git@github.com:voocel/openclaw-mini.gitcd openclaw-mini - تثبيت الاعتماديات:
pnpm install - نسخ ملف البيئة:
cp .env.example .env - تعديل ملف .env: أضف مفتاح API الخاص بك (انظر القسم التالي).
- تشغيل الاختبارات:
pnpm test - تشغيل الوكيل:
pnpm dev
شرح ملف .env وتكوين مفاتيح API
ملف .env يحتوي على المتغيرات البيئية اللازمة لتشغيل المشروع. إليك نموذجاً مع تعليقات بالعربية:
# مفتاح API من Anthropic (Claude) - اختر واحداً على الأقل ANTHROPIC_API_KEY=sk-ant-xxxxx # مفتاح API من OpenAI (GPT) - بديل أو إضافي OPENAI_API_KEY=sk-xxxxx # (اختياري) رابط قاعدة URL مخصص للوكيل # BASE_URL=https://your-proxy.com/api/anthropic # (اختياري) تفعيل وضع التفكير (reasoning) - none, low, medium, high # REASONING=none
يمكنك الحصول على مفتاح OpenAI من platform.openai.com، ومفتاح Anthropic من console.anthropic.com.
تشغيل الوكيل لأول مرة
بعد تكوين .env، شغل الأمر التالي:
pnpm dev
إذا أردت استخدام مزود معين ونموذج محدد:
pnpm dev -- --provider openai --model gpt-4o pnpm dev -- --provider anthropic --model claude-3-5-sonnet-20241022
لتشغيل Gateway (واجهة HTTP):
pnpm gateway pnpm gateway:connect
أخطاء شائعة وحلولها
استخدامات عملية في السياق السعودي
مثال 1: تحليل بيانات مبيعات متجر صغير
قم بتزويد الوكيل بملف CSV لمبيعات متجرك، واسأله عن أفضل المنتجات مبيعاً أو توقعات المبيعات. الوكيل سيستخدم الذاكرة لتذكر الجلسات السابقة.
مثال 2: مساعد شخصي للإجابة عن أسئلة حول منتج
احمل قاعدة معرفية عن منتجك (مثلاً: مواصفات هاتف)، واسأل الوكيل أسئلة تقنية. الوكيل سيستخدم context loading لتحميل المعلومات ذات الصلة فقط.
مثال 3: دمج مع API محلي
أضف أداة (tool) تستدعي API طقس السعودية، واسأل الوكيل عن الطقس في الرياض. الوكيل سينفذ الأداة ويعيد النتيجة.
هل يستحق التجربة؟
نعم، إذا كنت تريد فهم كيفية عمل AI Agent من الداخل. OpenClaw Mini مشروع تعليمي ممتاز، كود المصدر نظيف ومعلق بالعربية (في بعض الأجزاء). لكن لا تتوقع وكيلاً جاهزاً للإنتاج. استخدمه كمرجع تعليمي أو كنقطة بداية لمشروعك الخاص.
بدائل مشابهة
الأسئلة الشائعة
هل أحتاج إلى GPU لتشغيل OpenClaw Mini؟
لا، المشروع يعتمد على API خارجي (OpenAI/Anthropic)، لذا لا حاجة لGPU. يكفي معالج عادي وذاكرة 4GB RAM.
ما هي مفاتيح API المطلوبة وكيف أحصل عليها؟
تحتاج مفتاحاً واحداً على الأقل من OpenAI أو Anthropic. سجل في منصاتهم واحصل على المفتاح مجاناً (مع حد استخدام).
هل يمكن تشغيل الوكيل على سيرفر رخيص مثل VPS؟
نعم، المشروع خفيف ويمكن تشغيله على VPS بسعة 1GB RAM. استخدم Node.js وpnpm.
ما الفرق بين OpenClaw Mini وCrewAI؟
OpenClaw Mini مشروع تعليمي مبسط، بينما CrewAI إطار عمل متكامل لتنسيق وكلاء متعددين. كلاهما مفتوح المصدر.
هل يدعم الوكيل اللغة العربية؟
يدعم اللغة العربية طالما أن النموذج LLM المستخدم يدعمها (GPT-4o، Claude). يمكنك التحدث معه بالعربية.
كيف أضيف مهارة (skill) جديدة للوكيل؟
أضف أداة جديدة في مجلد tools، ثم سجلها في agent. راجع مثال الأداة الموجودة في الكود.
ماذا يعني 'نبض نشط' (heartbeat)؟
آلية تسمح للوكيل بإرسال إشارات دورية للنظام، مما يمكنه من تنفيذ مهام مجدولة أو الاستجابة لأحداث خارجية.
هل المشروع مستقر للإنتاج؟
لا، المشروع تعليمي وغير موصى به للإنتاج. استخدمه للتعلم أو كنموذج أولي.
خاتمة
OpenClaw Mini هو مشروع ممتاز لتعلم بناء AI Agent بذاكرة ونبض نشط. باتباع هذا الدليل، ستتمكن من تركيبه وتشغيله في دقائق. استخدم الأمثلة العملية لتجربة الوكيل في سياقات عربية، ولا تتردد في تعديل الكود وتوسيعه. تذكر أن الهدف هو التعلم، لذا استمتع بالتجربة.
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
تثبيت المتطلبات الأساسية
لماذا؟ Node.js و pnpm ضروريان لتشغيل المشروع.
كيف؟ تأكد من تثبيت Node.js 18+، ثم شغل npm install -g pnpm.
الناتج: جهاز جاهز مع Node.js و pnpm.
استنساخ المستودع وتثبيت الاعتماديات
لماذا؟ تحميل الكود المصدري وتثبيت الحزم اللازمة.
كيف؟ git clone git@github.com:voocel/openclaw-mini.git && cd openclaw-mini && pnpm install
الناتج: مجلد المشروع مع جميع التبعيات.
إعداد ملف البيئة (.env)
لماذا؟ تخزين مفاتيح API بشكل آمن.
كيف؟ cp .env.example .env ثم افتح الملف وأضف مفتاح API (ANTHROPIC_API_KEY أو OPENAI_API_KEY).
الناتج: ملف .env بمفتاح API صالح.
تشغيل الاختبارات
لماذا؟ التحقق من أن التثبيت صحيح.
كيف؟ pnpm test
الناتج: جميع الاختبارات تمر بنجاح.
تشغيل الوكيل
لماذا؟ بدء التفاعل مع الوكيل.
كيف؟ pnpm dev (أو مع مزود محدد: pnpm dev -- --provider openai --model gpt-4o)
الناتج: الوكيل يعمل وينتظر الإدخال.
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
# مفتاح API من Anthropic (Claude) ANTHROPIC_API_KEY=sk-ant-xxxxx # مفتاح API من OpenAI (GPT) OPENAI_API_KEY=sk-xxxxx # (اختياري) رابط قاعدة URL مخصص # BASE_URL=https://your-proxy.com/api/anthropic # (اختياري) تفعيل وضع التفكير # REASONING=none
pnpm dev -- --provider anthropic --model claude-3-5-sonnet-20241022
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت مبتدئاً وتريد التعلم
إذن: اتبع الدليل خطوة بخطوة، واستخدم الأمثلة العملية.
إذا: إذا كنت تحتاج وكيلاً جاهزاً للإنتاج
إذن: ابحث عن بدائل مثل CrewAI أو AutoGPT.
إذا: إذا واجهت خطأ في التثبيت
إذن: راجع جدول الأخطاء الشائعة وحلولها.
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تثبيت المتطلبات واستنساخ المستودع
- اليوم 2: إعداد .env وتشغيل الاختبارات
- اليوم 3: تشغيل الوكيل وتجربة محادثة بسيطة
- اليوم 4: تجربة مثال تحليل بيانات مبيعات
- اليوم 5: تجربة مثال مساعد شخصي
- اليوم 6: تجربة دمج API محلي (مثل الطقس)
- اليوم 7: مراجعة الكود وتوثيق الملاحظات
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. OpenClaw Mini مشروع تعليمي برخصة MIT.
2. مكتوب بلغة TypeScript ويستخدم pnpm.
3. يدعم مزودي LLM: OpenAI وAnthropic.
4. لا يحتاج GPU، يعتمد على API خارجي.
5. يدعم sessionKey لفصل جلسات المستخدمين.
6. يدعم ذاكرة أداة (tool memory) واسترجاع السياق.
7. يمكن تشغيله على VPS بسعة 1GB RAM.
8. يدعم اللغة العربية عبر النماذج المدعومة.
9. آلية نبض نشط (heartbeat) للتفاعل الدوري.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
واجهة الأوامر النصية للتفاعل مع الوكيل.
حلقة الوكيل: دورة استقبال الإدخال، معالجته، وإرجاع الرد.
جلسة مستخدم تحافظ على السياق عبر المحادثات.
السياق: المعلومات التي يستخدمها الوكيل لفهم الطلب.
بوابة HTTP للتفاعل مع الوكيل عبر واجهة ويب.
ذاكرة الأداة: تخزين نتائج الأدوات لاستخدامها لاحقاً.
نبض نشط: إشارات دورية للوكيل لتنفيذ مهام مجدولة.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يظن أن AI Agent معقد ويحتاج خبرة متقدمة، إلى مطور قادر على تركيب وتشغيل وتخصيص وكيل AI بنفسه.
- يمكن ربط OpenClaw Mini مع Node-RED لإنشاء تطبيقات IoT ذكية.
- استخدامه كمساعد في تحليل بيانات SQL عبر أداة مخصصة.
- دمجه مع Zapier (عبر Gateway) لأتمتة المهام.
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
OpenClaw Mini هو مشروع ممتاز لتعلم بناء AI Agent بذاكرة ونبض نشط. باتباع هذا الدليل، ستتمكن من تركيبه وتشغيله في دقائق. استخدم الأمثلة العملية لتجربة الوكيل في سياقات عربية، ولا تتردد في تعديل الكود وتوسيعه. تذكر أن الهدف هو التعلم، لذا استمتع بالتجربة.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحديث روابط API إذا تغيرت عناوين المزودين.
- إضافة نماذج LLM جديدة مدعومة.
- تحديث جدول البدائل إذا ظهرت مشاريع جديدة.
- مراجعة الأخطاء الشائعة بناءً على تعليقات المستخدمين.
- إضافة أمثلة عملية جديدة تناسب السياق الخليجي.
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇