دليل تعليمي مدته خمس دقائق لتهيئة OpenClaw باستخدام CometAPI

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

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

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

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

CometAPI هي منصة تجميع واجهات برمجة تطبيقات تعرض العديد من مزوّدي النماذج من خلال واجهة REST على نمط OpenAI وSDKs. وهذا يجعلها نقطة تكامل واحدة مناسبة إذا أردت تبديل النماذج، وتجربة التسعير، أو توحيد الرصد دون تغيير الشفرة الأساسية لـ 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:

Provider	API Format	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
مفتاح CometAPI LLM صالح (مخزّن في متغيّر بيئة آمن)
اختياري: حسابات لمزوّدين إضافيين في 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 عالميًا.

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

إذا كنت تنشر إلى الإنتاج أو تريد العزل:

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

تجعل عمليات النشر بالحاويات إدارة التبعيات وأعباء العمل أسهل.nClaw version; تتبع أمثلة OpenClaw هذا النمط.)

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

تُعلِم تهيئة المزوّدين OpenClaw بمكان العثور على جهة خلفية LLM.

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

يخزّن OpenClaw تهيئته في ملف JSON عند:

~/.openclaw/openclaw.json

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

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

يحدّد base_url لـ OpenClaw إرسال طلبات LLM إلى نقطة النهاية المتوافقة مع OpenAI في CometAPI.
يشير 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 إلى المزوّد الموافق.

الخطوة 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

الخطوة 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 lint) وتأكد أن api تطابق الصيغ المدعومة. تُظهر مواضيع المجتمع أن سوء التهيئة هذا شائع.

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

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

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

زيادة الاستخدام / 429s

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

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

رمز البوابة مفقود / قطع اتصال WebSocket

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

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

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

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

جاهز للانطلاق؟ → Sign up fo openclaw today !

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