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

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

Set a default model

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

Non-interactive example

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/moonshotai/Kimi-K2.5`	Kimi K2.5	text, image	262,144	Default model; reasoning enabled
`together/zai-org/GLM-4.7`	GLM 4.7 Fp8	text	202,752	General-purpose text model
`together/meta-llama/Llama-3.3-70B-Instruct-Turbo`	Llama 3.3 70B Instruct Turbo	text	131,072	Fast instruction model
`together/meta-llama/Llama-4-Scout-17B-16E-Instruct`	Llama 4 Scout 17B 16E Instruct	text, image	10,000,000	Multimodal
`together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8`	Llama 4 Maverick 17B 128E Instruct FP8	text, image	20,000,000	Multimodal
`together/deepseek-ai/DeepSeek-V3.1`	DeepSeek V3.1	text	131,072	General text model
`together/deepseek-ai/DeepSeek-R1`	DeepSeek R1	text	131,072	Reasoning model
`together/moonshotai/Kimi-K2-Instruct-0905`	Kimi K2-Instruct 0905	text	262,144	Secondary Kimi 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
Supported parameters	`aspectRatio`, `resolution`

To use Together as the default video provider:

{
  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 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.