LongCat Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: LongCat
개요
이 페이지는 OpenClaw LongCat provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: LongCat API setup for LongCat-2.0
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider | longcat |
| Auth | LONGCAT_API_KEY |
| API | OpenAI-compatible Chat Completions |
| Base URL | https://api.longcat.chat/openai |
| Model | longcat/LongCat-2.0 |
| Context | 1,048,576 tokens |
| Max output | 131,072 tokens |
| Input | Text |
공식 문서 기반 상세
아래는 공식 providers/longcat 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
LongCat provides a hosted API for LongCat-2.0, a
reasoning model built for coding and agentic workloads. OpenClaw provides the
official longcat plugin for LongCat's OpenAI-compatible endpoint.
| Property | Value |
|---|---|
| Provider | longcat |
| Auth | LONGCAT_API_KEY |
| API | OpenAI-compatible Chat Completions |
| Base URL | https://api.longcat.chat/openai |
| Model | longcat/LongCat-2.0 |
| Context | 1,048,576 tokens |
| Max output | 131,072 tokens |
| Input | Text |
Install plugin
Install the official package, then restart Gateway:
openclaw plugins install @openclaw/longcat-provider
openclaw gateway restart
시작하기
Create an API key
Sign in to the [LongCat API Platform](https://longcat.chat/platform/) and
create a key on the [API Keys](https://longcat.chat/platform/api_keys)
page.
Run onboarding
```bash
openclaw onboard --auth-choice longcat-api-key
```
Verify the model
```bash
openclaw models list --provider longcat
```
Onboarding adds the hosted catalog and selects longcat/LongCat-2.0 when no
primary model is already configured.
Non-interactive setup
openclaw onboard --non-interactive \
--mode local \
--auth-choice longcat-api-key \
--longcat-api-key "$LONGCAT_API_KEY"
Reasoning behavior
LongCat exposes binary thinking control. OpenClaw maps enabled thinking levels
to thinking: { type: "enabled" } and /think off to
thinking: { type: "disabled" }. LongCat does not currently document
reasoning_effort, so OpenClaw does not send it.
LongCat returns reasoning in reasoning_content. OpenClaw preserves that field
when replaying assistant tool-call turns so multi-turn agent sessions retain
the provider's expected message shape.
Pricing
The built-in catalog uses LongCat's pay-as-you-go list prices in USD per million tokens: $0.75 uncached input, $0.015 cached input, and $2.95 output. LongCat may offer temporary discounts; the pricing page and your billing records are authoritative.
Self-hosted LongCat-2.0
The longcat provider targets LongCat's hosted API. For the open weights on
Hugging Face, serve the
model through an OpenAI-compatible runtime and use OpenClaw's existing
vLLM or SGLang provider instead.
Keep the runtime's exact model identifier in the self-hosted provider catalog;
do not route a local deployment through longcat/LongCat-2.0.
문제 해결
The key works in a shell but not in the Gateway
Daemon-managed Gateway processes do not inherit every interactive shell
variable. Put `LONGCAT_API_KEY` in `~/.openclaw/.env`, configure it through
onboarding, or use an approved secret reference.
Requests fail with 402 or 429
`402` means the account has insufficient token quota. `429` means the API
key hit a rate limit. Check [LongCat usage](https://longcat.chat/platform/usage)
and retry rate-limited requests after the provider's backoff window.
The model does not appear
Run `openclaw plugins list` and confirm the `longcat` plugin is
enabled, then run `openclaw models list --provider longcat`.
관련 문서
Provider configuration, model refs, and failover behavior.
Hosted API endpoints, authentication, limits, and examples.
Architecture, deployment guidance, and model details.
Store provider credentials without embedding plaintext in config.
검증 체크리스트
-
openclaw models list --provider longcat로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토