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