قاموس مصطلحات أوبن كلاو للمبتدئين: Skills وAgents وGateway وأكثر

Aفريق ArabClaw10 دقيقة قراءة

ما ستتعلمه: ستفهم المعنى الدقيق لأهم مصطلحات أوبن كلاو (OpenClaw) مثل Gateway وAgent وSkills وChannels وWorkspace، وكيف ترتبط ببعضها داخل نظام واحد. وستخرج بأوامر حقيقية تجعلك ترى كل مصطلح يعمل أمامك على جهازك.

فتحت التوثيق لأول مرة، فوجدت في الصفحة الأولى كلمات مثل Gateway وWorkspace وHeartbeat وPairing. أغلقت الصفحة وأنت تشعر أن الأداة مصممة للمهندسين وحدهم. هذا الشعور شائع جداً، وسببه ليس صعوبة الأداة، بل أن المصطلحات تُستخدم قبل أن تُشرح.

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

الصورة الكبيرة: أوبن كلاو في جملة واحدة

أوبن كلاو مساعد ذكاء اصطناعي شخصي مفتوح المصدر، يعمل على جهازك أو على خادمك الخاص، وتتحدث معه من تطبيقات المراسلة التي تستخدمها يومياً مثل تيليغرام وواتساب وديسكورد.

لفهم المصطلحات، تخيّل مكتباً صغيراً:

  • الـ Gateway هو المبنى نفسه، مفتوح دائماً، وكل شيء يمر عبره.
  • الـ Agent هو الموظف الذي يجلس في المكتب ويفكر ويقرر.
  • الـ Model هو عقل هذا الموظف، وتستأجره من مزود مثل Anthropic.
  • الـ Workspace هو مكتب الموظف ودفاتره وملفاته.
  • الـ Skills هي أدلة العمل التي تعلّمه مهام جديدة.
  • الـ Channels هي الهواتف وصناديق البريد التي يصله منها العملاء.

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

طبقة التشغيل: Gateway وDaemon وOnboarding

Gateway (البوابة)

الـ Gateway هو العملية المركزية في أوبن كلاو. هو برنامج يعمل في الخلفية ويستقبل الرسائل من كل القنوات، ثم يمررها إلى الوكيل، ثم يعيد الردود إلى القناة الصحيحة. يعمل محلياً على منفذ خاص به، وتتصل به الواجهات والتطبيقات المرافقة.

إذا توقف الـ Gateway توقف كل شيء: لا رسائل، ولا مهام مجدولة، ولا ردود. لذلك أول سؤال تسأله عند أي مشكلة هو: هل الـ Gateway يعمل؟

Daemon (الخدمة الدائمة)

الـ Daemon مصطلح من عالم أنظمة التشغيل، ويعني برنامجاً يعمل في الخلفية بشكل دائم، ويبدأ تلقائياً عند تشغيل الجهاز. في أوبن كلاو، تثبيت الـ Daemon يعني أن الـ Gateway سيعمل وحده بعد كل إعادة تشغيل، دون أن تفتح الطرفية وتشغله يدوياً. هذا ضروري إن كنت تريد مساعداً متاحاً على مدار الساعة، خصوصاً على خادم بعيد. لخطوات ذلك على خادم مستأجر راجع دليل تثبيت OpenClaw على VPS.

Onboarding (الإعداد الأولي)

هو المعالج التفاعلي الذي يرافقك في أول تشغيل. يسألك عن مزود النموذج ومفتاح الـ API، وعن القنوات التي تريد ربطها، ثم يكتب ملف الإعدادات نيابة عنك. للمبتدئ، هذا أسهل طريق من تعديل الملفات يدوياً.

Doctor (الطبيب)

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

طبقة العقل: Agent وModel وWorkspace وMemory

Agent (الوكيل)

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

Model وProvider (النموذج والمزود)

النموذج هو نموذج اللغة الذي يمنح الوكيل قدرته على الفهم والتفكير، والمزود هو الشركة التي تقدمه، مثل Anthropic. في الإعدادات يُكتب النموذج عادة بصيغة المزود/اسم-النموذج. اختيار النموذج يؤثر مباشرة في جودة الردود وسرعتها وتكلفتها، وقد خصصنا له دليلاً كاملاً بعنوان اختيار النموذج المناسب في أوبن كلاو.

Workspace (مساحة العمل)

مساحة العمل مجلد على جهازك يمثل بيت الوكيل. فيه ملفات نصية بصيغة Markdown تحدد هويته وسلوكه، منها:

  • AGENTS.md: تعليمات العمل العامة وقواعد السلوك.
  • SOUL.md: شخصية الوكيل ونبرته وحدوده.
  • USER.md: معلومات عنك تساعده على خدمتك بشكل أفضل.
  • TOOLS.md: ملاحظات حول الأدوات المتاحة وطريقة استخدامها.
  • HEARTBEAT.md: ما يفعله الوكيل في كل نبضة دورية.

