دليل تعليمي مدته خمس دقائق لتكوين OpenClaw مع CometAPI

في مطلع عام 2026، يواصل OpenClaw — منصة التشغيل لوكلاء الذكاء الاصطناعي مفتوحة المصدر ومنصة المساعد الذكي — انتشارَه الواسع بين المطوّرين وفرق البحث والمؤسسات التي تحتاج إلى تنسيق متعدد النماذج عبر قنوات مثل Slack وTelegram وWhatsApp والتنفيذ المحلي عبر سطر الأوامر. وفي الوقت نفسه، برزت CometAPI كـ بوابة قوية متوافقة مع OpenAI لنماذج اللغة الكبيرة، إذ تُجمّع مئات النماذج (مثل Kimi-K2.5 ومتغيرات GPT وClaude) تحت نقطة نهاية API واحدة.

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

ما هو OpenClaw ولماذا ندمجه مع CometAPI؟

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

CometAPI منصة تجميع عبر API تتيح مزوّدين عِدّة عبر واجهة REST ونُسخ SDK بأسلوب OpenAI. هذا يجعلها نقطة تكامل واحدة مريحة إذا أردتَ تبديل النماذج، تجربة التسعير، أو توحيد الرصد دون تغيير الشيفرة الأساسية في OpenClaw.

لماذا نقترن بين OpenClaw وCometAPI؟

OpenClaw محايد تجاه النماذج؛ فهو يشغّل الوكلاء وسير العمل لكنه يعتمد على مزوّدي LLM خارجيين. تعمل CometAPI كـ بوابة متوافقة مع OpenAI، ما يتيح لك توجيه الاستدعاءات إلى:

عائلة نماذج GPT
عائلة نماذج Claude
Kimi-K2.5 ونماذج طرف ثالث أخرى تجمعها CometAPI

هذا يمنحك الاختيار والمرونة والتحكّم بالتكلفة والاعتمادية.

كيف أهيّئ OpenClaw لاستخدام CometAPI كمزوّد نماذج؟

الإجابة: أضِف إدخال مزوّد إلى تهيئة OpenClaw يُشير إلى نقطة نهاية REST الخاصة بـ CometAPI واربِط النماذج ببنية models.providers في OpenClaw. يدعم مشروع OpenClaw إضافة مزوّدين مخصّصين عبر models.providers (النمط نفسه المستخدم مع بوابات أخرى) ويتوقّع صيغة api مثل "openai-completions" أو "anthropic-messages" بحسب دلالات المزوّد.

تدعم CometAPI ثلاث صِيغ API. أضِف واحدة أو أكثر إلى ~/.openclaw/openclaw.json:

المزوّد	صيغة API	عنوان base URL
cometapi-openai	openai-completions	https://api.cometapi.com/v1
cometapi-claude	anthropic-messages	https://api.cometapi.com
cometapi-google	google-generative-ai	https://api.cometapi.com/v1beta

ما المتطلبات المسبقة لتهيئة OpenClaw مع CometAPI؟

قبل الدمج، تأكّد من توافر البيئة والأدوات والحسابات المناسبة.

متطلبات البيئة

ستحتاج إلى:

بيئة شبيهة بـ Unix: Linux أو macOS أو Windows Subsystem for Linux (WSL2)
تثبيت Node.js وnpm (يستخدم OpenClaw Node في الخلفية)
وصول إلى الطرفية عبر bash/zsh أو PowerShell

تذكر الوثائق الرسمية أيضًا أن OpenClaw يمكن تشغيله عبر Docker، وهو مثالي للعزل وإعدادات الإنتاج.

الحسابات ومفاتيح API

ستحتاج إلى:

حساب CometAPI
مفتاح LLM صالح لـ CometAPI (مخزّن في متغيّر بيئة آمن)
اختياري: حسابات لمزوّدين إضافيين في OpenClaw (OpenAI وAnthropic ونماذج محلية عبر Ollama)

