Back to Openclaw

Together AI

docs/providers/together.md

2026.5.284.5 KB
Original Source

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

<Steps> <Step title="Get an API key"> Create an API key at [api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys). </Step> <Step title="Run onboarding"> ```bash openclaw onboard --auth-choice together-api-key ``` </Step> <Step title="Set a default model"> ```json5 { agents: { defaults: { model: { primary: "together/meta-llama/Llama-3.3-70B-Instruct-Turbo", }, }, }, } ``` </Step> </Steps>

Non-interactive example

bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice together-api-key \
  --together-api-key "$TOGETHER_API_KEY"
<Note> The onboarding preset sets `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` as the default model. </Note>

Built-in catalog

OpenClaw ships this bundled Together catalog:

Model refNameInputContextNotes
together/meta-llama/Llama-3.3-70B-Instruct-TurboLlama 3.3 70B Instruct Turbotext131,072Default model
together/moonshotai/Kimi-K2.6Kimi K2.6 FP4text, image262,144Kimi reasoning model
together/deepseek-ai/DeepSeek-V4-ProDeepSeek V4 Protext512,000Reasoning text model
together/Qwen/Qwen2.5-7B-Instruct-TurboQwen2.5 7B Instruct Turbotext32,768Fast text model
together/zai-org/GLM-5.1GLM 5.1 FP4text202,752Reasoning 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 only with Wan-AI/Wan2.2-I2V-A14B
Supported parametersaspectRatio, resolution

To use Together as the default video provider:

json5
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "together/Wan-AI/Wan2.2-T2V-A14B",
      },
    },
  },
}
<Tip> See [Video Generation](/tools/video-generation) for the shared tool parameters, provider selection, and failover behavior. </Tip> <AccordionGroup> <Accordion title="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`).
<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>
</Accordion> <Accordion title="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>`. </Accordion> </AccordionGroup> <CardGroup cols={2}> <Card title="Model selection" href="/concepts/model-providers" icon="layers"> Provider rules, model refs, and failover behavior. </Card> <Card title="Video generation" href="/tools/video-generation" icon="video"> Shared video generation tool parameters and provider selection. </Card> <Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear"> Full config schema including provider settings. </Card> <Card title="Together AI" href="https://together.ai" icon="arrow-up-right-from-square"> Together AI dashboard, API docs, and pricing. </Card> </CardGroup>