ClawRelay: macOS 네이티브 LLM 프록시 자동 장애 조치 기능

ClawRelay의 기능

ClawRelay는 macOS 15+용 네이티브 Swift 애플리케이션으로, 로컬에서 OpenAI 호환 HTTP 서버를 실행합니다. LLM 제공자를 우선순위 순서대로 구성합니다(OpenAI, Groq, Nvidia NIMs, Ollama 또는 /v1/chat/completions 엔드포인트를 지원하는 모든 서비스). 요청이 들어오면 첫 번째 제공자를 시도하고, 실패 시(속도 제한, 5xx 오류 또는 시간 초과) 자동으로 다음 제공자로 폴백합니다.

설정 및 구성

앱은 시스템 트레이에서 실행되며 빠른 접근과 전체 설정 창을 제공합니다. 제공자 API 키는 macOS 키체인에 저장됩니다. Docker, Node.js 또는 구성 파일이 필요하지 않습니다.

도구를 연결하려면:

기본 URL: http://localhost:11434/v1
API 키: 로컬 사용 시 선택 사항이며, LAN 또는 터널 설정을 위해 앱 내에서 생성 가능

Cursor, Continue.dev, LM Studio, Python openai 라이브러리 및 사용자 지정 기본 URL을 허용하는 모든 도구와 호환됩니다.

openClaw 통합

openClaw 사용자의 경우, 한 줄의 명령어로 설정할 수 있습니다:

bash <(curl -fsSL https://www.desertstack.dev/clawrelay/enable-provider.sh ) \
  --provider-id "clawrelay" \
  --base-url "http://localhost:11434/v1" \
  --api-key "claw_relay_key" \
  --api "openai-completions" \
  --model-id "clawrelay" \
  --model-name "ClawRelay"

ClawRelay의 서버 탭에서 키를 생성하세요. jq와 openclaw CLI가 필요합니다.

배포 옵션

로컬호스트 외에도, ClawRelay를 LAN 인터페이스에 바인딩하여 네트워크의 모든 장치에서 접근할 수 있습니다. 또한 Cloudflare Tunnel이나 ngrok를 앞에 배치하여 인터넷에 노출시킬 수도 있습니다. 동일한 앱과 구성이 모든 배포 시나리오에 적용됩니다.