Openclaw(Moltbot /Clawdbot) : دليل الإعداد+ برنامج تعليمي لاستضافة واجهة برمجة التطبيقات

يتصدر هذه المبادرة Moltbot (المعروف سابقًا باسم Clawdbot)، وهو مشروع انتقل من أداة مطوّرين متخصصة إلى ظاهرة منتشرة مع أكثر من 60,000 نجمة على GitHub خلال أسابيع قليلة. أنشأه Peter Steinberger، يمثّل Moltbot عملية “تبديل القشرة” للوكيل الذكي—التخلّي عن قيود واجهات الويب ليتواجد داخل تطبيقات المراسلة وأنظمة الملفات التي نستخدمها يوميًا.

اهتمام حديث: أعاد المشروع تسمية نفسه من Clawdbot إلى Moltbot بعد طلب متعلق بالعلامة التجارية من Anthropic، إذ طُلب ذلك لأن "Clawd" بدا قريبًا جدًا من "Claude."

ما هو Moltbot (Clawdbot) ولماذا أصبح رائجًا؟

Moltbot هو وكيل ذكاء اصطناعي مفتوح المصدر وذاتي الاستضافة صُمّم لردم الفجوة بين النماذج اللغوية الكبيرة (LLMs) القوية وحاسوبك المحلي. بخلاف ChatGPT أو Claude.ai، اللذين يعملان داخل علامة تبويب متصفح ضمن “حديقة مسوّرة”، يعمل Moltbot كـ بوابة على عتادك (Mac، Linux، أو VPS).

يحوّل الرسائل باللغة الطبيعية من منصات مثل Telegram وWhatsApp وSlack إلى إجراءات قابلة للتنفيذ على جهازك. سواء احتجت للعثور على ملف على سطح مكتبك وأنت في متجر البقالة أو تشغيل برنامج نشر معقّد من هاتفك، يعمل Moltbot كوكيلك الرقمي مع وصول كامل إلى النظام.

لماذا يختلف عن غيره

• تنفيذ محلي أولاً والأدوات: Moltbot يمكنه فعليًا تشغيل الأوامر على المضيف (بموافقة)، استدعاء واجهات APIs خارجية، واستخدام “Skills” وهي برامج صغيرة أو سير عمل معرّفة عبر Markdown.
• متعدد القنوات: تستخدم المساعد نفسه عبر Telegram وWhatsApp وSlack وDiscord وغيرها — ويمكنه مراسلتك استباقيًا.
• الذاكرة والاستمرارية: يخزّن Moltbot ملفات الذاكرة في مساحة العمل (Markdown) ويُفهرسها للاسترجاع بحيث “يتذكر” المساعد عبر الجلسات (تفاصيل أدناه).

القدرات الأساسية بنظرة سريعة

كيف يتذكّر Clawdbot كل شيء بدون قاعدة بيانات؟

أحد أكثر جوانب Moltbot ابتكارًا هو بنية الذاكرة الشفافة. تعاني معظم أدوات الذكاء الاصطناعي من “فقدان الذاكرة” بين الجلسات. يعالج Moltbot ذلك عبر نظام متعدّد الطبقات من ملفات Markdown البسيطة داخل مساحة عملك. يضمن هذا النهج أن تتمكّن من قراءة ما يعرفه الذكاء الاصطناعي عنك وتعديله وتدقيقه بدقة.

ما تصميم الذاكرة وكيف يعمل؟

ذاكرة Moltbot مقصودة البساطة وقابلة للتدقيق: الذاكرة عبارة عن ملفات Markdown بسيطة داخل مساحة عمل الوكيل. الملفات هي مصدر الحقيقة — النموذج “يتذكّر” فقط ما كُتب إلى القرص. يستخدم التخطيط الافتراضي:

• memory/YYYY-MM-DD.md — سجلات يومية تُضاف فقط (يقرأ المساعد اليوم + الأمس عند بدء الجلسة).
• MEMORY.md — ذاكرة طويلة الأجل منسّقة يمكنك التحكّم بها وتُحمّل فقط في الجلسات الخاصة.

يوفر هذا التصميم فائدتين كبيرتين:

1. قابلية التدقيق — يمكنك قراءة وتعديل ما سيستخدمه المساعد كذاكرة.
2. بساطة الأدوات — تقدّم مكوّنات الذاكرة فهرسة متجهية/BM25 لتمكين الوكيل من البحث سريعًا عن إدخالات ذاكرة ذات صلة.

النهج التقني

