OpenClaw

OpenClaw는 사용자의 머신에서 실행되는 셀프 호스팅 개인용 AI로, 이미 사용 중인 채널(WhatsApp, Telegram, Slack, Discord, iMessage 등 다수)을 통해 응답합니다. 여러 모델 제공자를 지원하며, Synthorai를 그중 하나로 추가하면 워크스페이스의 모든 chat 모델을 OpenClaw의 agent 설정을 통해 사용할 수 있습니다.

시작하기 전에

필요한 것: (1) 로컬에서 실행 중인 OpenClaw 설치, (2) 다음 위치에서 발급받은 Synthorai API key Console → API Keys.

1단계 — ~/.openclaw/openclaw.json 편집

다음 위치에 Synthorai를 추가하세요 providers. 기존 openai/anthropic 항목은 그대로 두어도 됩니다. OpenClaw는 다음 항목에서 참조하는 것을 사용합니다 agent.model.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai/gpt-5.4-mini"
  }
}

ℹ

type: openai OpenClaw에 OpenAI Chat Completions 프로토콜을 사용하도록 지시합니다. Synthorai는 다음 엔드포인트에서 OpenAI와 완전히 호환됩니다 /v1/chat/completions따라서 이는 워크스페이스의 모든 chat 모델에서 작동합니다. OpenAI가 호스팅하는 모델에만 국한되지 않습니다.

2단계 — (선택) Claude 네이티브 provider도 추가하기

Anthropic의 네이티브 message 형식(Claude 계열 모델 전용)을 특별히 사용하려면 Anthropic 프로토콜을 대상으로 하는 두 번째 provider를 추가하세요. 다음 사항에 유의하세요 base_url 을(를) 포함하지 않습니다 /v1.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    },
    "synthorai-claude": {
      "type": "anthropic",
      "base_url": "https://synthorai.io",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai-claude/claude-sonnet-4-6"
  }
}

3단계 — OpenClaw 재시작

OpenClaw는 다음을 다시 읽습니다 openclaw.json 을(를) 시작 시 수행합니다. 재시작 후 OpenClaw가 바인딩된 모든 채널(예: Slack, Telegram)에서 첫 메시지를 보내세요. agent가 구성한 Synthorai 모델을 사용하여 응답합니다.

권장 모델

대화형 어시스턴트의 경우, 비용과 품질의 최적 균형점은 보통 빠른 중급 모델입니다.

매개변수	유형	설명
`gpt-5.4-mini`	`fast`	OpenAI; 빠르고 저렴합니다. 좋은 기본 선택입니다.
`qwen3.5-flash`	`fast`	Alibaba Qwen; 중국어 + 코드 + 다국어에서 가격 경쟁력이 있습니다.
`claude-sonnet-4-6`	`balanced`	Anthropic; 더 긴 컨텍스트의 대화에 가장 적합합니다. 위의 claude provider 형식이 필요합니다.
`gemini-2.5-flash`	`fast`	Google; 컨텍스트 윈도우가 길어 파일이 많은 워크플로에 적합합니다.

문제 해결

OpenClaw 버전 간 필드 이름 불일치 — 위에 표시된 필드 (type / base_url / api_key) 는 일반적인 패턴입니다. 특정 OpenClaw 릴리스에서 이름이 변경된 경우 (e.g. provider_type / baseUrl), 공식 설정 참조 문서를 확인하고 동일한 값으로 교체하세요.

401 / 403 — API key가 잘못되었거나 비활성화되었거나 할당량이 부족합니다. 다음을 확인하세요 /console/keys 및 /console/billing.

"Unknown model" — 모델 slug은 다음 위치의 id 열과 일치해야 합니다 /console/pricing. 다음 방법으로 참조하는 경우 agent.model = "synthorai/MODEL_ID" 다음을 확인하세요 MODEL_ID 이(가) 제공한 key로 라우팅 가능한지 확인하세요.

프라이빗 / 에어갭 배포 — 동일한 JSON 형식이 작동합니다. 공개된 다음 항목만 교체하면 됩니다 https://synthorai.io 을(를) 내부 게이트웨이 호스트 이름으로 교체하세요.

상시 구동 어시스턴트에서 각 선택지의 비용을 확인하려면 예상 사용량을 LLM API cost calculator 에 넣어 보세요.