docs/providers/together.md
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 |
openclaw onboard --non-interactive \
--mode local \
--auth-choice together-api-key \
--together-api-key "$TOGETHER_API_KEY"
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 |
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",
},
},
},
}
<Warning>
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.
</Warning>