메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.kr/llms.txt

Use this file to discover all available pages before exploring further.

Synthetic

Synthetic은 Anthropic 호환 엔드포인트를 노출합니다. OpenClaw는 이를 synthetic 프로바이더로 등록하고 Anthropic 메시지 API를 사용합니다.

빠른 설정

  1. SYNTHETIC_API_KEY를 설정하세요 (또는 아래의 마법사를 실행하세요).
  2. 온보딩을 실행하세요:
openclaw onboard --auth-choice synthetic-api-key
기본 모델은 다음으로 설정됩니다:
synthetic/hf:MiniMaxAI/MiniMax-M2.5

설정 예시

{
  env: { SYNTHETIC_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" },
      models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.5": { alias: "MiniMax M2.5" } },
    },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "hf:MiniMaxAI/MiniMax-M2.5",
            name: "MiniMax M2.5",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 192000,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}
참고: OpenClaw의 Anthropic 클라이언트는 기본 URL에 /v1을 추가하므로 https://api.synthetic.new/anthropic을 사용하세요 (/anthropic/v1 아님). Synthetic이 기본 URL을 변경할 경우 models.providers.synthetic.baseUrl을 재정의하세요.

모델 카탈로그

아래 모든 모델은 비용이 0 입니다 (입력/출력/캐시).
Model IDContext windowMax tokensReasoningInput
hf:MiniMaxAI/MiniMax-M2.519200065536falsetext
hf:moonshotai/Kimi-K2-Thinking2560008192truetext
hf:zai-org/GLM-4.7198000128000falsetext
hf:deepseek-ai/DeepSeek-R1-05281280008192falsetext
hf:deepseek-ai/DeepSeek-V3-03241280008192falsetext
hf:deepseek-ai/DeepSeek-V3.11280008192falsetext
hf:deepseek-ai/DeepSeek-V3.1-Terminus1280008192falsetext
hf:deepseek-ai/DeepSeek-V3.21590008192falsetext
hf:meta-llama/Llama-3.3-70B-Instruct1280008192falsetext
hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP85240008192falsetext
hf:moonshotai/Kimi-K2-Instruct-09052560008192falsetext
hf:openai/gpt-oss-120b1280008192falsetext
hf:Qwen/Qwen3-235B-A22B-Instruct-25072560008192falsetext
hf:Qwen/Qwen3-Coder-480B-A35B-Instruct2560008192falsetext
hf:Qwen/Qwen3-VL-235B-A22B-Instruct2500008192falsetext + image
hf:zai-org/GLM-4.5128000128000falsetext
hf:zai-org/GLM-4.6198000128000falsetext
hf:deepseek-ai/DeepSeek-V31280008192falsetext
hf:Qwen/Qwen3-235B-A22B-Thinking-25072560008192truetext

주의사항

  • 모델 참조는 synthetic/<modelId> 형식을 사용합니다.
  • 모델 허용 목록을 활성화하려면 (agents.defaults.models), 사용할 계획인 모든 모델을 추가하세요.
  • Model providers에서 프로바이더 규칙을 참조하세요.