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

# LongCat

[LongCat](https://longcat.ai) توفّر واجهة API مستضافة لنموذج LongCat-2.0، وهو
نموذج استدلال مصمم لأعباء عمل البرمجة والوكلاء. توفّر OpenClaw
Plugin الرسمي `longcat` لنقطة نهاية LongCat المتوافقة مع OpenAI.

| الخاصية              | القيمة                               |
| -------------------- | ------------------------------------ |
| المزوّد              | `longcat`                            |
| المصادقة             | `LONGCAT_API_KEY`                    |
| API                  | إكمالات المحادثة المتوافقة مع OpenAI |
| عنوان URL الأساسي    | `https://api.longcat.chat/openai`    |
| النموذج              | `longcat/LongCat-2.0`                |
| السياق               | 1,048,576 رمزًا                      |
| الحد الأقصى للمخرجات | 131,072 رمزًا                        |
| الإدخال              | نص                                   |

## تثبيت Plugin

ثبّت الحزمة الرسمية، ثم أعد تشغيل Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/longcat-provider
openclaw gateway restart
```

## بدء الاستخدام

<Steps>
  <Step title="إنشاء مفتاح API">
    سجّل الدخول إلى [منصة LongCat API](https://longcat.chat/platform/) وأنشئ
    مفتاحًا في صفحة [مفاتيح API](https://longcat.chat/platform/api_keys).
  </Step>

  <Step title="تشغيل الإعداد الأولي">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice longcat-api-key
    ```
  </Step>

  <Step title="التحقق من النموذج">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider longcat
    ```
  </Step>
</Steps>

يضيف الإعداد الأولي الكتالوج المستضاف ويحدد `longcat/LongCat-2.0` عندما لا
يكون هناك نموذج أساسي مُهيأ بالفعل.

### الإعداد غير التفاعلي

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

## سلوك الاستدلال

توفّر LongCat تحكمًا ثنائيًا في التفكير. تربط OpenClaw مستويات التفكير المفعّلة
بـ `thinking: { type: "enabled" }`، وتربط `/think off` بـ
`thinking: { type: "disabled" }`. لا توثّق LongCat حاليًا
`reasoning_effort`، ولذلك لا ترسله OpenClaw.

تعيد LongCat الاستدلال في `reasoning_content`. تحتفظ OpenClaw بهذا الحقل
عند إعادة تشغيل أدوار استدعاء الأدوات الخاصة بالمساعد، بحيث تحافظ جلسات الوكيل
متعددة الأدوار على بنية الرسائل التي يتوقعها المزوّد.

## التسعير

يستخدم الكتالوج المضمّن أسعار LongCat المعلنة بنظام الدفع حسب الاستخدام، بالدولار
الأمريكي لكل مليون رمز: 0.75 دولار للإدخال غير المخزّن مؤقتًا، و0.015 دولار
للإدخال المخزّن مؤقتًا، و2.95 دولار للمخرجات. قد تقدّم LongCat خصومات مؤقتة؛
وتُعد [صفحة التسعير](https://longcat.chat/platform/docs/Pricing/LongCat-2.0.html)
وسجلات الفوترة الخاصة بك المرجع المعتمد.

## LongCat-2.0 المستضاف ذاتيًا

يستهدف مزوّد `longcat` واجهة API المستضافة من LongCat. لاستخدام الأوزان المفتوحة
على [Hugging Face](https://huggingface.co/meituan-longcat/LongCat-2.0)، شغّل
النموذج من خلال بيئة تشغيل متوافقة مع OpenAI، واستخدم بدلًا من ذلك مزوّد
[vLLM](/ar/providers/vllm) أو [SGLang](/ar/providers/sglang) الموجود في OpenClaw.

احتفظ بمعرّف النموذج الدقيق لبيئة التشغيل في كتالوج المزوّد المستضاف ذاتيًا؛
ولا توجّه نشرًا محليًا عبر `longcat/LongCat-2.0`.

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

<AccordionGroup>
  <Accordion title="يعمل المفتاح في الصدفة، ولكن ليس في Gateway">
    لا ترث عمليات Gateway التي تديرها الخدمات الخفية جميع متغيرات الصدفة
    التفاعلية. ضع `LONGCAT_API_KEY` في `~/.openclaw/.env`، أو هيّئه من خلال
    الإعداد الأولي، أو استخدم مرجع أسرار معتمدًا.
  </Accordion>

  <Accordion title="تفشل الطلبات بالرمز 402 أو 429">
    يعني `402` أن الحساب لا يملك حصة رموز كافية. ويعني `429` أن مفتاح API
    بلغ حد المعدل. تحقّق من [استخدام LongCat](https://longcat.chat/platform/usage)
    وأعد محاولة الطلبات المحدودة بالمعدل بعد انتهاء فترة التراجع الخاصة بالمزوّد.
  </Accordion>

  <Accordion title="لا يظهر النموذج">
    شغّل `openclaw plugins list` وتأكد من أن Plugin ‏`longcat`
    مفعّل، ثم شغّل `openclaw models list --provider longcat`.
  </Accordion>
</AccordionGroup>

## ذو صلة

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

  <Card title="وثائق LongCat API" href="https://longcat.chat/platform/docs/" icon="arrow-up-right-from-square">
    نقاط نهاية API المستضافة، والمصادقة، والحدود، والأمثلة.
  </Card>

  <Card title="بطاقة نموذج LongCat-2.0" href="https://huggingface.co/meituan-longcat/LongCat-2.0" icon="arrow-up-right-from-square">
    البنية، وإرشادات النشر، وتفاصيل النموذج.
  </Card>

  <Card title="الأسرار" href="/ar/gateway/secrets" icon="key">
    خزّن بيانات اعتماد المزوّد دون تضمين نص صريح في الإعدادات.
  </Card>
</CardGroup>