快速开始
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 个 token |
| 最大输出 | 131,072 个 token |
| 输入 | 文本 |
安装插件
安装官方软件包，然后重启 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，通过新手引导进行配置，或使用经批准的密钥引用。
请求因 402 或 429 失败
402 表示账户的 token 配额不足。429 表示 API key 达到了速率限制。请检查 LongCat 用量，并在提供商的退避时间窗口结束后重试受速率限制的请求。
模型未显示
运行 openclaw plugins list 并确认 longcat 插件已启用，然后运行 openclaw models list --provider longcat。
