OpenClaw Together 模型提供商插件完全指南接入、模型目录与视频生成【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawTogether AI 通过统一 API 提供 Llama、DeepSeek、Kimi、GLM 等主流开源模型的托管推理服务而 OpenClaw 将其以together提供商的形式内置集成。本文以 docs/providers/together.md 为主线结合 extensions/together 插件的源码实现系统讲解认证接入、默认模型配置、内置模型目录、OpenAI 兼容 API 特性以及基于共享video_generate工具的视频生成能力读完即可在 OpenClaw 中完成 Together 提供商从安装、鉴权到文本与视频生成的全流程配置与排障。插件概览Distribution 与 Surfacetogether是随 OpenClaw 一起分发的内置插件无需单独安装对应插件参考文档位于 docs/plugins/reference/together.md。维度值包名openclaw/together-provider安装方式随 OpenClaw 内置included in OpenClawProvider IDtogetherContractsvideoGenerationProviders从源码看插件入口文件 extensions/together/index.ts 通过defineSingleProviderPluginEntry注册了together提供商并完成两件事一是通过applyTogetherConnectionConfig把连接配置写入用户配置二是在register回调中调用api.registerVideoGenerationProvider(...)注册视频生成能力。插件清单 extensions/together/openclaw.plugin.json 声明了enabledByDefault: true因此仓库克隆后该提供商即默认可用并在contracts.videoGenerationProviders中登记了[together]。提供商基本属性与认证方式Together 提供商的核心参数如下来源docs/providers/together.md 及 extensions/together/openclaw.plugin.json属性值ProvidertogetherAuth 环境变量TOGETHER_API_KEYAPI 类型OpenAI 兼容openai-completionsBase URLhttps://api.together.xyz/v1插件清单通过setup.providers声明了它依赖的环境变量TOGETHER_API_KEY并在providerAuthChoices中注册了一个认证方式together-api-key对应 CLI 参数--together-api-key key。也就是说无论是交互式引导还是非交互式脚本认证入口都是统一的。在代码层面extensions/together/models.ts 从插件清单读取baseUrl得到TOGETHER_BASE_URL并将模型目录统一标记为api: openai-completions这印证了 Together 走 OpenAI 兼容协议的事实。快速开始获取密钥与运行 onboarding第一步创建 API Key前往 Together AI 控制台的 API Keys 页面创建密钥。该步骤需要你自己在 Together 平台完成OpenClaw 侧只负责保存与使用。第二步运行交互式引导openclaw onboard --auth-choice together-api-key执行后 onboarding 会引导你输入 Together API Key。从源码 extensions/together/onboard.ts 可以看到引导完成时会应用一个预设preset把TOGETHER_DEFAULT_MODEL_REF即together/moonshotai/Kimi-K2.6设为默认主模型写入providerId: together、api: openai-completions、baseUrl: TOGETHER_BASE_URL注册模型目录快照并为默认模型注册别名Together AI。第三步设置默认模型引导会自动把 Together 推荐聊天模型设为默认你也可以在配置文件中显式指定JSON5 格式{ agents: { defaults: { model: { primary: together/moonshotai/Kimi-K2.6, }, }, }, }非交互式示例在 CI、脚本等场景下可以用完全非交互的方式完成引导openclaw onboard --non-interactive --accept-risk --skip-health \ --mode local \ --auth-choice together-api-key \ --together-api-key $TOGETHER_API_KEY注意--mode local表示本地运行模式--accept-risk与--skip-health用于跳过风险确认与健康检查在实际使用前请确认这些开关符合你的运行环境与安全策略。内置模型目录OpenClaw 为 Together 内置了一份模型目录成本单位为每百万 token 的美元价格。下表来自 docs/providers/together.md并与 extensions/together/openclaw.plugin.json 中的modelCatalog.providers.together.models逐条对应Model ref名称输入上下文最大输出成本输入/输出说明together/meta-llama/Llama-3.3-70B-Instruct-TurboLlama 3.3 70B Instruct Turbotext131,0728,1921.04 / 1.04通用模型together/moonshotai/Kimi-K2.6Kimi K2.6 FP4text, image262,14432,7681.20 / 4.50默认模型together/deepseek-ai/DeepSeek-V4-ProDeepSeek V4 Protext512,000384,0001.74 / 3.48推理模型together/zai-org/GLM-5.2GLM 5.2 FP4text262,144131,0721.40 / 4.40推理模型在插件清单里每个模型还带有更细的字段源码中同样如实登记Kimi K2.6 FP4reasoning: true输入支持text与image两种模态上下文窗口 262,144 token最大输出 32,768 token成本输入 1.2、输出 4.5 美元/百万 token另有cacheRead: 0.2缓存读取价。Llama 3.3 70B Instruct Turbo纯文本输入上下文 131,072 token最大输出 8,192 token成本输入/输出均为 1.04。DeepSeek V4 Proreasoning: true上下文 512,000 token最大输出高达 384,000 token成本输入 1.74、输出 3.48并标记compat.codeMode: capable表示可胜任代码模式任务。GLM 5.2 FP4reasoning: true上下文 262,144 token最大输出 131,072 token成本输入 1.4、输出 4.4同样标记compat.codeMode: capable。模型引用统一采用together/model-id的形式例如together/deepseek-ai/DeepSeek-V4-Pro。另外extensions/together/openclaw.plugin.json 将discovery.together声明为refreshable同时在入口文件 extensions/together/index.ts 中设置了liveModelDiscovery: true与discoveryMode: strict这意味着除内置目录外OpenClaw 还可以向 Together 实时拉取更新的模型列表并采用严格模式处理发现结果。视频生成能力together插件除文本模型外还通过共享的video_generate工具注册了视频生成能力插件清单contracts.videoGenerationProviders: [together]即为此声明。关键参数属性值默认视频模型Wan-AI/Wan2.2-T2V-A14B其他可用模型Wan-AI/Wan2.2-I2V-A14B、minimax/hailuo-02、kwaivgI/kling-2.1-master模式文生视频仅Wan-AI/Wan2.2-I2V-A14B支持图生视频单张参考图时长1–10 秒支持的参数size解析为widthxheightaspectRatio/resolution不生效上述能力在 extensions/together/video-generation-provider.ts 的buildTogetherVideoGenerationProvider中有完整对应maxVideos: 1单次最多生成 1 条视频、maxDurationSeconds: 10、supportsSize: trueimageToVideo仅对Wan-AI/Wan2.2-I2V-A14B开放且最多 1 张输入图videoToVideo明确为enabled: false不支持视频转视频。底层实现要点从 extensions/together/video-generation-provider.ts 可以看到视频生成走的是 Together 的 v2 端点https://api.together.xyz/v2而非 v1 的文本补全端点默认超时 120 秒轮询间隔 5 秒最多轮询 120 次提交任务后返回videoId随后轮询/videos/{videoId}直到status completed任务失败时读取error.message抛出可读错误成功后下载生成的视频资产并受resolveGeneratedMediaMaxBytes(req.cfg, video)的大小限制约束时长参数会被安全地钳制在 1–10 秒范围内asSafeIntegerInRangesize参数按/^(\d)x(\d)$/正则解析为width/height字段传给上游因此aspectRatio与resolution这类参数不会被读取若传入视频引用输入会直接报错不支持视频参考输入若给非Wan-AI/Wan2.2-I2V-A14B模型传参考图也会抛出明确提示。将 Together 设为默认视频提供商{ agents: { defaults: { mediaModels: { video: { primary: together/Wan-AI/Wan2.2-T2V-A14B, }, }, }, }, }共享工具video_generate的完整参数、提供商选择与故障转移行为参见 docs/tools/video-generation.md。环境变量与守护进程注意事项如果 Gateway 以守护进程方式运行launchd / systemd务必确保TOGETHER_API_KEY对该进程可见例如写入~/.openclaw/.env或通过env.shellEnv配置注入。⚠️ 只写在交互式 shell 里的密钥对守护进程管理的 Gateway 是不可见的。持久化可用~/.openclaw/.env或env.shellEnv配置。故障排查验证密钥是否可用openclaw models list --provider together如果模型没有出现请确认 API Key 已设置在 Gateway 进程对应的正确环境中模型引用必须使用together/model-id的形式。相关文档与源码索引模型提供商的通用规则、模型引用与故障转移行为docs/concepts/model-providers.md共享视频生成工具参数与提供商选择docs/tools/video-generation.md完整配置 Schema含提供商设置docs/gateway/configuration-reference.md插件清单模型目录、认证选项、契约声明extensions/together/openclaw.plugin.json插件入口与视频生成注册extensions/together/index.ts引导/onboarding 预设逻辑extensions/together/onboard.ts模型目录与 Base URLextensions/together/models.ts视频生成提供商实现extensions/together/video-generation-provider.ts视频生成单元测试extensions/together/video-generation-provider.test.tsonboarding 测试extensions/together/onboard.test.ts整体来看together是 OpenClaw 中一个典型的内置单一提供商插件认证走TOGETHER_API_KEYtogether-api-key引导选项文本模型走 OpenAI 兼容的 v1 端点视频生成走 v2 任务式端点并在插件清单中集中维护模型目录与契约声明。理解其源码结构后你既能熟练完成日常配置也能在排查模型不出现、视频任务超时等问题时快速定位根因。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考