Skip to main content

​
Together AI

Together AI provides access to leading open-source models including Llama, DeepSeek, Kimi, and more through a unified API.
PropertyValue
Providertogether
AuthTOGETHER_API_KEY
APIOpenAI-compatible
Base URLhttps://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/moonshotai/Kimi-K2.5" },
    },
  },
}

​
Non-interactive example

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice together-api-key \
  --together-api-key "$TOGETHER_API_KEY"
The onboarding preset sets together/moonshotai/Kimi-K2.5 as the default model.

​
Built-in catalog

OpenClaw ships this bundled Together catalog:
Model refNameInputContextNotes
together/moonshotai/Kimi-K2.5Kimi K2.5text, image262,144Default model; reasoning enabled
together/zai-org/GLM-4.7GLM 4.7 Fp8text202,752General-purpose text model
together/meta-llama/Llama-3.3-70B-Instruct-TurboLlama 3.3 70B Instruct Turbotext131,072Fast instruction model
together/meta-llama/Llama-4-Scout-17B-16E-InstructLlama 4 Scout 17B 16E Instructtext, image10,000,000Multimodal
together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8Llama 4 Maverick 17B 128E Instruct FP8text, image20,000,000Multimodal
together/deepseek-ai/DeepSeek-V3.1DeepSeek V3.1text131,072General text model
together/deepseek-ai/DeepSeek-R1DeepSeek R1text131,072Reasoning model
together/moonshotai/Kimi-K2-Instruct-0905Kimi K2-Instruct 0905text262,144Secondary Kimi text model

​
Video generation

The bundled together plugin also registers video generation through the shared video_generate tool.
PropertyValue
Default video modeltogether/Wan-AI/Wan2.2-T2V-A14B
Modestext-to-video, single-image reference
Supported parametersaspectRatio, resolution
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.
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.
  • 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 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.