> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# بوابة Vercel AI

يوفر [Vercel AI Gateway](https://vercel.com/ai-gateway) واجهة API موحدة للوصول إلى مئات النماذج عبر نقطة نهاية واحدة.

| الخاصية        | القيمة                                 |
| -------------- | -------------------------------------- |
| الموفر         | `vercel-ai-gateway`                    |
| الحزمة         | `@openclaw/vercel-ai-gateway-provider` |
| المصادقة       | `AI_GATEWAY_API_KEY`                   |
| API            | متوافق مع Anthropic Messages           |
| كتالوج النماذج | يُكتشف تلقائيًا عبر `/v1/models`       |

<Tip>
  يكتشف OpenClaw تلقائيًا كتالوج Gateway `/v1/models`، لذلك يتضمن
  `/models vercel-ai-gateway` مراجع النماذج الحالية مثل
  `vercel-ai-gateway/openai/gpt-5.5` و
  `vercel-ai-gateway/moonshotai/kimi-k2.6`.
</Tip>

## البدء

<Steps>
  <Step title="Install the plugin">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw plugins install @openclaw/vercel-ai-gateway-provider
    ```
  </Step>

  <Step title="Set the API key">
    شغّل الإعداد الأولي واختر خيار مصادقة AI Gateway:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice ai-gateway-api-key
    ```
  </Step>

  <Step title="Set a default model">
    أضف النموذج إلى إعدادات OpenClaw الخاصة بك:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
        },
      },
    }
    ```
  </Step>

  <Step title="Verify the model is available">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider vercel-ai-gateway
    ```
  </Step>
</Steps>

## مثال غير تفاعلي

لعمليات الإعداد النصية أو إعدادات CI، مرّر كل القيم في سطر الأوامر:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"
```

## اختصار معرّف النموذج

يقبل OpenClaw مراجع نماذج Vercel Claude المختصرة ويطبّعها في وقت التشغيل:

| الإدخال المختصر                     | مرجع النموذج بعد التطبيع                      |
| ----------------------------------- | --------------------------------------------- |
| `vercel-ai-gateway/claude-opus-4.6` | `vercel-ai-gateway/anthropic/claude-opus-4.6` |
| `vercel-ai-gateway/opus-4.6`        | `vercel-ai-gateway/anthropic/claude-opus-4-6` |

<Tip>
  يمكنك استخدام الاختصار أو مرجع النموذج المؤهل بالكامل في إعداداتك. يحل OpenClaw الصيغة القياسية تلقائيًا.
</Tip>

## الإعدادات المتقدمة

<AccordionGroup>
  <Accordion title="Environment variable for daemon processes">
    إذا كان OpenClaw Gateway يعمل كخدمة daemon (launchd/systemd)، فتأكد من أن
    `AI_GATEWAY_API_KEY` متاح لتلك العملية.

    <Warning>
      لن يكون المفتاح الذي يتم تصديره في shell تفاعلي فقط مرئيًا لخدمة daemon
      تعمل عبر launchd/systemd ما لم يتم استيراد تلك البيئة صراحةً. اضبط
      المفتاح في `~/.openclaw/.env` أو عبر `env.shellEnv` لضمان أن عملية Gateway
      يمكنها قراءته.
    </Warning>
  </Accordion>

  <Accordion title="Provider routing">
    يوجّه Vercel AI Gateway الطلبات إلى الموفر العلوي بناءً على بادئة مرجع
    النموذج. على سبيل المثال، يمر `vercel-ai-gateway/anthropic/claude-opus-4.6`
    عبر Anthropic، بينما يمر `vercel-ai-gateway/openai/gpt-5.5` عبر OpenAI ويمر
    `vercel-ai-gateway/moonshotai/kimi-k2.6` عبر MoonshotAI. يتولى مفتاحك
    الوحيد `AI_GATEWAY_API_KEY` المصادقة لكل الموفرين العلويين.
  </Accordion>

  <Accordion title="Thinking levels">
    تتبع خيارات `/think` بادئات النماذج العلوية الموثوقة عندما يعرف OpenClaw
    عقد الموفر العلوي. يستخدم `vercel-ai-gateway/anthropic/...` ملف تعريف تفكير
    Claude، بما في ذلك القيم الافتراضية التكيفية لنماذج Claude 4.6.
    تعرض `vercel-ai-gateway/openai/gpt-5.4` و`gpt-5.5` والمراجع بنمط Codex
    خيار `/think xhigh` تمامًا مثل موفري OpenAI/OpenAI Codex المباشرين. تحتفظ
    المراجع الأخرى ذات النطاقات بمستويات الاستدلال العادية ما لم تصرّح بيانات
    كتالوجها الوصفية بالمزيد.
  </Accordion>
</AccordionGroup>

## ذات صلة

<CardGroup cols={2}>
  <Card title="Model selection" href="/ar/concepts/model-providers" icon="layers">
    اختيار الموفرين ومراجع النماذج وسلوك تجاوز الفشل.
  </Card>

  <Card title="Troubleshooting" href="/ar/help/troubleshooting" icon="wrench">
    استكشاف الأخطاء العام والأسئلة الشائعة.
  </Card>
</CardGroup>