安装插件
安装官方包,然后重启 Gateway:开始使用
onboarding 会添加托管目录,并在尚未配置主模型时选择longcat/LongCat-2.0。
非交互式设置
推理行为
LongCat 提供二元思考控制。OpenClaw 将启用的思考级别映射为thinking: { type: "enabled" },并将 /think off 映射为
thinking: { type: "disabled" }。LongCat 目前没有记录
reasoning_effort,因此 OpenClaw 不会发送它。
LongCat 会在 reasoning_content 中返回推理内容。OpenClaw 在重放 assistant 工具调用轮次时会保留该字段,
以便多轮 agent 会话保持提供方期望的消息结构。
定价
内置目录使用 LongCat 按需付费的公开价格,以每百万个 token 的美元价格计费:0.015 缓存输入和 $2.95 输出。LongCat 可能会提供临时折扣;定价页面 和您的账单记录是权威依据。自托管 LongCat-2.0
longcat 提供商面向 LongCat 的托管 API。对于 Hugging Face 上的开源权重,请通过兼容 OpenAI 的运行时来提供该模型,并改用 OpenClaw 现有的 vLLM 或 SGLang 提供商。
请在自托管提供商目录中保留运行时的精确模型标识符;不要将本地部署路由到 longcat/LongCat-2.0。
故障排查
密钥在 shell 中可用,但在 Gateway 中不可用
密钥在 shell 中可用,但在 Gateway 中不可用
由守护进程管理的 Gateway 进程不会继承所有交互式 shell 变量。将
LONGCAT_API_KEY 放入 ~/.openclaw/.env,通过
onboarding 配置,或使用已批准的密钥引用。请求失败,返回 402 或 429
请求失败,返回 402 或 429
402 表示账户的 token 配额不足。429 表示 API
key 触发了速率限制。查看 LongCat 使用情况
并在提供方的退避窗口结束后重试受限请求。模型没有出现
模型没有出现
运行
openclaw plugins list 并确认 longcat 插件已
启用,然后运行 openclaw models list --provider longcat。相关
模型提供商
提供商配置、模型引用和故障转移行为。
LongCat API 文档
托管 API 端点、身份验证、限制和示例。
LongCat-2.0 模型卡片
架构、部署指南和模型详情。
密钥
存储提供商凭证,而无需将明文嵌入配置中。