الجميل هنا أن تخصيص الوكيل لا يحتاج برمجة. تعدّل ملفاً نصياً، فيتغير سلوكه.

Memory (الذاكرة)

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

Session (الجلسة)

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

طبقة القدرات: Tools وSkills وClawHub وSandbox

Tools (الأدوات)

الأدوات هي القدرات الأساسية المدمجة: تشغيل أوامر الطرفية، وقراءة الملفات وكتابتها، وتصفح الويب، وإرسال الرسائل. الأداة تجيب عن سؤال: ماذا يستطيع الوكيل أن يفعل؟

Skills (المهارات)

إذا كانت الأدوات هي اليدين، فالمهارات هي الخبرة. المهارة مجلد يحتوي ملفاً اسمه SKILL.md، فيه وصف قصير وتعليمات تشرح للوكيل كيف ينجز مهمة محددة، وقد يحتوي سكربتات مساعدة. مثلاً: مهارة لإدارة التقويم، أو مهارة لتلخيص البريد، أو مهارة للتعامل مع خدمة معينة.

الفكرة الذكية أن الوكيل لا يحمّل كل المهارات في ذهنه دائماً. يقرأ الوصف المختصر لكل مهارة، ولا يفتح التعليمات الكاملة إلا عند الحاجة. هذا يوفر في السياق ويجعل إضافة مهارات كثيرة أمراً عملياً.

ClawHub (سوق المهارات)

ClawHub هو السجل العام الذي يشارك فيه المجتمع مهاراته. تبحث فيه عن مهارة، وتثبتها بأمر واحد. نصيحة مهمة: المهارة قد تحتوي تعليمات وسكربتات تُنفَّذ على جهازك، فاقرأ محتواها قبل التثبيت، تماماً كما تفعل مع أي برنامج من مصدر خارجي.

Sandbox (البيئة المعزولة)

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

طبقة التواصل والاستقلالية: Channels وPairing وNodes وHeartbeat وCron

Channels (القنوات)

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

Pairing (الاقتران)

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

Nodes (العُقد)

العقدة جهاز مرافق يتصل بالـ Gateway ويمنح الوكيل قدرات إضافية، مثل تطبيق على الهاتف يتيح الوصول إلى الكاميرا أو الموقع أو الإشعارات. الـ Gateway هو العقل المركزي، والعقد أطراف تمتد إلى أجهزتك الأخرى.

Heartbeat (النبضة)

النبضة تنبيه دوري يوقظ الوكيل كل فترة ليتفقد ما يحتاج اهتماماً، وفق ما كتبته في ملف HEARTBEAT.md. بفضلها يصبح المساعد مبادراً: يذكّرك بموعد قريب، أو ينبهك إلى رسالة مهمة، بدلاً من أن ينتظر سؤالك دائماً.

Cron (المهام المجدولة)

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

جدول مختصر لأهم المصطلحات

المصطلحالمعنى المبسطأين تجدهلماذا يهمك
Gatewayالعملية المركزية التي يمر عبرها كل شيءخدمة تعمل في الخلفيةإن توقف، توقف المساعد كله
Daemonتشغيل تلقائي دائم للـ Gatewayخدمات النظاممساعد متاح دون تدخل يدوي
Agentالكيان الذي يفكر وينفذملف الإعدادات ومساحة العملهو من يرد عليك فعلياً
Modelعقل الوكيل اللغويملف الإعداداتيحدد الجودة والتكلفة
Workspaceبيت الوكيل وملفاتهمجلد داخل ~/.openclawتخصيص السلوك دون برمجة
Skillsأدلة تعلّم الوكيل مهام جديدةمجلد skillsتوسيع القدرات بسهولة
ClawHubسوق مهارات المجتمعالإنترنتمهارات جاهزة بأمر واحد
Channelsتطبيقات المراسلة المربوطةملف الإعداداتتتحدث معه من أي مكان
Pairingموافقة على المستخدمين الجددأوامر الطرفيةحماية بوتك من الغرباء
Heartbeatتفقد دوري تلقائيHEARTBEAT.mdمساعد مبادر لا منتظر

تطبيق عملي: شاهد المصطلحات وهي تعمل

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

الخطوة 1: التثبيت والإعداد الأولي (Onboarding وDaemon)

# تثبيت أوبن كلاو (يتطلب نسخة حديثة من Node.js)
npm install -g openclaw@latest

# تشغيل معالج الإعداد مع تثبيت الخدمة الدائمة
openclaw onboard --install-daemon

الخطوة 2: التحقق من الـ Gateway وتشخيص المشاكل

# هل البوابة تعمل؟
openclaw gateway status

# فحص شامل للإعدادات
openclaw doctor

الخطوة 3: ملف الإعدادات (Model وChannels)

