mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-16 12:16:37 +00:00
bf8626c0e9
* 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
130 lines
4.6 KiB
Markdown
130 lines
4.6 KiB
Markdown
---
|
|
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 \
|
|
--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/LongCat-2.0.html)
|
|
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>
|