Providers

Together AI

Together AI provides access to leading open-source models including Llama, DeepSeek, Kimi, and more through a unified API.

Property	Value
Provider	`together`
Auth	`TOGETHER_API_KEY`
API	OpenAI-compatible
Base URL	`https://api.together.xyz/v1`

Getting started

Get an API key

Create an API key at api.together.ai/settings/api-keys.

Run onboarding

bash

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

Set a default model

json5

{  agents: {    defaults: {      model: {        primary: "together/meta-llama/Llama-3.3-70B-Instruct-Turbo",      },    },  },}

Non-interactive example

bash

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

Built-in catalog

OpenClaw ships this bundled Together catalog:

Model ref	Name	Input	Context	Notes
`together/meta-llama/Llama-3.3-70B-Instruct-Turbo`	Llama 3.3 70B Instruct Turbo	text	131,072	Default model
`together/moonshotai/Kimi-K2.6`	Kimi K2.6 FP4	text, image	262,144	Kimi reasoning model
`together/deepseek-ai/DeepSeek-V4-Pro`	DeepSeek V4 Pro	text	512,000	Reasoning text model
`together/Qwen/Qwen2.5-7B-Instruct-Turbo`	Qwen2.5 7B Instruct Turbo	text	32,768	Fast text model
`together/zai-org/GLM-5.1`	GLM 5.1 FP4	text	202,752	Reasoning text model

Video generation

The bundled together plugin also registers video generation through the shared video_generate tool.

Property	Value
Default video model	`together/Wan-AI/Wan2.2-T2V-A14B`
Modes	text-to-video; single-image reference only with `Wan-AI/Wan2.2-I2V-A14B`
Supported parameters	`aspectRatio`, `resolution`

To use Together as the default video provider:

json5

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

Environment note

If the Gateway runs as a daemon (launchd/systemd), make sure TOGETHER_API_KEY is available to that process (for example, in ~/.openclaw/.env or via env.shellEnv).

Troubleshooting

Verify your key works: openclaw models list --provider together
If models are not appearing, confirm the API key is set in the correct environment for your Gateway process.
Model refs use the form together/<model-id>.

Model selection

Provider rules, model refs, and failover behavior.

Video generation

Shared video generation tool parameters and provider selection.

Configuration reference

Full config schema including provider settings.

Together AI

Together AI dashboard, API docs, and pricing.

Was this useful?