> ## 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.

# استخدام OpenClaw مع CometAPI

> استخدم هذا الدليل لتهيئة OpenClaw مع CometAPI من خلال تعيين base URL ومفتاح API وخيارات model أو provider.

استخدم [CometAPI](https://www.cometapi.com) كمزوّد model لـ [OpenClaw](https://openclaw.ai) — أكثر من 500 model في API واحد.

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

* Node.js ≥ 22 — يُوصى باستخدام [nvm](https://github.com/nvm-sh/nvm)
* حساب CometAPI مع مفتاح API نشط — [احصل عليه من هنا](https://www.cometapi.com/console/token)

## التثبيت

<Steps>
  <Step title="احصل على مفتاح API الخاص بـ CometAPI">
    سجّل الدخول إلى [لوحة تحكم CometAPI](https://www.cometapi.com/console/token). انقر على **Add API Key** وانسخ مفتاح API الخاص بـ CometAPI.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="لوحة تحكم CometAPI تعرض زر Add API Key" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="تفاصيل مفتاح API في CometAPI مع base URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="ثبّت OpenClaw أو حدّثه">
    **موصى به** — استخدم أداة التثبيت الرسمية:

    ```bash theme={null}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

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

    ```bash theme={null}
    npm install -g openclaw@latest
    ```

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

    ```bash theme={null}
    openclaw onboard --install-daemon
    ```

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

    ```bash theme={null}
    openclaw gateway status
    openclaw dashboard
    ```
  </Step>
</Steps>

## الإعداد

<Steps>
  <Step title="تخزين مفتاح CometAPI الخاص بك">
    اكتب مفتاحك إلى `~/.openclaw/.env` بحيث يكون متاحًا للـ daemon دون تضمينه بشكل ثابت داخل ملفات الإعداد:

    ```bash theme={null}
    printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
    chmod 600 ~/.openclaw/.env
    ```

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

  <Step title="إعداد موفري 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` |

    ```json theme={null}
    {
      "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](https://www.cometapi.com/models/) يطابق كتلة الموفر.

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

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

## التحقق

<Steps>
  <Step title="إعادة التشغيل والتحقق">
    أعد تشغيل البوابة بعد إضافة `.env` أو تغيير إعدادات المزوّد:

    ```bash theme={null}
    openclaw gateway restart
    ```

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

    ```bash theme={null}
    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

    <Frame>
      <img src="https://mintcdn.com/cometapi/3HbSFe0pH45ETcjq/images/integrations/810968_371721.png?fit=max&auto=format&n=3HbSFe0pH45ETcjq&q=85&s=928b6faed91c5c2cb2eceea6bfac630d" alt="حالة نماذج OpenClaw تُظهر أن مزوّدي CometAPI تمت مصادقتهم" width="1906" height="296" data-path="images/integrations/810968_371721.png" />
    </Frame>
  </Step>
</Steps>

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

<Steps>
  <Step title="تبديل النماذج">
    ```bash theme={null}
    # 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
    ```
  </Step>
</Steps>

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

<AccordionGroup>
  <Accordion title="إعادة تثبيت نظيفة (اختياري)">
    إذا كنت تصلح إعدادًا قديمًا معطّلًا، فأوقف البوابة، وأزل `~/.openclaw`، ثم أعد تشغيل الإعداد الأوّلي قبل تطبيق إعدادات CometAPI:

    ```bash theme={null}
    openclaw gateway stop
    rm -rf ~/.openclaw
    openclaw onboard --install-daemon
    ```

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

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/openclaw#howto",
        "name": "استخدم OpenClaw مع CometAPI",
        "description": "استخدم هذا الدليل لتهيئة OpenClaw مع CometAPI من خلال تعيين base URL ومفتاح API وخيارات model أو provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-1",
            "position": 1,
            "name": "احصل على مفتاح API الخاص بك في CometAPI",
            "text": "أنشئ حساب CometAPI الخاص بك أو افتحه، ثم انسخ مفتاح API نشطًا من لوحة التحكم."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-2",
            "position": 2,
            "name": "ثبّت OpenClaw أو حدّثه",
            "text": "أكمل خطوة تثبيت OpenClaw أو تحديثه في دليل استخدام OpenClaw مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-3",
            "position": 3,
            "name": "خزّن مفتاح CometAPI الخاص بك",
            "text": "أكمل خطوة تخزين مفتاح CometAPI الخاص بك في دليل استخدام OpenClaw مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-4",
            "position": 4,
            "name": "هيّئ مزوّدي CometAPI",
            "text": "أكمل خطوة تهيئة مزوّدي CometAPI في دليل استخدام OpenClaw مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-5",
            "position": 5,
            "name": "أعد التشغيل وتحقق",
            "text": "أكمل خطوة إعادة التشغيل والتحقق في دليل استخدام OpenClaw مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-6",
            "position": 6,
            "name": "بدّل النماذج",
            "text": "أكمل خطوة تبديل النماذج في دليل استخدام OpenClaw مع CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "مستندات CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "عمليات التكامل",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "استخدم OpenClaw مع CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/openclaw"
          }
        ]
      }
    ]
    }
    `}
</script>