💡 نصيحة: استخدم مدير أسرار آمنًا أو سلسلة مفاتيح نظام التشغيل بدلاً من تخزين المفاتيح كنص عادي. هذا ما تنصح به وثائق OpenClaw لأمان بيئات الإنتاج.

كيف تهيّئ OpenClaw لاستدعاء CometAPI؟ (خطوة بخطوة)

فيما يلي إعداد عملي ومختصر يستغرق خمس دقائق. قد تعتمد أسماء الملفات أو المفاتيح الدقيقة على إصدار وتوزيع OpenClaw لديك، لكن المفاهيم تُطابِق ما في مستودع OpenClaw ووثائقه الرسمية.

الخطوة 0 — ضبط متغيّرات البيئة (الطريق السريع الآمن)

مثال على الطرفية (Linux/macOS):

# do NOT commit this to gitexport COMETAPI_KEY="sk-YourCometApiKeyHere"export OPENCLAW_ENV="production"   # or development

استخدم آلية الأسرار الخاصة بمنصّتك في بيئات الإنتاج (مثل أسرار Docker أو systemd أو أسرار Kubernetes).

الخطوة 1 — تثبيت OpenClaw

الخيار أ: سطر واحد عبر نص التثبيت

هذه هي الطريقة الأسرع:

curl -fsSL https://openclaw.ai/install.sh | bash# Verify installationopenclaw --version

يكتشف هذا النص نظام التشغيل لديك ويثبّت OpenClaw مع الاعتمادات.

الخيار ب: تثبيت npm عالميًا

إذا كنت تُدير حِزم Node بالفعل:

npm install -g openclaw@latestopenclaw --version

يُثبّت هذا أداة OpenClaw CLI على نحوٍ عام.

اختياري: تثبيت Docker

إذا كنت تنشر للإنتاج أو ترغب في العزل:

docker pull openclaw/openclaw:latestdocker run -d --name openclaw -v ~/.openclaw:/root/.openclaw openclaw/openclaw

تسهّل عمليات النشر المُحَوْسَبة حاويًا إدارة الاعتمادات وأعباء العمل.nClaw version; OpenClaw’s examples follow this pattern.)

الخطوة 2 — تهيئة المزوّدين

تُخبر تهيئة المزوّدين OpenClaw بموقع الواجهة الخلفية لـ LLM.

تحرير ملف تهيئة OpenClaw

يخزّن OpenClaw تهيئته في ملف JSON على المسار:

~/.openclaw/openclaw.json

ستعرّف مزوّدًا مخصّصًا لـ CometAPI.

فيما يلي تهيئة مزوّد دنيا:

يوضّح base_url لـ OpenClaw إرسال طلبات LLM إلى نقطة نهاية CometAPI المتوافقة مع OpenAI.
يُشير auth_env إلى متغيّر البيئة الذي يحتفظ بمفتاح API.
يحدد العَلَم type صيغة البروتوكول لـ API (أسلوب OpenAI).

{
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.2", "name": "GPT-5.2" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-opus-4-6", "name": "Claude Opus 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "cometapi-claude/claude-opus-4-6" }
    }
  },
  "auth": {
    "profiles": {
      "cometapi-openai:default": { "provider": "cometapi-openai", "mode": "api_key" },
      "cometapi-claude:default": { "provider": "cometapi-claude", "mode": "api_key" },
      "cometapi-google:default": { "provider": "cometapi-google", "mode": "api_key" }
    }
  }
}

استبدل <YOUR_COMETAPI_KEY> بمفتاح API الخاص بك. تستخدم المزوّدات الثلاثة المفتاح نفسه.

يمكنك إضافة أي نموذج من صفحة نماذج CometAPI: https://www.cometapi.com/models إلى المزوّد المقابل.

الخطوة 3 — تهيئة ملفات تعريف المصادقة

⚠️ مطلوب! يقرأ OpenClaw مفاتيح API من هذا الملف، وليس من openclaw.json. تخطّي هذه الخطوة يؤدي إلى أخطاء HTTP 401.

أنشئ ~/.openclaw/agents/main/agent/auth-profiles.json:

