LongCat

LongCat-2.0 的 LongCat API 设置

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-provider
openclaw gateway restart

入门指南

创建 API key

运行新手引导

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。