Together AI

The Together AI provides access to leading open-source models including Llama, DeepSeek, Kimi, and more through a unified API.

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

Quick start

Set the API key (recommended: store it for the Gateway):

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"

This will set together/moonshotai/Kimi-K2.5 as the default model.

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

Built-in catalog

OpenClaw currently 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 onboarding preset sets together/moonshotai/Kimi-K2.5 as the default model.

Video generation

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

Default video model: together/Wan-AI/Wan2.2-T2V-A14B
Modes: text-to-video and single-image reference flows
Supports aspectRatio and 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.

3.5 KiB Raw Blame History