提供商
LongCat
LongCat 为 LongCat-2.0 提供托管 API。LongCat-2.0 是一款面向编程和智能体工作负载构建的推理模型。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 tokens |
| 最大输出 | 131,072 tokens |
| 输入 | 文本 |
安装插件
安装官方软件包，然后重启 Gateway 网关：
openclaw plugins install @openclaw/longcat-provideropenclaw gateway restart入门指南
创建 API key
登录 LongCat API 平台，并在 API Keys 页面创建密钥。
运行新手引导
openclaw onboard --auth-choice longcat-api-key验证模型
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 在重放助手工具调用轮次时会保留该字段，以便多轮智能体会话维持提供商预期的消息结构。
定价
内置目录采用 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 路由本地部署。
故障排查
密钥在 shell 中有效，但在 Gateway 网关中无效
由守护进程管理的 Gateway 网关进程不会继承交互式 shell 中的所有变量。请将
LONGCAT_API_KEY 放入 ~/.openclaw/.env，通过新手引导进行配置，或使用已批准的 secret 引用。
请求因 402 或 429 失败
402 表示账户的 token 配额不足。429 表示 API
key 触发了速率限制。请检查 LongCat 用量，并在提供商的退避等待时间结束后重试受速率限制的请求。
模型未显示
运行 openclaw plugins list 并确认 longcat 插件已启用，然后运行
openclaw models list --provider longcat。
