Add Together AI provider with API key auth and model support

docs/providers/index.md

@@ -38,6 +38,7 @@ See [Venice AI](/providers/venice).
 - [Qwen (OAuth)](/providers/qwen)
 - [OpenRouter](/providers/openrouter)
 - [Vercel AI Gateway](/providers/vercel-ai-gateway)
+- [Together AI](/providers/together)
 - [Moonshot AI (Kimi + Kimi Code)](/providers/moonshot)
 - [OpenCode Zen](/providers/opencode)
 - [Amazon Bedrock](/bedrock)

docs/providers/together.md

@@ -0,0 +1,62 @@
+---
+summary: "Together AI setup (auth + model selection)"
+read_when:
+  - You want to use Together AI with Clawdbot
+  - You need the API key env var or CLI auth choice
+---
+# Together AI
+
+
+The [Together AI](https://together.ai) provides access to leading open-source models including Llama, DeepSeek, Qwen, and more through a unified API.
+
+- Provider: `together`
+- Auth: `TOGETHER_API_KEY`
+- API: OpenAI-compatible
+
+## Quick start
+
+1) Set the API key (recommended: store it for the Gateway):
+
+```bash
+clawdbot onboard --auth-choice together-api-key
+```
+
+2) Set a default model:
+
+```json5
+{
+  agents: {
+    defaults: {
+      model: { primary: "together/meta-llama/Llama-3.3-70B-Instruct-Turbo" }
+    }
+  }
+}
+```
+
+## Non-interactive example
+
+```bash
+clawdbot onboard --non-interactive \
+  --mode local \
+  --auth-choice together-api-key \
+  --together-api-key "$TOGETHER_API_KEY"
+```
+
+## Environment note
+
+If the Gateway runs as a daemon (launchd/systemd), make sure `TOGETHER_API_KEY`
+is available to that process (for example, in `~/.clawdbot/.env` or via
+`env.shellEnv`).
+
+## Available models
+
+Together AI provides access to many popular open-source models:
+
+- **Llama 3.3 70B Instruct Turbo** - Fast, efficient instruction following
+- **Llama 4 Scout** - Vision model with image understanding
+- **Llama 4 Maverick** - Advanced vision and reasoning
+- **DeepSeek V3.1** - Powerful coding and reasoning model
+- **DeepSeek R1** - Advanced reasoning model
+- **Qwen 2.5 72B** - Multilingual capabilities
+
+All models support standard chat completions and are OpenAI API compatible.

src/agents/model-auth.ts

@@ -285,6 +285,7 @@ export function resolveEnvApiKey(provider: string): EnvApiKeyResult | null {
     venice: "VENICE_API_KEY",
     mistral: "MISTRAL_API_KEY",
     opencode: "OPENCODE_API_KEY",
+    together: "TOGETHER_API_KEY",
   };
   const envVar = envMap[normalized];
   if (!envVar) return null;