> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LongCat

[LongCat](https://longcat.ai) 提供 LongCat-2.0 的託管 API，這是一個
為程式開發與代理式工作負載打造的推理模型。OpenClaw 提供官方
`longcat` 外掛，用於 LongCat 的 OpenAI 相容端點。

| 屬性     | 值                                 |
| ------ | --------------------------------- |
| 供應商    | `longcat`                         |
| 驗證     | `LONGCAT_API_KEY`                 |
| API    | OpenAI 相容的 Chat Completions       |
| 基礎 URL | `https://api.longcat.chat/openai` |
| 模型     | `longcat/LongCat-2.0`             |
| 上下文    | 1,048,576 個 token                 |
| 最大輸出   | 131,072 個 token                   |
| 輸入     | 文字                                |

## 安裝外掛

安裝官方套件，然後重新啟動閘道：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/longcat-provider
openclaw gateway restart
```

## 開始使用

<Steps>
  <Step title="Create an API key">
    登入 [LongCat API Platform](https://longcat.chat/platform/)，並在
    [API Keys](https://longcat.chat/platform/api_keys) 頁面建立金鑰。
  </Step>

  <Step title="Run onboarding">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice longcat-api-key
    ```
  </Step>

  <Step title="Verify the model">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider longcat
    ```
  </Step>
</Steps>

當尚未設定主要模型時，導覽設定會加入託管型目錄，並選取 `longcat/LongCat-2.0`。

### 非互動式設定

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice longcat-api-key \
  --longcat-api-key "$LONGCAT_API_KEY"
```

## 推理行為

LongCat 提供二元思考控制。OpenClaw 會將啟用的思考層級對應到
`thinking: { type: "enabled" }`，並將 `/think off` 對應到
`thinking: { type: "disabled" }`。LongCat 目前未記錄
`reasoning_effort`，因此 OpenClaw 不會傳送它。

LongCat 會在 `reasoning_content` 中回傳推理內容。OpenClaw 在重播助理工具呼叫回合時會保留該欄位，讓多回合代理工作階段維持供應商預期的訊息形狀。

## 價格

內建目錄使用 LongCat 以百萬 token 為單位、以美元計價的隨用隨付定價：未快取輸入 $0.75、已快取輸入 $0.015、輸出 \$2.95。LongCat 可能提供臨時折扣；[價格頁面](https://longcat.chat/platform/docs/Pricing/LongCat-2.0.html)
和你的帳單紀錄才是權威依據。

## 自行託管 LongCat-2.0

`longcat` 供應商目標是 LongCat 的託管 API。若要使用
[Hugging Face](https://huggingface.co/meituan-longcat/LongCat-2.0) 上的開放權重，請透過 OpenAI 相容執行階段提供模型，並改用 OpenClaw 現有的
[vLLM](/zh-TW/providers/vllm) 或 [SGLang](/zh-TW/providers/sglang) 供應商。

請在自行託管的供應商目錄中保留執行階段的確切模型識別碼；不要透過 `longcat/LongCat-2.0` 路由本機部署。

## 疑難排解

<AccordionGroup>
  <Accordion title="The key works in a shell but not in the Gateway">
    由守護程式管理的閘道程序不會繼承每個互動式 shell 變數。請將
    `LONGCAT_API_KEY` 放入 `~/.openclaw/.env`，透過導覽設定進行設定，或使用核准的密鑰參照。
  </Accordion>

  <Accordion title="Requests fail with 402 or 429">
    `402` 表示帳戶的 token 配額不足。`429` 表示 API 金鑰達到速率限制。請查看 [LongCat 用量](https://longcat.chat/platform/usage)，並在供應商的退避視窗後重試受速率限制的請求。
  </Accordion>

  <Accordion title="The model does not appear">
    執行 `openclaw plugins list` 並確認 `longcat` 外掛已啟用，然後執行 `openclaw models list --provider longcat`。
  </Accordion>
</AccordionGroup>

## 相關

<CardGroup cols={2}>
  <Card title="Model providers" href="/zh-TW/concepts/model-providers" icon="layers">
    供應商設定、模型參照與容錯移轉行為。
  </Card>

  <Card title="LongCat API docs" href="https://longcat.chat/platform/docs/" icon="arrow-up-right-from-square">
    託管 API 端點、驗證、限制與範例。
  </Card>

  <Card title="LongCat-2.0 model card" href="https://huggingface.co/meituan-longcat/LongCat-2.0" icon="arrow-up-right-from-square">
    架構、部署指引與模型詳細資訊。
  </Card>

  <Card title="Secrets" href="/zh-TW/gateway/secrets" icon="key">
    儲存供應商憑證，而不在設定中嵌入純文字。
  </Card>
</CardGroup>