---
read_when:
    - می‌خواهید از LongCat-2.0 با OpenClaw استفاده کنید
    - به کلید API یا محدودیت‌های مدل LongCat نیاز دارید
summary: راه‌اندازی API LongCat برای LongCat-2.0
title: LongCat
x-i18n:
    generated_at: "2026-07-27T14:35:33Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 7c447f9c42e6547a69d2124debcb685c32fe59de29bfc551e18e791d9f280584
    source_path: providers/longcat.md
    workflow: 16
---

[LongCat](https://longcat.ai) یک API میزبانی‌شده برای LongCat-2.0 ارائه می‌دهد؛
مدلی استدلالی که برای کدنویسی و بارهای کاری عامل‌محور ساخته شده است. OpenClaw،
Plugin رسمی `longcat` را برای نقطه پایانی سازگار با OpenAI متعلق به LongCat ارائه می‌دهد.

| ویژگی      | مقدار                              |
| ---------- | ---------------------------------- |
| ارائه‌دهنده | `longcat`                          |
| احراز هویت | `LONGCAT_API_KEY`                  |
| API        | تکمیل‌های گفت‌وگوی سازگار با OpenAI |
| نشانی پایه | `https://api.longcat.chat/openai`  |
| مدل        | `longcat/LongCat-2.0`              |
| زمینه      | 1,048,576 توکن                   |
| حداکثر خروجی | 131,072 توکن                     |
| ورودی      | متن                               |

## نصب Plugin

بسته رسمی را نصب کنید، سپس Gateway را راه‌اندازی مجدد کنید:

```bash
openclaw plugins install @openclaw/longcat-provider
openclaw gateway restart
```

## شروع به کار

<Steps>
  <Step title="ایجاد کلید API">
    وارد [پلتفرم API ‏LongCat](https://longcat.chat/platform/) شوید و
    در صفحه [API Keys](https://longcat.chat/platform/api_keys)
    یک کلید ایجاد کنید.
  </Step>
  <Step title="اجرای فرایند راه‌اندازی اولیه">
    ```bash
    openclaw onboard --auth-choice longcat-api-key
    ```
  </Step>
  <Step title="تأیید مدل">
    ```bash
    openclaw models list --provider longcat
    ```
  </Step>
</Steps>

اگر از قبل مدل اصلی پیکربندی نشده باشد، فرایند راه‌اندازی اولیه کاتالوگ میزبانی‌شده را اضافه می‌کند و
`longcat/LongCat-2.0` را انتخاب می‌کند.

### راه‌اندازی غیرتعاملی

```bash
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](/fa/providers/vllm) یا [SGLang](/fa/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="/fa/concepts/model-providers" icon="layers">
    پیکربندی ارائه‌دهنده، ارجاع‌های مدل و رفتار جایگزینی هنگام خرابی.
  </Card>
  <Card title="مستندات API ‏LongCat" 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="/fa/gateway/secrets" icon="key">
    اطلاعات اعتبار ارائه‌دهنده را بدون جاسازی متن ساده در پیکربندی ذخیره کنید.
  </Card>
</CardGroup>