{
  "version": 1,
  "profiles": {
    "cometapi-openai:default": {
      "type": "api_key",
      "provider": "cometapi-openai",
      "key": "<YOUR_COMETAPI_KEY>"
    },
    "cometapi-claude:default": {
      "type": "api_key",
      "provider": "cometapi-claude",
      "key": "<YOUR_COMETAPI_KEY>"
    },
    "cometapi-google:default": {
      "type": "api_key",
      "provider": "cometapi-google",
      "key": "<YOUR_COMETAPI_KEY>"
    }
  },
  "lastGood": {
    "cometapi-openai": "cometapi-openai:default",
    "cometapi-claude": "cometapi-claude:default",
    "cometapi-google": "cometapi-google:default"
  }
}

أعد تشغيل البوابة:

openclaw gateway restart

تحقّق من الحالات عبر:

openclaw auth status

ولعرض جميع النماذج المهيّأة:

openclaw models list

تؤكّد هذه الأوامر ما إذا تم إعداد مزوّديك وملفات تعريف المصادقة بشكل صحيح. يجب أن تُظهر جميع النماذج Auth = yes:

Model                                        Auth
cometapi-openai/gpt-5.2                      yes
cometapi-claude/claude-opus-4-6              yes
cometapi-google/gemini-3-pro-preview         yes

دليل تعليمي مدته خمس دقائق لتكوين OpenClaw مع CometAPI

الخطوة 4 — شغّل OpenClaw وراقب السجلات

ابدأ/أعد تشغيل OpenClaw وتتبّع السجلات. ابحث تحديدًا عن:

سجلات الطلبات الصادرة التي تُظهر base_url أو اسم المزوّد.
401/403 → مشكلة مفتاح أو نطاق الصلاحيات.
429 → حد المعدّل (فكّر في تغيير النموذج/الأداء).
بطء غير متوقّع في زمن الاستجابة → شبكة أو تقييد من جهة النموذج.

أمر تشخيص سريع (مثال):

# If OpenClaw runs as a system service:journalctl -u openclaw -f# If running in Docker:docker logs -f openclaw

تبديل النماذج

# Set default model
openclaw models set cometapi-claude/claude-opus-4-6

# Or switch in TUI
/model cometapi-openai/gpt-5.2

كيف تستخدم OpenClaw مع CometAPI في سير عمل واقعية؟

بعد الدمج، يمكنك بناء سير عمل تشمل توليد الشيفرة، والمهام متعددة الوسائط، وأتمتة الوكلاء، والنشر إلى القنوات.

مثال سير عمل: تفسير لقطة شاشة

إذا كان وكيلك يدعم المرفقات:

User: Analyze this screenshot and generate a minimal React component.

يرسل OpenClaw المطالبة (مع بيانات الصورة) عبر نموذج CometAPI (مثل Kimi K-2.5)، الذي يعيد مخرج شيفرة — مثالي للنمذجة الأولية لسير عمل واجهات المستخدم.

تكامل Slack / Discord

بمجرد أن تكون CometAPI الواجهة الخلفية، يمكنك توجيه ردود الوكيل إلى أي منصة مهيّأة:

قنوات Slack
مجموعات WhatsApp
روبوتات Telegram

يتولّى OpenClaw التوجيه وتحليل الطلبات؛ وتوفّر CometAPI استجابات النماذج.

ما أدوات المراقبة والتحكّم في التكلفة التي ينبغي إضافتها؟

عند التمركز حول مجمّع، تكتسب تحكّمًا — لكن عليك تهيئته:

القياس والأدوات

دوّن اسم النموذج، واستخدام الرموز، وزمن الاستجابة، وأكواد الأخطاء لكل طلب.
وسم الطلبات باسم الوكيل والقناة (مثل agent=personal_assistant, channel=telegram) لتستطيع إسناد التكاليف.

مقابض التحكّم في التكلفة