• مخزن المحادثة/الجلسة: يتعقّب الـ gateway الجلسات وينقل السياق الصحيح إلى بيئة تشغيل الوكيل. يتيح ذلك للوكيل الحفاظ على حالة المحادثة عبر الرسائل والقنوات.
• بيانات محلية مفهرسة: يمكن لـ Moltbot فهرسة الملفات والمستندات المحلية وكشفها عبر أدوات بحث (دلالية أو بالكلمات المفتاحية) للاسترجاع. بهذه الطريقة يمكن للوكيل "تذكّر" ملاحظات اجتماعك أو القصاصات أو الشيفرة.
• مخرجات الأدوات وبديهيات الذاكرة: يمكن للمهارات والأدوات الكتابة إلى مخزن دائم (قاعدة بيانات أو نظام ملفات)، ويمكن لـ Moltbot الرجوع إلى تلك الإدخالات في المطالبات اللاحقة. تستخدم العديد من النشرات SQLite أو Postgres أو JSON/YAML محليًا للإعدادات الصغيرة.
• تضمينات LLM ومستودع المتجهات: للاستدعاء الدلالي يكون النمط المعتاد هو تضمين المستندات وتخزين المتجهات في قاعدة متجهات، ثم استرجاع أقرب الجيران لإدراجهم في المطالبات. تتوافق بنية Moltbot مع استدعاءات أدوات مستقلّة عن النموذج، لذا يمكنك توصيل مجموعة التضمين + مستودع المتجهات الخاص بك.

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

تسلسل الذاكرة الهرمي

عندما تقول لـ Moltbot، "تذكّر أنني أحب تقاريري بصيغة PDF"، فإنه لا يخزّن ذلك في قاعدة بيانات SQL مخفية. إنه حرفيًا يفتح USER.md ويضيف نقطة جديدة. يسمح هذا للوكيل بالحفاظ على السياق عبر أسابيع من المحادثة، ما يجعله أشبه بمساعد شخصي حقيقي بدلاً من نسخة جديدة كل صباح.

---

دليل إعداد Moltbot: المتطلبات الأساسية والتثبيت

فيما يلي قائمة فحص عملية وأوامر للحصول على مثيل Moltbot أساسي يعمل على macOS/Linux (Ubuntu). هذا دليل مختصر موجّه للإنتاج — إذا كنت بحاجة إلى واجهة رسومية أو استضافة مُدارة، انتقل إلى قسم استضافة API.

ما الذي ستحتاجه (المتطلبات الأساسية)

• جهاز يعمل بنظام macOS أو Linux (يمكن لـ Windows العمل عبر WSL2). يتطلب Node.js v22+ للبوابة وCLI.
• محرّر نصوص ومعرفة أساسية بـ shell.
• مفتاح API واحد على الأقل لـ LLM (OpenAI أو Anthropic أو Venice أو نموذج محلي مثل Ollama) — Moltbot نفسه مستقل عن النموذج.
• اختياري: Docker إذا كنت تفضّل النشر بالحاويات.

التثبيت خطوة بخطوة

1. ثبّت الحزمة: نفّذ الأمر التالي في الطرفية: npm install -g clawdbot@latest
2. أطلق مُعالج الإعداد: المُعالج هو قلب الإعداد. سيرشدك عبر تأكيدات الأمان واختيار النموذج. clawdbot onboard --install-daemon
3. أكّد المخاطر الأمنية: سيطلب Moltbot منك الإقرار بأن لديه وصولًا يشبه "الجذر" إلى جهازك. يجب أن تكتب تأكيدًا للمتابعة.
4. اضبط البوابة: سيُثبّت المُعالج clawdbot gateway كخدمة خلفية (launchd على Mac أو systemd على Linux) ليظل متصلًا على مدار الساعة.

تثبيت سريع (macOS / Linux)

هذا المثال يستخدم أسلوب git + npm المُوصى به والذي يعكس الوثائق الرسمية.

# Clone and enter repo
git clone https://github.com/moltbot/moltbot.git
cd moltbot

# Install via npm (global CLI) or run locally
npm install -g @moltbot/cli   # or: npm ci && npm run build

# Create environment file from example
cp .env.example .env

# Edit .env and add your API keys (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.)
# Then run onboarding
moltbot onboard --install-daemon
moltbot start

Docker (أساسي)

# docker-compose.yml (simplified)
version: "3.8"
services:
  moltbot:
    image: moltbot/moltbot:latest
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - OTHER_KEYS=...
    volumes:
      - ./data:/app/data
    ports:
      - "3000:3000"

شغّل باستخدام:

docker compose up -d

ما بعد التثبيت: إقران قناة مراسلة

