在 OpenClaw 中接入 LongCat-2.0插件安装、认证配置、推理行为与自托管指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本篇指南围绕 OpenClaw 官方 LongCat 插件展开讲解如何将 LongCat 托管的 LongCat-2.0 推理模型接入 OpenClaw 的模型提供商体系从插件安装、API Key 认证交互式与无人值守两种 onboard 方式、模型验证到 LongCat 特有的二元思考binary thinking控制如何在请求中被映射、reasoning_content如何被保留以及定价与自托管替代方案。读完本文你将能够在 OpenClaw 中配置并使用longcat/LongCat-2.0并理解其与通用 OpenAI 兼容提供商在请求形态上的关键差异。提供商概览LongCatlongcat.ai提供 LongCat-2.0 的托管 API。LongCat-2.0 是一个面向编码与 Agent 工作负载设计的推理模型。OpenClaw 通过官方 LongCat 插件接入 LongCat 的 OpenAI 兼容端点关键属性如下属性值ProviderlongcatAuthLONGCAT_API_KEYAPIOpenAI-compatible Chat CompletionsBase URLhttps://api.longcat.chat/openaiModellongcat/LongCat-2.0Context1,048,576 tokensMax output131,072 tokensInputText这些参数直接来自插件清单文件 extensions/longcat/openclaw.plugin.jsonbaseUrl为https://api.longcat.chat/openaiapi为openai-completions模型条目声明了contextWindow: 1048576、maxTokens: 131072、input: [text]以及reasoning: true。模型引用常量在 extensions/longcat/models.ts 中定义为LONGCAT_DEFAULT_MODEL_REF longcat/LongCat-2.0。插件注册入口 extensions/longcat/index.ts 中catalog配置为{ liveModelDiscovery: true, discoveryMode: strict }即支持实时模型发现并以严格模式执行。兼容性细节清单中compat字段刻画了 LongCat 端点与标准 OpenAI 端点的差异这些差异直接影响请求构造与消息回放supportsStore: false不支持store参数supportsDeveloperRole: false不支持developer角色消息supportsReasoningEffort: false不支持reasoning_effort参数见下文“推理行为”一节插件会主动移除该字段supportsUsageInStreaming: false流式响应中不携带 usage 统计supportsStrictMode: false不支持 strict 模式maxTokensField: max_tokens输出上限字段名为max_tokensrequiresReasoningContentOnAssistantMessages: true助手消息必须携带reasoning_content字段见下文推理行为thinkingFormat: deepseek思考内容采用 DeepSeek 风格字段reasoning_content。这些声明既服务于请求构造也服务于会话回放的消息校验是 LongCat 与普通 OpenAI 兼容端点行为差异的权威依据。安装插件安装官方插件包然后重启 Gatewayopenclaw plugins install openclaw/longcat-provider openclaw gateway restart插件清单openclaw.plugin.json中声明了enabledByDefault: true与activation: { onStartup: false }即插件默认启用但不在 Gateway 启动时被强制激活而是按需加载。安装后可用openclaw plugins list确认longcat插件处于启用状态。快速上手第一步创建 API Key登录 LongCat API Platform在 API Keys 页面创建密钥。之后在 OpenClaw 侧通过环境变量LONGCAT_API_KEY提供该密钥。第二步运行 onboardingopenclaw onboard --auth-choice longcat-api-key--auth-choice longcat-api-key对应插件清单中声明的认证选择项providerAuthChoices数组里的choiceId: longcat-api-key、optionKey: longcatApiKey、cliFlag: --longcat-api-key并归属于LONGCAT_API_KEY环境变量见 extensions/longcat/openclaw.plugin.json 中setup.providers与providerAuthChoices两段。第三步验证模型openclaw models list --provider longcatOnboarding 会将托管模型目录写入配置并在尚未配置主模型primary model时自动选中longcat/LongCat-2.0作为默认模型。从源码看onboarding 的配置写入逻辑在 extensions/longcat/onboard.tsapplyLongCatConfig/applyLongCatConnectionConfig通过createModelCatalogPresetAppliers与createProviderConnectionPresetAppliers生成预设preset包含primaryModelRef: longcat/LongCat-2.0、api: openai-completions、baseUrl与目录模型列表并为模型引用注册了别名LongCat 2.0。换言之一条 onboard 命令同时完成了“建立连接”与“写入模型目录”两件事。非交互式安装在 CI 或脚本化环境中可用以下一条命令完成全部配置openclaw onboard --non-interactive --accept-risk --skip-health \ --mode local \ --auth-choice longcat-api-key \ --longcat-api-key $LONGCAT_API_KEY其中--longcat-api-key直接对应清单中cliFlag: --longcat-api-key与optionKey: longcatApiKey允许将密钥以参数形式注入无需人工交互。推理行为LongCat 暴露的是二元思考控制binary thinking control而非像部分推理模型那样提供分级的reasoning_effort。OpenClaw 的映射规则如下启用思考thinking level 非off→ 请求中写入thinking: { type: enabled }/think offthinking level 为off→ 请求中写入thinking: { type: disabled }从请求中移除reasoning_effort字段LongCat 不支持该参数。该映射在流包装器 extensions/longcat/stream.ts 中实现createLongCatThinkingWrapper基于createPayloadPatchStreamWrapper对满足model.api openai-completions model.provider longcat的请求执行 payload 补丁payload.thinking { type: thinkingLevel off ? disabled : enabled }; delete payload.reasoning_effort;该包装器通过插件入口 extensions/longcat/index.ts 中的wrapStreamFn: (ctx) createLongCatThinkingWrapper(ctx.streamFn, ctx.thinkingLevel)挂接到流式请求链路。此外LongCat 将推理内容放在reasoning_content字段返回。OpenClaw 在回放replay助手工具调用轮次时会保留该字段从而保证多轮 Agent 会话维持提供商期望的消息形态。这一点与清单中的thinkingFormat: deepseek和requiresReasoningContentOnAssistantMessages: true相互印证也和入口处buildProviderReplayFamilyHooks({ family: openai-compatible, dropReasoningFromHistory: false })的设置一致——dropReasoningFromHistory: false意味着历史消息中的推理内容不会被丢弃回放时得以保留。插件测试 extensions/longcat/index.test.ts 覆盖了上述行为它验证提供商注册信息id: longcat、别名meituan-longcat、envVars: [LONGCAT_API_KEY]、认证向导choiceId: longcat-api-key、托管模型目录LongCat-2.0、reasoning: true、contextWindow: 1_048_576、maxTokens: 131_072以及流式请求的线格式兼容性可作为理解该插件行为的直接参考。定价内置模型目录采用 LongCat 按量付费pay-as-you-go列表价以美元/百万 tokens 计未命中缓存的输入uncached input$0.75命中缓存的输入cached input$0.015输出output$2.95价格数据在 extensions/longcat/openclaw.plugin.json 的cost字段中登记input: 0.75、output: 2.95、cacheRead: 0.015、cacheWrite: 0。LongCat 可能不定期提供临时折扣最终以 LongCat 的定价页面与你的账单记录为准。自托管 LongCat-2.0longcat提供商面向 LongCat 的托管 API。若希望自行部署 LongCat-2.0 的开源权重Hugging Face 上的 meituan-longcat/LongCat-2.0 或 SGLang 提供商 接入而不是走longcat提供商。两个要点在自托管提供商目录中务必保留运行时使用的精确模型标识符即 vLLM/SGLang 实际加载的模型名不要把你的本地部署路由到longcat/LongCat-2.0这个引用上——该引用指向 LongCat 托管端点混用会导致请求被错误路由或行为不一致自托管场景的思考控制、消息格式与托管 API 可能存在差异应以你选择的推理运行时vLLM/SGLang实际支持的参数为准并参考对应的提供商文档。故障排查以下是官方文档给出的三类常见问题与处理方式密钥在 shell 里有效但 Gateway 里无效Daemon 托管的 Gateway 进程不会继承交互式 shell 的每个环境变量。请将LONGCAT_API_KEY写入~/.openclaw/.env或通过 onboarding 配置或使用受支持的密钥引用secret reference方式注入。请求返回 402 或 429402账户 token 配额不足insufficient token quota429API Key 触发速率限制。可前往 LongCat usage 页面查看用量速率限制类请求在提供方的退避窗口backoff window结束后重试。模型没有出现在模型列表中先运行openclaw plugins list确认longcat插件已启用再运行openclaw models list --provider longcat检查模型目录是否写入成功。延伸阅读模型提供商概念提供商配置、模型引用与故障转移failover行为LongCat API 文档托管端点的认证、限制与示例LongCat-2.0 模型卡架构、部署指引与模型细节Secrets 指南在不以明文写入配置的前提下存储提供商凭据。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考