openclaw/docs/providers/longcat.md

Multi-channel AI gateway with extensible messaging integrations

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

[LongCat](https://longcat.ai) 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:

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

## Getting started

<Steps>
  <Step title="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.
  </Step>
  <Step title="Run onboarding">
    ```bash
    openclaw onboard --auth-choice longcat-api-key
    ```
  </Step>
  <Step title="Verify the model">
    ```bash
    openclaw models list --provider longcat
    ```
  </Step>
</Steps>

Onboarding adds the hosted catalog and selects `longcat/LongCat-2.0` when no
primary model is already configured.

### Non-interactive setup

```bash
openclaw onboard --non-interactive --accept-risk --skip-health \
  --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](https://longcat.chat/platform/docs/pricing/long-cat-2.0)
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](https://huggingface.co/meituan-longcat/LongCat-2.0), serve the
model through an OpenAI-compatible runtime and use OpenClaw's existing
[vLLM](/providers/vllm) or [SGLang](/providers/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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="The model does not appear">
    Run `openclaw plugins list` and confirm the `longcat` plugin is
    enabled, then run `openclaw models list --provider longcat`.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
    Provider configuration, model refs, and failover behavior.
  </Card>
  <Card title="LongCat API docs" href="https://longcat.chat/platform/docs/" icon="arrow-up-right-from-square">
    Hosted API endpoints, authentication, limits, and examples.
  </Card>
  <Card title="LongCat-2.0 model card" href="https://huggingface.co/meituan-longcat/LongCat-2.0" icon="arrow-up-right-from-square">
    Architecture, deployment guidance, and model details.
  </Card>
  <Card title="Secrets" href="/gateway/secrets" icon="key">
    Store provider credentials without embedding plaintext in config.
  </Card>
</CardGroup>