Reference OS v8 5 دقائق قراءة ٣١ مايو ٢٠٢٦ informational: شرح عملي لتركيب واستخدام مشروع GitHub حديث لبناء وكيل AI دليل تركيب واستخدام OpenClaw Mini: بناء وكيل ذكاء اصطناعي عربي خطوة بخطوة ستتعلم…
🦞 OpenClaw 核心架构的极简复现，涵盖 sessionKey 会话域、队列串行、工具化记忆检索、按需上下文加载、可扩展技能与主动心跳唤醒机制
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
تعتقد أن مشاريع AI Agent على GitHub معقدة وتحتاج خبرة متقدمة؟ الحقيقة أن OpenClaw Mini صمم خصيصاً لتعلم الأساسيات، ويمكنك تشغيله في أقل من 10 دقائق.
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت مطوراً عربياً تبحث عن مشروع عملي لبناء وكيل ذكاء اصطناعي بذاكرة ونبض نشط، فـ OpenClaw Mini هو خيارك الأمثل. هذا المشروع مفتوح المصدر يقدم نسخة مبسطة من OpenClaw، مع تركيز على التعليم والفهم العميق لآليات عمل AI Agent. في هذا الدليل، سنأخذك خطوة بخطوة من التثبيت إلى التشغيل، مع أمثلة عملية تناسب السياق السعودي والخليجي.
لا تقلق إذا كنت مبتدئاً، فالخطوات واضحة ومباشرة، وكل ما تحتاجه هو جهاز كمبيوتر واتصال بالإنترنت. لنبدأ.
OpenClaw Mini هو مشروع مفتوح المصدر (رخصة MIT) يقدم نسخة مبسطة من OpenClaw، وهو إطار عمل لبناء وكلاء ذكاء اصطناعي. الهدف منه تعليم المطورين كيفية عمل AI Agent من الداخل، مع التركيز على أربعة محاور رئيسية: CLI (واجهة الأوامر)، Agent Loop (حلقة الوكيل)، Session (جلسات المستخدم)، Context (السياق)، وGateway (البوابة). المشروع مكتوب بلغة TypeScript ويستخدم pnpm كمدير حزم.
يناسب: المطورين العرب المبتدئين والمتوسطين الذين يريدون فهم آلية عمل AI Agent عملياً. أيضاً مناسب للمهتمين بتجربة أدوات AI مفتوحة المصدر دون الحاجة إلى GPU أو سيرفرات قوية.
لا يناسب: من يبحث عن حل جاهز للإنتاج أو وكيل متكامل بواجهة مستخدم رسومية. OpenClaw Mini مشروع تعليمي، وليس منتجاً تجارياً.
git clone git@github.com:voocel/openclaw-mini.gitcd openclaw-minipnpm installcp .env.example .envpnpm testpnpm devملف .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 مشروع تعليمي ممتاز، كود المصدر نظيف ومعلق بالعربية (في بعض الأجزاء). لكن لا تتوقع وكيلاً جاهزاً للإنتاج. استخدمه كمرجع تعليمي أو كنقطة بداية لمشروعك الخاص.
لا، المشروع يعتمد على API خارجي (OpenAI/Anthropic)، لذا لا حاجة لGPU. يكفي معالج عادي وذاكرة 4GB RAM.
تحتاج مفتاحاً واحداً على الأقل من OpenAI أو Anthropic. سجل في منصاتهم واحصل على المفتاح مجاناً (مع حد استخدام).
نعم، المشروع خفيف ويمكن تشغيله على VPS بسعة 1GB RAM. استخدم Node.js وpnpm.
OpenClaw Mini مشروع تعليمي مبسط، بينما CrewAI إطار عمل متكامل لتنسيق وكلاء متعددين. كلاهما مفتوح المصدر.
يدعم اللغة العربية طالما أن النموذج LLM المستخدم يدعمها (GPT-4o، Claude). يمكنك التحدث معه بالعربية.
أضف أداة جديدة في مجلد tools، ثم سجلها في agent. راجع مثال الأداة الموجودة في الكود.
آلية تسمح للوكيل بإرسال إشارات دورية للنظام، مما يمكنه من تنفيذ مهام مجدولة أو الاستجابة لأحداث خارجية.
لا، المشروع تعليمي وغير موصى به للإنتاج. استخدمه للتعلم أو كنموذج أولي.
OpenClaw Mini هو مشروع ممتاز لتعلم بناء AI Agent بذاكرة ونبض نشط. باتباع هذا الدليل، ستتمكن من تركيبه وتشغيله في دقائق. استخدم الأمثلة العملية لتجربة الوكيل في سياقات عربية، ولا تتردد في تعديل الكود وتوسيعه. تذكر أن الهدف هو التعلم، لذا استمتع بالتجربة.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ 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
الناتج: مجلد المشروع مع جميع التبعيات.
لماذا؟ تخزين مفاتيح 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.
إذا: إذا واجهت خطأ في التثبيت
إذن: راجع جدول الأخطاء الشائعة وحلولها.
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
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 هو مشروع ممتاز لتعلم بناء AI Agent بذاكرة ونبض نشط. باتباع هذا الدليل، ستتمكن من تركيبه وتشغيله في دقائق. استخدم الأمثلة العملية لتجربة الوكيل في سياقات عربية، ولا تتردد في تعديل الكود وتوسيعه. تذكر أن الهدف هو التعلم، لذا استمتع بالتجربة.
حتى يبقى المرجع صالحاً مع الوقت
FAQ
استمر في القراءة
