Free Ride - Unlimited free AI

• OpenClaw를 LLM API 구독료 없이 사용하고 싶으며 무료 티어 속도 제한에 대해 괜찮으신 분.
• 무료 모델의 속도 제한에 걸려 세션이 중단되지 않도록 자동 폴백 전환을 원하시는 분.
• 설정 파일을 직접 편집하지 않고 다양한 무료 모델(예: qwen3-coder, nvidia/nemotron)을 빠르게 실험해보고 싶으신 분.
• OpenRouter의 스마트 라우터가 요청마다 최적의 무료 모델을 자동으로 선택하는 "설정 후 잊어버리기" 방식을 원하시는 분.

• 보장된 SLA, 낮은 지연 시간, 또는 일관된 처리량이 필요한 경우 — 무료 모델은 공유 용량을 사용하며 가용성을 예측하기 어렵습니다.
• OpenClaw를 사용하고 있지 않은 경우; FreeRide는 openclaw.json에 직접 쓰며 OpenClaw 생태계와 긴밀하게 연결되어 있습니다.

freeride auto를 실행하면 현재 무료 OpenRouter 모델 목록을 가져오고, 품질 순으로 순위를 매긴 후, 최상의 모델을 기본으로 설정하고, 순위별 폴백 목록을 채웁니다 — 모두 단 한 번의 단계로 완료됩니다.

FreeRide는 기본적으로 최대 5개의 폴백 모델을 구성합니다(-c로 설정 변경 가능). 첫 번째 폴백은 항상 openrouter/free로, OpenRouter 자체 스마트 라우터이며, 모델이 속도 제한에 도달했을 때 요청이 자동으로 재라우팅되도록 보장합니다.

~/.openclaw/openclaw.json에서 세 가지 키만 수정됩니다: agents.defaults.model.primary, agents.defaults.model.fallbacks, agents.defaults.models. 게이트웨이, 채널, 플러그인, 환경 변수, 사용자 지정 지침 등 그 외의 모든 항목은 그대로 유지됩니다.

freeride switch <model>을 사용하여 특정 무료 모델을 기본 모델로 고정하거나, freeride switch <model> -f를 사용하여 현재 기본 모델을 변경하지 않고 대체 모델로만 추가할 수 있습니다.

freeride-watcher 데몬은 속도 제한 이벤트를 지속적으로 모니터링하고 모델을 자동으로 교체하거나, freeride-watcher --rotate 명령으로 수동 교체를 트리거할 수 있습니다.

freeride auto 명령어를 실행한 후 openclaw gateway restart를 실행하면 OpenClaw를 qwen3-coder와 같은 무료 코딩 전용 모델로 즉시 전환할 수 있습니다. OpenClaw를 평소처럼 계속 사용하세요 — 요청 한도에 도달하더라도 세션 중단 없이 자동으로 폴백이 적용됩니다.

freeride list -n 30을 사용하여 품질순으로 정렬된 모든 무료 모델을 확인한 후, freeride switch <model>로 특정 모델을 사용해 보세요. OpenClaw 내에서 /status를 입력하면 언제든지 현재 활성 모델 상태를 확인할 수 있습니다.

이미 선호하는 모델을 설정한 경우, freeride auto -f를 실행하면 기본 모델은 그대로 유지하면서 현재 이용 가능한 최적의 무료 옵션으로 대체 목록을 채울 수 있습니다.

긴 작업을 시작하기 전에 freeride-watcher --daemon을 활성화하면, 워처가 백그라운드에서 속도 제한 이벤트를 모니터링하고 폴백 모델을 자동으로 순환 전환하여 수동 개입 없이 세션을 계속 유지합니다.