يدعم Moltbot قنوات متعددة. عادة يتضمن الإقران توليد رمز إقران من واجهة البوابة أو CLI واستخدام "رابط إقران" صغير لربط بوت Telegram أو حساب WhatsApp — تعتمد الخطوات المحددة على موصل القناة الذي تختاره (Telegram Bot API مقابل grammY wrapper، WhatsApp عبر Baileys، إلخ). راجع الوثائق لـ moltbot connect telegram أو moltbot connect whatsapp.

كيف أتحكّم بحاسوبي عبر Telegram بواسطة Moltbot (خطوة بخطوة)؟

فيما يلي إرشاد عملي وآمن للتحكم بالمضيف عبر رسائل Telegram — مفيد للإدارة عن بعد، تشغيل سكربتات، جلب السجلات، أو طلب Moltbot تشغيل مهمة صغيرة. ملاحظة أمنية مهمة: لا تقم أبدًا بفضح الـ Gateway للإنترنت المفتوح دون رمز API وجدار ناري؛ اسمح فقط لمستخدمي Telegram الموثوقين بالتواصل مع بوتك.

1) أنشئ بوت Telegram عبر BotFather

1. في Telegram، أرسل رسالة إلى @BotFather.
2. أرسل /newbot واتّبع التعليمات.
3. انسخ رمز البوت 123456789:ABC-... (سيعرضه BotFather).

2) أضف الرمز إلى بوابتك

اضبط متغيّر البيئة أو الإعداد:

export TELEGRAM_BOT_TOKEN="123456789:ABC-..."
# or add to your gateway's config file:
# channels:
#   telegram:
#     botToken: "123456789:ABC-..."

يمكنك أيضًا إضافة الرمز عبر أوامر moltbot channels add أو moltbot configure بحسب إصدار CLI لديك. تعرض وثائق Telegram مسار الإعداد السريع هذا.

3) شغّل مُعالج الإعداد واختر Telegram

شغّل:

moltbot onboard --install-daemon

أثناء المُعالج:

• اختر مزوّد النموذج (Anthropic Opus أو OpenAI أو محلي).
• عند الطلب الخاص بالقنوات، اختر Telegram والصق الرمز.
• اضبط الإقران/قائمة السماح لتقييد من يمكنه مراسلة البوت (مهم — عيّن معرّف المستخدم الخاص بك بحيث تتمكّن وحدك من التحكم به).

ستطلبك أدلة المجتمع وعملية الإعداد لصق مخرجات أمر صغير من مضيفك لإثبات إقران العقدة — اتّبع التعليمات.

4) فعّل أداة exec وآليات الموافقة (بأمان)

يمكن لـ Moltbot تشغيل أوامر النظام عبر أداة exec، لكنه يفعل ذلك ضمن نموذج موافقة صريح:

• تُسجَّل الموافقات على exec في ~/.clawdbot/exec-approvals.json.
• سيطلب النظام تأكيدًا في الدردشة لأول مرة يُطلب فيها إجراء ما؛ يمكنك الرد بـ /approve للمتابعة (أو الرفض).
• للمهام المؤتمتة بالكامل يمكنك إنشاء قائمة سماح محدودة للأوامر أو "مجلد" سكربتات مُعتمدة مسبقًا.

مثال: فعّل أداة exec في إعدادات moltbot (أو عبر واجهة/ملحق):

{
  "tools": {
    "exec": {
      "enabled": true,
      "allowlist": ["/usr/local/bin/backup.sh", "/usr/bin/uptime"]
    }
  }
}

لدى المشروع تدفقات موافقة exec صريحة ويُحوّل مطالبات الموافقة إلى قنوات الدردشة عند الطلب، ما يسهّل مراجعة العمليات والموافقة عليها.

5) جرّب أمرًا آمنًا من Telegram

من حساب Telegram الخاص بك (المستخدم المسموح):

@YourMoltbot Hi — please run: uptime

سيفعل المساعد:

1. الطلب للتأكيد (إذا كانت exec تتطلب موافقة).
2. تشغيل الأمر المسموح على المضيف.
3. إعادة المخرجات إلى الدردشة.

6) أنشئ إجراءات أكثر أمانًا عبر skills

بدلاً من منح وصول مباشر إلى shell عبر الدردشة، يُفضَّل مهارات تُغلف الإجراءات (مثل مهارة backup التي تستدعي سكربت وتُعيد نتيجة مُنسّقة). يمكن تثبيت/إلغاء تثبيت المهارات وهي أسهل للمراجعة.

كيف أستضيف واجهة Moltbot (Gateway) وأستخدم واجهة HTTP API؟