عيّن max_tokens وtimeout_seconds في تهيئة المزوّد.
استخدم نماذج أقل تكلفة للمهام الروتينية واحجز النماذج الكبيرة للتدفقات عالية القيمة.
اضبط حدود المعدّل لكل وكيل وحصصًا لكل مستخدم (يمكن توسيع OpenClaw غالبًا لفرض ذلك).

تعلن CometAPI عن أدوات لضبط الأداء والتكلفة؛ استخدم القياسات من الجانبين (سجلات OpenClaw + مقاييس استخدام CometAPI) لإنشاء ضوابط أمان.

كيف تحلّ مشكلات الأخطاء الشائعة في الدمج؟

الإجابة: فيما يلي أنماط الإخفاق الشائعة وكيفية حلّها بسرعة:

الإصلاح: سيعرض لكلوحة تحكّم OpenClaw رمزًا لمرة واحدة؛ الصقه في إعدادات واجهة التحكّم حسب الوثائق. تُشير ملاحظات المجتمع إلى هذه الخطوة كثيرًا.

401 Unauthorized

السبب: غياب COMETAPI_KEY أو خطؤه، أو عدم حقنه في عملية OpenClaw.

الإصلاح: صدّر المفتاح في الصَدَفة التي تُطلق منها OpenClaw أو اكتبه في ملف .env الخاص بـ OpenClaw ثم أعد تشغيل البوابة. أكّد ذلك باختبار curl.

تعذّر المزوّد أو العودة الافتراضية بصمت

السبب: JSON غير مُشكَّل في models.providers أو غياب صيغة api، ما يدفع OpenClaw لتجاهل المزوّد.

الإصلاح: صحّح openclaw.json (تحقّق JSON) وتأكد أن api تُطابق الصِيَغ المدعومة. تُظهر مواضيع المجتمع هذا الخطأ بعينه كخطأ شائع.

انتهاء المهلة أو زمن استجابة مرتفع

السبب: مسار شبكة أو بطء من جهة النموذج البعيد.

الإصلاح: اختر نموذج Comet أقل زمنًا للاستجابة أو شغّل OpenClaw بالقرب من الإقليم السحابي نفسه؛ فكّر في تشغيل نموذج محلي للمهام الحسّاسة للزمن. تناقش الوثائق والمدوّنات المقارنة بين النماذج المحلية ونماذج API (الزمن مقابل التكلفة).

استخدام مفرط / 429s

السبب: بلوغ حصة CometAPI أو حدود الخطة.

الإصلاح: تحقّق من لوحة تحكّم Comet للحصص؛ أضف منطق إعادة المحاولة/التراجع التدريجي في إجراءات وكيل OpenClaw أو خفّض الطلبات عند البوابة. تُبرز وثائق Comet والشركاء حصص الخطط وأنماط التراجع الموصى بها.

فقدان رمز البوابة / انقطاع websocket

السبب: فقدان رموز تحكّم OpenClaw في تهيئة لوحة التحكّم عند تشغيل البوابة.

ملاحظة ختامية

إنّ ربط OpenClaw بـ CometAPI سريع ويفتح واجهة خلفية قوية متعددة النماذج لمساعدك الشخصي. لكن السرعة ليست مبرّرًا لتجاهل الأمان: اربط البوابة على localhost أثناء الاختبار، استخدم قوائم السماح، دوّن كل شيء، واطلب تأكيدات للأفعال المدمّرة. مع هذه الضوابط، يمكنك الانتقال من الصفر إلى وكيل OpenClaw → CometAPI عامل خلال نحو خمس دقائق — مع إبقاء بياناتك وأنظمتك محمية أثناء التجربة.

يمكن للمطوّرين الوصول إلى kimi k-2.5 عبر CometAPI الآن. للبدء، استكشف قدرات النموذج في Playground واطّلع على دليل API للحصول على إرشادات مفصّلة. قبل الوصول، يُرجى التأكد من تسجيل الدخول إلى CometAPI والحصول على مفتاح API. تقدّم CometAPI سعرًا أدنى بكثير من السعر الرسمي لمساعدتك على التكامل.

هل أنت مستعد للانطلاق؟ → سجّل في OpenClaw اليوم!

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