Files
openclaw/docs/providers/longcat.md
Vincent Koc bf8626c0e9 feat(providers): add LongCat API support (#100501)
* fix(ai): honor provider reasoning compatibility

* feat(longcat): add hosted provider plugin

* chore(longcat): register package metadata

* docs(longcat): add provider setup guide

* docs(longcat): document self-hosted model routing

* refactor(longcat): externalize provider plugin

* chore(longcat): add npm release artifacts
2026-07-06 10:07:08 -07:00

4.6 KiB

summary, title, read_when
summary title read_when
LongCat API setup for LongCat-2.0 LongCat
You want to use LongCat-2.0 with OpenClaw
You need the LongCat API key or model limits

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

Getting started

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. ```bash openclaw onboard --auth-choice longcat-api-key ``` ```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.

Troubleshooting

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