OpenClaw 接入 Cohere：官方 Provider 插件安装、认证与模型目录全解析

OpenClaw 接入 Cohere官方 Provider 插件安装、认证与模型目录全解析【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本篇指南完整讲解 OpenClaw 官方 Cohere Provider 插件openclaw/cohere-provider的安装、API Key 认证、onboarding 流程与内置模型目录并深入插件源码揭示system→developer消息改写、tool_choice清理、reasoning effort 映射与实时模型发现等底层实现。读完本文你将能在一分钟内让 OpenClaw 网关接入 Cohere 的 OpenAI 兼容推理服务并理解如何选择与调优 Command A 系列及 North Mini Code 模型。插件定位与核心属性OpenClaw 通过官方扩展插件的形式接入 Cohere 的Compatibility APIOpenAI 兼容接口而非 Cohere 原生 API。这意味着请求的构造、流式解析、工具调用等均复用 OpenClaw 的openai-completions传输层插件只需做针对性的兼容适配。以下属性来自 扩展插件目录 下的 插件清单 openclaw.plugin.json 与官方文档 docs/providers/cohere.md属性值Provider idcohere插件包名openclaw/cohere-provider认证环境变量COHERE_API_KEYOnboarding 认证选项--auth-choice cohere-api-key直接 CLI 参数--cohere-api-key keyAPI 类型OpenAI-compatibleopenai-completionsBase URLhttps://api.cohere.ai/compatibility/v1默认模型cohere/command-a-plus-05-2026默认上下文窗口128,000 tokens插件 API 兼容要求 2026.9.2见 package.json宿主最低版本 2026.6.8从源码看插件在 index.ts 中通过defineSingleProviderPluginEntry声明为单 Provider 插件将清单manifest、认证应用器applyCohereConfig、模型目录catalog、流包装函数wrapCohereProviderStream统一注册给运行时。清单中enabledByDefault: true即插件随官方插件集默认启用activation.onStartup为false按需激活不影响网关启动开销。安装与启用在原文档 README 中安装只需两步openclaw plugins install openclaw/cohere-provider openclaw gateway restartgateway restart是必须的插件目录、Provider 注册与模型目录均在网关进程启动时装载安装后不重启网关不会生效。安装来源方面package.json 的openclaw.install字段同时声明了 ClawHub 规范clawhub:openclaw/cohere-provider与 npm 规范openclaw/cohere-provider并以 npm 为默认渠道发布目标同时包含 ClawHub 与 npmpublishToClawHub: true、publishToNpm: true。认证两种配置路径路径一交互式/命令行 onboarding推荐前往 Cohere 控制台创建 API Key运行 onboarding显式传入认证选项与密钥openclaw onboard --non-interactive --accept-risk --skip-health \ --auth-choice cohere-api-key \ --cohere-api-key $COHERE_API_KEY其中--auth-choice cohere-api-key对应清单providerAuthChoices[0].choiceId该选项还携带appGuidedSecret: true支持应用引导式密钥录入--cohere-api-key key是清单声明的直接 CLI 选项cliOption字段名optionKey: cohereApiKey--non-interactive、--accept-risk、--skip-health用于无人值守环境。认证方式在插件注册与测试中均被验证为 API Key 类型测试 index.test.ts 断言了provider.auth中唯一的 onboarding choice 是cohere-api-key且环境变量为COHERE_API_KEY。路径二纯环境变量在网关进程中设置COHERE_API_KEY然后在配置文件中把主模型指向 Cohere见下文配置示例。此时无需运行 onboarding。注意daemon/Docker 场景如果网关以守护进程或 Docker 方式运行必须把COHERE_API_KEY写入该服务的环境。仅在交互式 shell 里export不会让已运行的网关读到。配置示例选择 Cohere 主模型无论走哪条认证路径最终都需要在 OpenClaw 配置中选择模型。将agents.defaults.model.primary指向 Cohere 模型引用即可JSON5 格式与 docs/providers/cohere.md 的环境变量章节一致{ agents: { defaults: { model: { primary: cohere/command-a-plus-05-2026 }, }, }, }配置完成后可用以下命令确认目录可见openclaw models list --provider cohere关于 onboarding 对已有配置的影响onboard.test.ts 给出了三个关键行为仅在无主模型时才设为 primary若配置中已有primary: openai/gpt-5.5onboarding 不会覆盖只会追加 Cohere 默认模型的别名条目Cohere Command A保留用户手写的模型条目无论models.mode为undefined还是merge用户在models.providers.cohere.models中手写的行都会被原样保留models.mode: replace时写入内置目录因为 replace 模式会跳过模型发现discovery此时 onboarding 会把清单中的 5 个内置模型完整写入配置保证开箱即用。内置模型目录详解插件清单 openclaw.plugin.json 内置了 5 个模型与官方文档目录一致模型引用名称可见性输入上下文最大输出推理说明cohere/command-a-plus-05-2026Command Avisibletext, image128,00064,000支持默认模型旗舰 agentic reasoning 模型cohere/command-a-03-2025Command Ahiddentext256,0008,000否上一代已被 Command A 取代cohere/command-a-reasoning-08-2025Command A Reasoninghiddentext256,00032,000支持上一代已被 Command A 取代cohere/command-a-vision-07-2025Command A Visionhiddentext, image128,0008,000否上一代已被 Command A 取代不支持工具调用cohere/north-mini-code-1-0North Mini Code 1.0visibletext, image256,00064,000支持Agentic 编程模型免费额度各模型的cost字段在清单中均为0其中 Command A、Command A Reasoning、North Mini Code 三个模型的输入/输出单价为 0使用与否请以 Cohere 官方计费为准仓库内的 0 值仅代表该处静态目录未填充价格。可见性差异visible的模型Command A 与 North Mini Code直接面向用户选择hidden的模型虽不主推但保留了向后兼容的引用能力——它们都在清单中标记了status: deprecated与replacedBy: command-a-plus-05-2026建议新会话统一迁移到 Command A。Reasoning effort 映射推理型 Cohere 模型Command A、Command A Reasoning、North Mini Code的 Compatibility API 只支持两档推理力度。插件通过清单中compat.reasoningEffortMap把 OpenClaw 的 9 档思维水平全部映射到 Cohere 侧OpenClaw 档位Cohere 实际值off/nonenoneminimal/low/medium/high/xhigh/adaptive/maxhigh即关映射为none其余所有开启档统一映射为high。测试 index.test.ts 验证了这一映射对north-mini-code-1-0reasoning: off产生reasoning_effort: nonereasoning: high产生reasoning_effort: high对 Command A 与 Command A Reasoningmedium同样映射为high。工具调用的特殊处理Compatibility API 下工具支持因模型而异Command A Vision 明确不支持工具清单compat.supportsTools: false因此 OpenClaw 对视觉模型保持 agent 工具关闭而现代 sweep现代模型批量任务只向支持工具且非弃用的当前模型开放。测试断言isModernModelRef对command-a-plus-05-2026与command-a-reasoning-08-2025返回true对command-a-03-2025与 Command A Vision 返回false——这与 models.ts 中COHERE_MODERN_MODEL_IDS集合Command A、Command A Reasoning、North Mini Code一致。源码注释还指出现代 sweep 需要 agent 工具使用能力而 Vision 模型不支持工具故被排除。源码级原理流式请求的兼容性适配Cohere 插件的核心价值在于 stream.ts 中对请求 payload 的两处改写这两处适配均有测试覆盖index.test.ts1.system角色改写为developerCohere Compatibility API 使用developer而非system角色承载指令。wrapCohereProviderStream遍历payload.messages将所有role system的消息重写为role: developer内容保持不变。测试断言改写后的消息数组中存在{ role: developer, content: system }且不再存在任何system角色消息。2. 删除tool_choiceCohere 允许支持工具的模型在省略tool_choice时自行决定是否调用工具。为把工具选择的自主权交还给模型而非由 OpenClaw 强制指定包装器直接delete payload.tool_choice。测试确认生成 payload 中不包含tool_choice字段。3. 字段级兼容约束来自清单compat配置与测试断言最大输出字段使用max_tokensmaxTokensField: max_tokens而非max_completion_tokens不支持store与会话存储supportsStore: false不支持流式 usagesupportsUsageInStreaming: false测试验证 payload 中不含max_completion_tokens、store、stream_options。wrapCohereProviderStream同时被注册为普通流wrapStreamFn与简单补全流wrapSimpleCompletionStreamFn的包装器index.ts确保两类调用路径获得一致的改写。实时模型发现机制除静态目录外插件还支持可刷新的实时模型发现清单modelCatalog.discovery.cohere: refreshable。provider-catalog.ts 定义发现端点https://api.cohere.com/v1/models?endpointchatpage_size1000要求当前 provider 的 baseUrl 必须与清单一致requireBaseUrl防止自定义 baseUrl 指向其它服务时误用 Cohere 官方发现接口行归一化readRows从响应体的models[]数组读取模型对每个对象取name字段作为id并以is_deprecated ! true推导active状态。测试用两条虚拟记录验证了归一化逻辑index.test.tsis_deprecated: false的模型得到active: true并保留context_length等原始字段is_deprecated: true的模型得到active: false。这意味着当 Cohere 发布新模型时刷新发现即可在openclaw models list中看到无需升级插件。测试与验证清单插件配套两组 Vitest 测试可作为接入自检依据index.test.ts认证注册choiceId、envVars、静态目录内容、实时发现归一化、payload 字段max_tokens、无store/stream_options/tool_choice、developer角色改写、reasoning effort 映射、现代 sweep 模型可见性onboard.test.tsonboarding 预设写入的 baseUrl/api/模型顺序、无主模型时才接管 primary、replace/merge模式下用户手写模型条目的保留行为。快速排查要点模型不在列表确认插件已安装并openclaw gateway restart确认COHERE_API_KEY在网关进程环境中daemon/Docker 场景务必写入服务环境推理档位异常Cohere 侧只接受none/highOpenClaw 的中间档会被归一为high这是设计行为而非配置错误视觉模型无工具使用command-a-vision-07-2025时 agent 工具自动关闭需要工具调用请切换到 Command A 或 North Mini Code发现接口报错COHERE_LIVE_MODEL_DISCOVERY要求 baseUrl 与清单一致requireBaseUrl: https://api.cohere.ai/compatibility/v1自定义 baseUrl 会绕过官方发现端点此时依赖静态目录。相关文档导航官方 Provider 文档docs/providers/cohere.md插件入口与清单extensions/cohere/index.ts、extensions/cohere/openclaw.plugin.json目录与 onboarding 实现extensions/cohere/models.ts、extensions/cohere/onboard.ts流式适配与实时发现extensions/cohere/stream.ts、extensions/cohere/provider-catalog.ts测试用例extensions/cohere/index.test.ts、extensions/cohere/onboard.test.ts【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考