هل يمكن لـ Moltbot خدمة واجهة API يمكن لبرامج أخرى استدعاؤها؟

نعم. يمكن لبوابة Moltbot كشف نقاط نهاية HTTP متوافقة مع OpenResponses (مثل POST /v1/responses) وطبقة توافق بأسلوب OpenAI على /v1/chat/completions. تكون هذه النقاط معطّلة افتراضيًا ويجب تمكينها في إعدادات البوابة. تُطابق نقطة نهاية HTTP الخاصة بـ OpenResponses مباشرة مسار تشغيل الوكيل في البوابة، لذا تُنفَّذ الطلبات كجلسات وكيل حقيقية (مع نفس التوجيه/الأذونات).

ما هو وكيل API Proxy في Moltbot؟

الـ API proxy في Moltbot هو خدمة وسيطة تقع بين بيئة تشغيل الوكيل ومزوّدي LLM في الأعلى مثل:

• OpenAI
• Anthropic
• Venice
• Azure OpenAI
• نقاط نهاية متوافقة مع OpenAI ذاتية الاستضافة

بدلاً من أن يستدعي Moltbot المزوّد مباشرة، تُوجَّه كل الطلبات عبر الوكيل، والذي يمكن أن:

• يعيد كتابة الطلبات والاستجابات
• يفرض حدود المعدّل
• يتعقّب استخدام الرموز والتكاليف
• يبدّل النماذج ديناميكيًا
• يخفي مفاتيح API الحقيقية عن Moltbot
• يضيف المصادقة والتسجيل والتخزين المؤقت

مفهومياً:

Moltbot → API Proxy → LLM Provider

تحسّن هذه البنية بشكل كبير الأمان وقابلية الملاحظة والتحكم في التكلفة.

🚀 بداية سريعة: نوصي باستخدام CometAPI (apiyi.com) للحصول على مفتاح API. يمنحك التسجيل أرصدة مجانية. يدعم جميع الخوارزميات الرئيسية مثل Claude Sonnet 4.5 وClaude Opus 4.5 وGPT-5.2، وعادة ما يكون أرخص بنسبة 10–20% من الأسعار الرسمية.

الخطوة 1: احصل على مفتاح وكيل API

الطريقة 1: ضبط متغيّرات البيئة. في ملف .env الخاص بـ Moltbot:

OPENAI_API_BASE=https://cometapi.com/v1
OPENAI_API_KEY=moltbot-internal-token
OPENAI_MODEL=gpt-4.1-mini

نقاط رئيسية:

• يشير OPENAI_API_BASE إلى وكيلك، وليس OpenAI
• OPENAI_API_KEY هو رمز يصدره الوكيل
• يقرّر الوكيل أي مزوّد/نموذج يُستخدم فعليًا

أعد تشغيل Moltbot بعد تحديث هذه القيم.

الطريقة 2: الضبط عبر config.json:

• العثور على ملف إعداد Moltbot
• افتح ملف الإعداد وأضف أو حدّث models.providers

عادة يكون ملف الإعداد في أحد هذه المواقع:

يمكنك أيضًا العثور عليه باستخدام سطر الأوامر:

# See your current config
moltbot config list

# Get the exact path to your config file
moltbot config path

---

الخطوة 2: تحقّق من الاتصال

شغّل مطالبة اختبار بسيطة:

moltbot test llm

إذا تم الضبط بشكل صحيح، سيتلقى Moltbot الاستجابات بشكل طبيعي—دون الاتصال بالمزوّد الأعلى مباشرة.

تقديرات التكلفة لتشغيل Moltbot باستخدام نماذج مستضافة

تعتمد تكلفة استخدام نموذج مُدار على سعر واجهة API، لذا فإن اختيار مزوّد API أرخص مهم جدًا، وهذا سبب توصيتنا بـ CometAPI.

عادة ما تعتمد عوامل التسعير على:

• تسعير المزوّد. تعتمد تكلفة استخدام نموذج مُدار على سعر واجهة API، لذا إن اختيار مزوّد API أرخص أمر بالغ الأهمية، ولهذا أوصي بـ CometAPI.
• الاختيار بين نموذج رائد أو خفيف؛ على سبيل المثال، الفارق السعري بين Claude Opus 4.5 وGLM 4.7 كبير.
• تعقيد المحتوى المعالج. إذا كانت مهامك ثقيلة بالنصوص (تحليل ملفات، ردود طويلة)، أضِف الرموز.

أمثلة تقريبية (للإيضاح، أسعار يناير 2026 كما وردت في منشورات المجتمع):

