메인 콘텐츠로 건너뛰기

Together AI

Together AI는 통합 API를 통해 Llama, DeepSeek, Kimi 등을 포함한 주요 오픈소스 모델에 대한 접근을 제공합니다.
PropertyValue
Providertogether
AuthTOGETHER_API_KEY
APIOpenAI-compatible
Base URLhttps://api.together.xyz/v1

시작하기

1

API 키 받기

api.together.ai/settings/api-keys에서 API 키를 생성하세요.
2

온보딩 실행

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

기본 모델 설정

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

비대화형 예시

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice together-api-key \
  --together-api-key "$TOGETHER_API_KEY"
온보딩 프리셋은 기본 모델로 together/moonshotai/Kimi-K2.5를 설정합니다.

내장 카탈로그

OpenClaw는 다음과 같은 번들 Together 카탈로그를 제공합니다.
Model refNameInputContextNotes
together/moonshotai/Kimi-K2.5Kimi K2.5text, image262,144기본 모델; reasoning 활성화
together/zai-org/GLM-4.7GLM 4.7 Fp8text202,752범용 텍스트 모델
together/meta-llama/Llama-3.3-70B-Instruct-TurboLlama 3.3 70B Instruct Turbotext131,072빠른 instruction 모델
together/meta-llama/Llama-4-Scout-17B-16E-InstructLlama 4 Scout 17B 16E Instructtext, image10,000,000멀티모달
together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8Llama 4 Maverick 17B 128E Instruct FP8text, image20,000,000멀티모달
together/deepseek-ai/DeepSeek-V3.1DeepSeek V3.1text131,072범용 텍스트 모델
together/deepseek-ai/DeepSeek-R1DeepSeek R1text131,072reasoning 모델
together/moonshotai/Kimi-K2-Instruct-0905Kimi K2-Instruct 0905text262,144보조 Kimi 텍스트 모델

비디오 생성

번들된 together Plugin은 공용 video_generate tool을 통해 비디오 생성도 등록합니다.
PropertyValue
Default video modeltogether/Wan-AI/Wan2.2-T2V-A14B
Modestext-to-video, single-image reference
Supported parametersaspectRatio, resolution
Together를 기본 비디오 provider로 사용하려면:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "together/Wan-AI/Wan2.2-T2V-A14B",
      },
    },
  },
}
공용 tool parameters, provider 선택, failover 동작은 Video Generation을 참고하세요.
Gateway가 daemon(launchd/systemd)으로 실행된다면 TOGETHER_API_KEY가 해당 프로세스에서 사용 가능하도록 해야 합니다(예: ~/.openclaw/.env 또는 env.shellEnv 사용).
대화형 셸에만 설정된 키는 daemon이 관리하는 gateway 프로세스에서는 보이지 않습니다. 지속적인 사용 가능성을 위해 ~/.openclaw/.env 또는 env.shellEnv config를 사용하세요.
  • 키가 동작하는지 확인: openclaw models list --provider together
  • 모델이 나타나지 않는다면, Gateway 프로세스에 대해 올바른 환경에 API 키가 설정되어 있는지 확인하세요.
  • 모델 ref 형식은 together/<model-id>입니다.

관련 문서

Model providers

Provider 규칙, model refs, failover 동작.

Video generation

공용 비디오 생성 tool parameters와 provider 선택.

Configuration reference

provider settings를 포함한 전체 config schema.

Together AI

Together AI 대시보드, API 문서, 요금제.