الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
المتطلبات المسبقة

​
التثبيت

1

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

سجّل الدخول إلى لوحة تحكم CometAPI. انقر على Add API Key وانسخ مفتاح $COMETAPI_KEY الخاص بك.
لوحة تحكم CometAPI تعرض زر Add API Key
تفاصيل مفتاح CometAPI API مع base URL
2

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

موصى به — استخدم أداة التثبيت الرسمية:
curl -fsSL https://openclaw.ai/install.sh | bash
أو ثبّته عبر npm:
npm install -g openclaw@latest
ثم شغّل معالج الإعداد مرة واحدة:
openclaw onboard --install-daemon
أثناء onboarding، اختر Skip في خطوة Model/Auth إذا كنت تريد ضبط CometAPI يدويًا. بعد onboarding، تأكد من أن gateway قيد التشغيل:
openclaw gateway status
openclaw dashboard

​
الإعداد

1

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

اكتب مفتاحك في ~/.openclaw/.env ليكون متاحًا للـ daemon دون تضمينه مباشرةً في ملفات الإعداد:
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
إذا كنت تُمرر COMETAPI_KEY بالفعل عبر shell أو مدير الخدمة أو سير عمل للأسرار، فتجاوز هذه الخطوة — يستخدم الإعداد أدناه $\{COMETAPI_KEY\} بغض النظر عن كيفية تعيين المتغير.
2

اضبط موفري CometAPI

يدعم CometAPI أربعة تنسيقات API. أضف كتلة provider واحدة أو أكثر إلى ~/.openclaw/openclaw.json:
Providerتنسيق APIالـ endpoint الذي يتم استدعاؤهBase URL
cometapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.cometapi.com/v1
cometapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messagesPOST /messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aiPOST /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 حالي من صفحة Models في CometAPI يطابق كتلة provider.
استخدم 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 غير مطلوب لهذا الإعداد. يتم حل مفاتيح provider من models.providers.*.apiKey عبر متغير البيئة $\{COMETAPI_KEY\}. ولا تحتاج إلى auth-profiles.json إلا إذا كنت تريد تدوير بيانات الاعتماد لكل profile عبر عدة مفاتيح.

​
التحقق

1

أعد التشغيل وتحقق

أعد تشغيل gateway بعد إضافة .env أو تغيير إعداد provider:
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
حالة models في OpenClaw تُظهر أن موفري CometAPI تمت مصادقتهم

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

1

بدّل النماذج

# 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

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

إذا كنت تصلح إعدادًا قديمًا معطّلًا، فأوقف gateway، ثم احذف ~/.openclaw، وبعد ذلك أعد تشغيل onboarding قبل تطبيق إعداد CometAPI:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
سيؤدي هذا إلى إزالة كل الإعدادات المحلية والجلسات والسجلات وحالة المصادقة ومساحات العمل. ثم اتبع الخطوات 3–5 مرة أخرى.