• استخدام شخصي عرضي (بضع مئات من الاستجابات/الشهر، مزيج نماذج محلية واستدعاءات API رخيصة): 0–50$ شهريًا.
• استخدام شخصي كثيف/مطور محترف (فهرسة ملفات، الكثير من استدعاءات الأدوات): 100–1,000$ شهريًا.
• فريق أو إنتاج دائم التشغيل (عديد المستخدمين + استخراج ويب + تسلسل): 1,000$+ شهريًا ما لم تُحسّن استخدام النماذج بقوة.

طرق لتقليل التكلفة

• توجيه النماذج: أرسل المهام الخفيفة إلى نماذج أرخص أو LLMs محلية، واحتفظ بالنماذج المكلفة للتفكير الطويل — تشير اختبارات المجتمع إلى إمكانية خفض التكلفة بنحو ~50% أو أكثر.
• مرسِلات وأسعار بالجملة: استخدم مرسلات API التي تقدم أسعارًا أفضل لكل رمز أو استضافة نماذج خاصة (Venice، نقاط خاصة).
• تخزين مؤقت قوي والاقتطاع: خزّن مخرجات LLM مؤقتًا، واقطع السجلات الطويلة، ولخّص بدلًا من إعادة إرسال السياق الكامل.

ميزات متقدمة لوكيل API في Moltbot

توجيه النماذج بحسب نوع المهمة

يمكنك فحص حمولة الطلب وتوجيهها ديناميكيًا:

function selectModel(messages) {
  const systemPrompt = messages[0]?.content || "";
  if (systemPrompt.includes("shell") || systemPrompt.includes("automation")) {
    return "gpt-4.1";
  }
  return "gpt-4.1-mini";
}

هذا النمط يقلّل التكاليف دون التضحية بالجودة.

---

حدود الرموز والتكلفة

يمكنك فرض حدود صارمة:

if (req.body.max_tokens > 2000) {
  return res.status(400).json({
    error: "Token limit exceeded"
  });
}

تتعقّب بعض الفرق أيضًا الاستخدام التراكمي لكل معرّف مستخدم Moltbot.

---

هل من الآمن منح ذكاء اصطناعي وصول shell إلى حاسوبي؟

هذا هو السؤال الأهم لأي مستخدم Moltbot. منح LLM القدرة على تشغيل rm -rf ينطوي على مخاطرة بطبيعته. يتضمن Moltbot عدة مصدّات لتخفيف ذلك:

1. العزل (Sandboxing): يمكنك تشغيل Moltbot داخل حاوية Docker. يحد هذا من "عالم" الوكيل إلى مجلد محدد ويمنعه من لمس ملفات نظامك.
2. موافقة صريحة: افتراضيًا، تتمتع “الجلسات الرئيسية” (الدردشات المباشرة معك) بثقة أعلى، ولكن يمكنك ضبط البوت ليطلب الإذن قبل تشغيل أي أوامر مُدمّرة.
3. حماية بكلمة مرور: إذا كشفت واجهة Moltbot على الويب، فعطّل دائمًا مصادقة كلمة المرور في config.json الخاص بك:

{
  "gateway": {
    "auth": {
      "mode": "password",
      "password": "YOUR_STRONG_SECURE_PASSWORD"
    }
  }
}

أفكار أخيرة:

Moltbot أكثر من مجرد روبوت دردشة؛ إنه بنية تحتية لـ موظف رقمي شخصي. باستضافته ذاتيًا، تستعيد السيطرة على بياناتك بينما تحصل على إنتاجية ذكاء اصطناعي لا ينام. سواء استخدمته لإدارة تقويمك عبر Telegram أو لأتمتة خط أنابيب DevOps من أريكتك، فإن Moltbot لمحة عن مستقبل يمتلك فيه الجميع “Jarvis” خاصًا يعمل على Mac Mini في زاوية الغرفة.

إذا كنت تريد منصة API تضم نماذج من مزوّدين متعددين (مثل Chatgpt-5.2 وClaude opus 4.5 وغيرها) وبأسعار أقل من الرسمية، فإن CometAPI هو الخيار الأفضل. للبدء، استكشف قدرات النموذج في Playground وراجع API guide للحصول على تعليمات مفصلة. قبل الوصول، تأكّد من تسجيل الدخول إلى CometAPI والحصول على مفتاح API. CometAPI يقدم سعرًا أقل بكثير من السعر الرسمي لمساعدتك على الدمج.

جاهز للانطلاق؟→ Sign up for CometAPI today !

إذا أردت معرفة المزيد من النصائح والأدلة والأخبار حول الذكاء الاصطناعي، تابعنا على VK، X وDiscord!