OpenClaw Together 模型提供商插件完全指南：接入、模型目录与视频生成-迪斯科星球

OpenClaw Together 模型提供商插件完全指南：接入、模型目录与视频生成

【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw

Together AI 通过统一 API 提供 Llama、DeepSeek、Kimi、GLM 等主流开源模型的托管推理服务，而 OpenClaw 将其以together提供商的形式内置集成。本文以 docs/providers/together.md 为主线，结合 extensions/together 插件的源码实现，系统讲解认证接入、默认模型配置、内置模型目录、OpenAI 兼容 API 特性，以及基于共享video_generate工具的视频生成能力，读完即可在 OpenClaw 中完成 Together 提供商从安装、鉴权到文本与视频生成的全流程配置与排障。

插件概览：Distribution 与 Surface

together是随 OpenClaw 一起分发的内置插件，无需单独安装，对应插件参考文档位于 docs/plugins/reference/together.md。

维度	值
包名	`@openclaw/together-provider`
安装方式	随 OpenClaw 内置（included in OpenClaw）
Provider ID	`together`
Contracts	`videoGenerationProviders`

从源码看，插件入口文件 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）：

属性	值
Provider	`together`
Auth 环境变量	`TOGETHER_API_KEY`
API 类型	OpenAI 兼容（`openai-completions`）
Base URL	`https://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-Turbo`	Llama 3.3 70B Instruct Turbo	text	131,072	8,192	1.04 / 1.04	通用模型
`together/moonshotai/Kimi-K2.6`	Kimi K2.6 FP4	text, image	262,144	32,768	1.20 / 4.50	默认模型
`together/deepseek-ai/DeepSeek-V4-Pro`	DeepSeek V4 Pro	text	512,000	384,000	1.74 / 3.48	推理模型
`together/zai-org/GLM-5.2`	GLM 5.2 FP4	text	262,144	131,072	1.40 / 4.40	推理模型

在插件清单里，每个模型还带有更细的字段，源码中同样如实登记：

Kimi K2.6 FP4：reasoning: 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 Pro：reasoning: true，上下文 512,000 token，最大输出高达 384,000 token，成本输入 1.74、输出 3.48，并标记compat.codeMode: "capable"，表示可胜任代码模式任务。
GLM 5.2 FP4：reasoning: 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`（解析为`<width>x<height>`）；`aspectRatio`/`resolution`不生效

上述能力在 extensions/together/video-generation-provider.ts 的buildTogetherVideoGenerationProvider中有完整对应：maxVideos: 1（单次最多生成 1 条视频）、maxDurationSeconds: 10、supportsSize: true；imageToVideo仅对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 秒范围内（asSafeIntegerInRange）；
size参数按/^(\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>的形式。

企业官网建设流程全解析