快速开始
LongCat
LongCat 提供 LongCat-2.0 的托管 API，这是一个面向编码和智能体工作负载构建的推理模型。OpenClaw 为 LongCat 的 OpenAI 兼容端点提供官方 longcat 插件。
| 属性 | 值 |
|---|---|
| 提供商 | 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 |
| 输入 | 文本 |
安装插件
安装官方包，然后重启 Gateway 网关：
openclaw plugins install @openclaw/longcat-provideropenclaw gateway restart入门指南
Create an API key
登录 LongCat API Platform，并在 API Keys 页面创建一个密钥。
Run onboarding
openclaw onboard --auth-choice longcat-api-keyVerify the model
openclaw models list --provider longcat新手引导会添加托管目录，并在尚未配置主模型时选择 longcat/LongCat-2.0。
非交互式设置
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 在重放 assistant 工具调用轮次时会保留该字段，以便多轮智能体会话保留提供商预期的消息形状。
定价
内置目录使用 LongCat 的按量付费标价，单位为每百万 token 的美元价格：未缓存输入 $0.75，缓存输入 $0.015，输出 $2.95。LongCat 可能会提供临时折扣；定价页面和你的账单记录才是权威来源。
自托管 LongCat-2.0
longcat 提供商面向 LongCat 的托管 API。对于 Hugging Face 上的开放权重，请通过 OpenAI 兼容运行时提供该模型，并改用 OpenClaw 现有的 vLLM 或 SGLang 提供商。
在自托管提供商目录中保留运行时的确切模型标识符；不要通过 longcat/LongCat-2.0 路由本地部署。
故障排查
The key works in a shell but not in the Gateway
由守护进程管理的 Gateway 网关进程不会继承每个交互式 shell 变量。请将 LONGCAT_API_KEY 放入 ~/.openclaw/.env，通过新手引导配置它，或使用已批准的密钥引用。
Requests fail with 402 or 429
402 表示账户的 token 配额不足。429 表示 API 密钥触发了速率限制。检查 LongCat 用量，并在提供商的退避窗口结束后重试受速率限制的请求。
The model does not appear
运行 openclaw plugins list 并确认 longcat 插件已启用，然后运行 openclaw models list --provider longcat。
