Together AI

Together AI provides access to leading open-source models including Llama, DeepSeek, Kimi, and more through a unified API. OpenClaw bundles it as the together provider.

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

Getting started

1. Get an API key

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

2. Run onboarding

   openclaw onboard --auth-choice together-api-key
   
3. Set a default model

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

Non-interactive example

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

Onboarding sets together/meta-llama/Llama-3.3-70B-Instruct-Turbo as the default model.

Built-in catalog

Cost is USD per million tokens.

Model ref	Name	Input	Context	Max output	Cost (in/out)	Notes
together/meta-llama/Llama-3.3-70B-Instruct-Turbo	Llama 3.3 70B Instruct Turbo	text	131,072	8,192	0.88 / 0.88	Default model
together/moonshotai/Kimi-K2.6	Kimi K2.6 FP4	text, image	262,144	32,768	1.20 / 4.50	Reasoning model
together/deepseek-ai/DeepSeek-V4-Pro	DeepSeek V4 Pro	text	512,000	8,192	2.10 / 4.40	Reasoning model
together/Qwen/Qwen2.5-7B-Instruct-Turbo	Qwen2.5 7B Instruct Turbo	text	32,768	8,192	0.30 / 0.30	Fast, non-reasoning
together/zai-org/GLM-5.1	GLM 5.1 FP4	text	202,752	8,192	1.40 / 4.40	Reasoning model

Video generation

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

Property	Value
Default video model	Wan-AI/Wan2.2-T2V-A14B
Other models	Wan-AI/Wan2.2-I2V-A14B, minimax/Hailuo-02, Kwai/Kling-2.1-Master
Modes	text-to-video; image-to-video only with Wan-AI/Wan2.2-I2V-A14B (single reference image)
Duration	1-10 seconds
Supported parameters	size (parsed as <width>x<height>); aspectRatio/resolution are not read

To use Together as the default video provider:

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

See Video generation for the shared tool parameters, provider selection, and failover behavior.

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

Keys set only in your interactive shell are not visible to daemon-managed gateway processes. Use ~/.openclaw/.env or env.shellEnv config for persistent availability.

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

Related

Model providers

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.