docs: concept annexation, provider/reference docs, ACT-1 groundwork
Mosaic concepts pages now own the adapted content; source/license metadata under docs/reference/concepts. Adds ACT-1 agent-context planning capture, pinned concept test package + preparation utility, foundation observation notes (durability, evidence, federation, onboarding, workflow), and the #1495 consolidation assessment. TOOLS.md updated for the host-dev launcher.
This commit is contained in:
@@ -0,0 +1,129 @@
|
||||
---
|
||||
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>
|
||||
Reference in New Issue
Block a user