الملف الرئيسي موجود في ~/.openclaw/openclaw.json. هذا مثال مبسط يحدد النموذج ويربط تيليغرام مع تفعيل الاقتران. شكل المفاتيح قد يختلف قليلاً بين الإصدارات، فاعتمد دائماً على ما يكتبه معالج الإعداد ثم عدّل عليه:

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-sonnet-5-5" }
    }
  },
  channels: {
    telegram: {
      botToken: "ضع_رمز_البوت_هنا",
      dmPolicy: "pairing"
    }
  }
}

الخطوة 4: الموافقة على الاقتران (Pairing)

أرسل رسالة إلى البوت من حسابك على تيليغرام، وستصلك رسالة فيها رمز. ثم:

# عرض طلبات الاقتران المعلقة
openclaw pairing list telegram

# الموافقة على الرمز
openclaw pairing approve telegram ABC123

الخطوة 5: إنشاء مهارة بسيطة (Skills)

أنشئ مجلداً داخل مجلد skills في مساحة العمل، وضع فيه ملف SKILL.md:

---
name: arabic-summary
description: يلخص أي نص طويل بالعربية في خمس نقاط واضحة
---

# تلخيص عربي

عندما يطلب المستخدم تلخيص نص:
1. اقرأ النص كاملاً.
2. استخرج خمس نقاط أساسية فقط.
3. اكتبها بالعربية الفصحى المبسطة.
4. أضف سطراً أخيراً بعنوان: الخلاصة.

ثم تحقق من أن الوكيل يراها، وجرّبه مباشرة من الطرفية:

openclaw skills list
openclaw agent --message "لخّص لي هذا النص: ..."

بهذه الخطوات الخمس لمست بيدك Onboarding وDaemon وGateway وModel وChannels وPairing وSkills وAgent.

أخطاء شائعة في فهم المصطلحات

  1. الخلط بين Tools وSkills: الأداة قدرة تقنية خام مثل تشغيل أمر. المهارة معرفة تشرح متى وكيف تُستخدم الأدوات لإنجاز مهمة. إضافة مهارة لا تمنح الوكيل صلاحيات جديدة بحد ذاتها.
  2. الظن أن Model هو Agent: النموذج عقل خام يمكن تبديله. الوكيل هو النموذج مضافاً إليه مساحة العمل والذاكرة والأدوات والمهارات. تغيير النموذج لا يمحو شخصية وكيلك.
  3. إهمال Pairing: إغلاق الاقتران لتسهيل التجربة قد يفتح بوتك لأي شخص. أبقه مفعلاً إلا إن كنت تعرف تماماً ما تفعل.
  4. الخلط بين Heartbeat وCron: النبضة للتفقد العام المرن، والـ Cron للمواعيد الدقيقة. استخدام النبضة لمهمة يجب أن تتم في دقيقة محددة سيخيب ظنك.
  5. تثبيت مهارات دون قراءتها: المهارة نص يوجّه وكيلاً يملك صلاحيات على جهازك. اقرأ قبل أن تثبت.

الأسئلة الشائعة

سؤال 1: هل أحتاج خبرة برمجية لاستخدام أوبن كلاو؟

الجواب: لا تحتاج خبرة برمجية عميقة، لكن الراحة مع الطرفية وتعديل الملفات النصية تساعدك كثيراً. معالج الإعداد يتولى الجزء الأصعب، وتخصيص الوكيل يتم عبر ملفات Markdown عادية.

سؤال 2: ما الفرق بين Skill وTool باختصار؟

الجواب: الأداة قدرة مدمجة مثل قراءة ملف أو تشغيل أمر أو تصفح صفحة. المهارة ملف تعليمات يشرح للوكيل كيف يجمع هذه الأدوات لإنجاز مهمة معينة بطريقة محددة.

سؤال 3: هل يجب أن يبقى جهازي يعمل طوال الوقت؟

الجواب: نعم إن أردت مساعداً متاحاً دائماً، لأن الـ Gateway يجب أن يعمل حتى يستقبل الرسائل. لهذا يفضل كثيرون تشغيله على خادم افتراضي صغير مع تثبيت الـ Daemon.

سؤال 4: هل بياناتي آمنة مع أوبن كلاو؟

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

سؤال 5: هل يمكنني استخدام أكثر من قناة في الوقت نفسه؟

الجواب: نعم، يمكنك ربط تيليغرام وواتساب وديسكورد وغيرها مع Gateway واحد. كل محادثة تحصل على جلسة منفصلة، لكن الوكيل ومساحة العمل والمهارات مشتركة بينها.

الخاتمة

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

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

جاهز لتجربة OpenClaw؟

ابدأ الآن مع دليل التثبيت الكامل بالعربية وابنِ أول وكيل ذكاء اصطناعي خاص بك.

دليل التثبيت

مقالات ذات صلة