在 OpenClaw 中配置 Together AI provider 后，可通过统一 API 调用 Llama、DeepSeek、Kimi 等开源模型。关键操作：通过 openclaw onboard --auth-choice together-api-key 交互式或 --non-interactive 非交互式完成认证；默认模型为 together/moonshotai/Kimi-K2.5。若 Gateway 以 launchd/systemd 守护进程运行，需将 TOGETHER_API_KEY 写入 ~/.openclaw/.env 或通过 env.shellEnv 配置，否则密钥不会自动可用。内置模型列表和视频生成工具（默认模型 together/Wan-AI/Wan2.2-T2V-A14B）可直接使用。

OpenClaw 接入 Together AI：配置步骤与模型选择

Together AI 通过统一的 OpenAI 兼容 API 提供 Llama、DeepSeek、Kimi 等主流开源模型的访问。

属性	值
Provider	`together`
认证方式	`TOGETHER_API_KEY`
API 类型	OpenAI-compatible
Base URL	`https://api.together.xyz/v1`

快速上手

获取 API Key
在 api.together.ai/settings/api-keys 创建。

运行交互式 onboarding

bash

openclaw onboard --auth-choice together-api-key

设置默认模型（可选，默认会自动配置）

json5

{
  agents: {
    defaults: {
      model: { primary: "together/moonshotai/Kimi-K2.5" },
    },
  },
}

非交互式配置示例

bash

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice together-api-key \
  --together-api-key "$TOGETHER_API_KEY"

INFO

onboarding 预设会将 together/moonshotai/Kimi-K2.5 设为默认模型。

内置模型列表

OpenClaw 内置了以下 Together 模型目录：

模型引用	名称	输入	上下文	说明
`together/moonshotai/Kimi-K2.5`	Kimi K2.5	text, image	262,144	默认模型；支持推理
`together/zai-org/GLM-4.7`	GLM 4.7 Fp8	text	202,752	通用文本模型
`together/meta-llama/Llama-3.3-70B-Instruct-Turbo`	Llama 3.3 70B Instruct Turbo	text	131,072	快速指令模型
`together/meta-llama/Llama-4-Scout-17B-16E-Instruct`	Llama 4 Scout 17B 16E Instruct	text, image	10,000,000	多模态
`together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8`	Llama 4 Maverick 17B 128E Instruct FP8	text, image	20,000,000	多模态
`together/deepseek-ai/DeepSeek-V3.1`	DeepSeek V3.1	text	131,072	通用文本模型
`together/deepseek-ai/DeepSeek-R1`	DeepSeek R1	text	131,072	推理模型
`together/moonshotai/Kimi-K2-Instruct-0905`	Kimi K2-Instruct 0905	text	262,144	备选 Kimi 文本模型

视频生成

Together 插件还注册了通过共享 video_generate 工具的视频生成能力。

属性	值
默认视频模型	`together/Wan-AI/Wan2.2-T2V-A14B`
模式	text-to-video, single-image reference
支持的参数	`aspectRatio`, `resolution`

将 Together 设为默认视频提供者：

json5

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "together/Wan-AI/Wan2.2-T2V-A14B",
      },
    },
  },
}

TIP

参见 Video Generation 了解共享工具参数、provider 选择及故障转移行为。

环境变量说明

如果 Gateway 以守护进程（launchd/systemd）运行，请确保 TOGETHER_API_KEY 对该进程可见。

WARNING

仅在交互式 shell 中设置的环境变量对守护进程不可见。请使用 ~/.openclaw/.env 或 env.shellEnv 配置实现持久化。

故障排查

验证 API Key 是否有效：openclaw models list --provider together
如果模型未出现，检查 API Key 是否在 Gateway 进程的正确环境中设置。
模型引用格式为 together/<model-id>。

常见问题

环境变量 TOGETHER_API_KEY 设置了但 Gateway 仍然报错无法认证？

检查 Gateway 是否以守护进程（launchd/systemd）运行。守护进程无法读取交互式 shell 的环境变量。请将密钥写入 ~/.openclaw/.env 或通过 env.shellEnv 配置，然后重启 Gateway。

`openclaw models list --provider together` 没有返回任何模型？

确认 API Key 已正确设置且未被空格或换行符污染。另外，确保 Key 在当前 shell 中有效（可先 echo $TOGETHER_API_KEY 验证）。如果 Gateway 是守护进程，需确保 Key 在守护进程环境中也可见。

Together AI 视频生成怎么使用？

Together 自动注册了 video_generate 工具，默认模型为 together/Wan-AI/Wan2.2-T2V-A14B。你可以在智能体配置中通过 videoGenerationModel 指定该模型（见上文视频生成配置），然后在对话中触发视频生成工具。支持 text-to-video 和单图参考模式。

OpenClaw 接入 Together AI：配置步骤与模型选择 ​

快速上手 ​

非交互式配置示例 ​

内置模型列表 ​

视频生成 ​

环境变量说明 ​

故障排查 ​

相关文档 ​

常见问题 ​

环境变量 TOGETHER_API_KEY 设置了但 Gateway 仍然报错无法认证？ ​

openclaw models list --provider together 没有返回任何模型？ ​

Together AI 视频生成怎么使用？ ​