Together AI

Together AI setup (auth + model selection)

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

Create an API key at [api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys). ```bash openclaw onboard --auth-choice together-api-key ``` ```json5 { 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](/docs/openclaw-docs/tools/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`).
<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>
- 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/`.
Provider rules, model refs, and failover behavior. Shared video generation tool parameters and provider selection. Full config schema including provider settings. Together AI dashboard, API docs, and pricing.