OpenClawDocs
On this page

On this page

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Together AI

Together AI provides access to leading open-source models including Llama, DeepSeek, Kimi, and more through a unified API. OpenClaw bundles it as the together provider.

Property Value
Provider together (alias: togetherai)
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

    bash
    openclaw onboard --auth-choice together-api-key

  • Set a default model

    json5
    {  agents: {    defaults: {      model: {        primary: "together/moonshotai/Kimi-K2.6",      },    },  },}

    • Non-interactive example

    bash
    openclaw onboard --non-interactive --accept-risk --skip-health \  --mode local \  --auth-choice together-api-key \  --together-api-key "$TOGETHER_API_KEY"

    Built-in catalog

    Cost is USD per million tokens.

    Model ref Name Input Context Max output Cost (in/out) Notes
    together/meta-llama/Llama-3.3-70B-Instruct-Turbo Llama 3.3 70B Instruct Turbo text 131,072 8,192 1.04 / 1.04 General model
    together/moonshotai/Kimi-K2.6 Kimi K2.6 FP4 text, image 262,144 32,768 1.20 / 4.50 Default model
    together/deepseek-ai/DeepSeek-V4-Pro DeepSeek V4 Pro text 512,000 384,000 1.74 / 3.48 Reasoning model
    together/zai-org/GLM-5.2 GLM 5.2 FP4 text 262,144 131,072 1.40 / 4.40 Reasoning model

    Video generation

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

    Property Value
    Default video model Wan-AI/Wan2.2-T2V-A14B
    Other models Wan-AI/Wan2.2-I2V-A14B, minimax/hailuo-02, kwaivgI/kling-2.1-master
    Modes text-to-video; image-to-video only with Wan-AI/Wan2.2-I2V-A14B (single reference image)
    Duration 1-10 seconds
    Supported parameters size (parsed as <width>x<height>); aspectRatio/resolution are not read

    To use Together as the default video provider:

    json5
    {  agents: {    defaults: {      mediaModels: {        video: {          primary: "together/Wan-AI/Wan2.2-T2V-A14B",        },      },    },  },}

    Prompt caching

    Together automatically reuses matching prompt prefixes. OpenClaw sends a stable prompt_cache_key on native Together requests to improve routing across turns. Cache usage is read from both usage.prompt_tokens_details.cached_tokens and usage.cached_tokens, depending on the model's response format. Keep the model, tool definitions, reasoning settings, and earlier messages stable for the best reuse. See Together prompt caching.

    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>.
    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.
    Was this useful?