استخدام OpenClaw مع CometAPI

استخدم CometAPI كمزوّد model لـ OpenClaw — أكثر من 500 model في API واحد.

المتطلبات الأساسية

Node.js ≥ 22 — يُوصى باستخدام nvm
حساب CometAPI مع مفتاح API نشط — احصل عليه من هنا

التثبيت

احصل على مفتاح API الخاص بـ CometAPI

سجّل الدخول إلى لوحة تحكم CometAPI. انقر على Add API Key وانسخ مفتاح API الخاص بـ CometAPI.

تفاصيل مفتاح API في CometAPI مع base URL

ثبّت OpenClaw أو حدّثه

موصى به — استخدم أداة التثبيت الرسمية:

curl -fsSL https://openclaw.ai/install.sh | bash

أو ثبّته عبر npm:

npm install -g openclaw@latest

ثم شغّل معالج الإعداد مرة واحدة:

openclaw onboard --install-daemon

أثناء عملية الإعداد الأولية، اختر Skip في خطوة Model/Auth إذا كنت تريد تهيئة CometAPI يدويًا. بعد الإعداد الأولي، أكّد أن البوابة قيد التشغيل:

openclaw gateway status
openclaw dashboard

الإعداد

تخزين مفتاح CometAPI الخاص بك

اكتب مفتاحك إلى ~/.openclaw/.env بحيث يكون متاحًا للـ daemon دون تضمينه بشكل ثابت داخل ملفات الإعداد:

printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

إذا كنت تُمرِّر COMETAPI_KEY بالفعل من خلال shell أو مدير الخدمات أو سير عمل الأسرار، فتجاوز هذه الخطوة — يستخدم الإعداد أدناه $\{COMETAPI_KEY\} بغض النظر عن كيفية تعيين المتغير.

إعداد موفري CometAPI

يدعم CometAPI أربعة تنسيقات API. أضف كتلة موفر واحدة أو أكثر إلى ~/.openclaw/openclaw.json:

الموفر	تنسيق API	الـ endpoint الذي يتم استدعاؤه	Base URL
`cometapi-openai`	`openai-completions`	`POST /v1/chat/completions`	`https://api.cometapi.com/v1`
`cometapi-openai-responses`	`openai-responses`	`POST /v1/responses`	`https://api.cometapi.com/v1`
`cometapi-claude`	`anthropic-messages`	`POST /messages`	`https://api.cometapi.com`
`cometapi-google`	`google-generative-ai`	`POST /v1beta/...`	`https://api.cometapi.com/v1beta`

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/your-claude-model-id"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
      },
      "cometapi-openai-responses": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-responses",
        "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
      }
    }
  }
}

يمكنك الاحتفاظ فقط بالموفرين الذين تحتاجهم، أو الاحتفاظ بالأربعة جميعًا للتوجيه بين التنسيقات باستخدام مراجع provider/model.استبدل كل عنصر نائب your-...-model-id بـ model ID حالي من صفحة نماذج CometAPI يطابق كتلة الموفر.

استخدم cometapi-openai-responses (api: "openai-responses") للنماذج التي تتطلب OpenAI Responses API. واستخدم cometapi-openai (api: "openai-completions") للنماذج الموجودة على مسار Chat Completions الكلاسيكي. يشترك كلاهما في baseUrl نفسه (https://api.cometapi.com/v1)؛ والفرق الوحيد هو أي endpoint لاحق يستدعيه OpenClaw.

ملف auth-profiles.json غير مطلوب لهذا الإعداد. يتم حل مفاتيح الموفّر من models.providers.*.apiKey عبر متغير البيئة $\{COMETAPI_KEY\}. لا تكون هناك حاجة إلى auth-profiles.json إلا إذا كنت تريد تدوير بيانات الاعتماد لكل ملف تعريف عبر مفاتيح متعددة.

التحقق

إعادة التشغيل والتحقق

أعد تشغيل البوابة بعد إضافة .env أو تغيير إعدادات المزوّد:

openclaw gateway restart

ثم شغّل أدوات التشخيص:

openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor

يبدو الإعداد الناجح كما يلي:

يقوم openclaw models status بتحليل model الأساسي إلى cometapi-claude/your-claude-model-id بدون أي تحذيرات missing-auth لمزوّدي CometAPI
يعرض openclaw models list --provider cometapi-claude النماذج التي قمت بإعدادها
يفيد openclaw doctor بعدم وجود أخطاء في الإعدادات أو المصادقة لمزوّدي CometAPI

حالة نماذج OpenClaw تُظهر أن مزوّدي CometAPI تمت مصادقتهم

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

# Set the default model in config
openclaw models set cometapi-claude/your-claude-model-id

# Switch for the current chat session
/model cometapi-openai/your-chat-model-id
/model cometapi-openai-responses/your-responses-model-id
/model cometapi-claude/your-claude-model-id
/model cometapi-google/your-gemini-model-id

استكشاف الأخطاء وإصلاحها

إعادة تثبيت نظيفة (اختياري)

إذا كنت تصلح إعدادًا قديمًا معطّلًا، فأوقف البوابة، وأزل ~/.openclaw، ثم أعد تشغيل الإعداد الأوّلي قبل تطبيق إعدادات CometAPI:

openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon

سيؤدي هذا إلى إزالة جميع الإعدادات المحلية، والجلسات، والسجلات، وحالة المصادقة، ومساحات العمل. ثم اتبع الخطوات 3–5 مرة أخرى.

نظرة عامة

وكلاء البرمجة بالذكاء الاصطناعي

وكلاء الذكاء الاصطناعي

عملاء دردشة الذكاء الاصطناعي

الترجمة واللغة

منصات الأتمتة

المراقبة والتقييم

أطر عمل الذكاء الاصطناعي

المتطلبات الأساسية

التثبيت

الإعداد

التحقق

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

استكشاف الأخطاء وإصلاحها

​المتطلبات الأساسية

​التثبيت

​الإعداد

​التحقق

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

​استكشاف الأخطاء وإصلاحها

المتطلبات الأساسية

التثبيت

الإعداد

التحقق

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

استكشاف الأخطاء وإصلاحها