> ## 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 предоставляет официальный плагин
`longcat` для совместимой с OpenAI конечной точки LongCat.

| Свойство | Значение |
| - | - |
| Провайдер | `longcat` |
| Аутентификация | `LONGCAT_API_KEY` |
| API | Совместимый с OpenAI Chat Completions |
| Базовый URL | `https://api.longcat.chat/openai` |
| Модель | `longcat/LongCat-2.0` |
| Контекст | 1,048,576 токенов |
| Максимальный вывод | 131,072 токенов |
| Входные данные | Текст |

## Установка плагина

Установите официальный пакет, затем перезапустите Gateway:

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

## Начало работы

**1. Создайте ключ API**

Войдите на [платформу LongCat API](https://longcat.chat/platform/) и
создайте ключ на странице [API Keys](https://longcat.chat/platform/api_keys).

**2. Запустите первоначальную настройку**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice longcat-api-key
```

**3. Проверьте модель**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider longcat
```

Первоначальная настройка добавляет размещённый каталог и выбирает
`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, и вместо этого используйте
существующий провайдер OpenClaw [vLLM](https://docs2.openclaw.ai/ru/providers/vllm.md) или
[SGLang](https://docs2.openclaw.ai/ru/providers/sglang.md).

Сохраните точный идентификатор модели среды выполнения в каталоге
самостоятельно размещённого провайдера; не направляйте локальное развёртывание
через `longcat/LongCat-2.0`.

## Устранение неполадок

> [accordion] Ключ работает в командной оболочке, но не в Gateway
>
> Процессы Gateway, управляемые демоном, наследуют не все переменные
> интерактивной командной оболочки. Поместите `LONGCAT_API_KEY` в
> `~/.openclaw/.env`, настройте его при первоначальной настройке или
> используйте разрешённую ссылку на секрет.

> [accordion] Запросы завершаются ошибкой 402 или 429
>
> `402` означает, что учётной записи не хватает квоты токенов.
> `429` означает, что ключ API достиг ограничения частоты
> запросов. Проверьте [использование LongCat](https://longcat.chat/platform/usage)
> и повторите запросы с ограниченной частотой после окончания заданного
> провайдером периода ожидания.

> [accordion] Модель не отображается
>
> Выполните `openclaw plugins list` и убедитесь, что плагин
> `longcat` включён, затем выполните `openclaw models list --provider longcat`.

## Связанные материалы

> [card] [Провайдеры моделей](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Настройка провайдеров, ссылки на модели и поведение при переключении после сбоя.

> [card] [Документация LongCat API](https://longcat.chat/platform/docs/)
>
> Конечные точки размещённого API, аутентификация, ограничения и примеры.

> [card] [Карточка модели LongCat-2.0](https://huggingface.co/meituan-longcat/LongCat-2.0)
>
> Архитектура, рекомендации по развёртыванию и сведения о модели.

> [card] [Секреты](https://docs2.openclaw.ai/ru/gateway/secrets.md)
>
> Хранение учётных данных провайдера без добавления открытого текста в конфигурацию.