메인 콘텐츠로 건너뛰기

​
openclaw promos

ClawHub에 게시된 프로모션 모델 혜택을 찾아 신청합니다. 프로모션을 신청하면 제공자(필요한 경우 인증 및 Plugin)를 구성하고 프로모션의 모델을 등록합니다. 온보딩을 다시 실행하지 않으며, 사용자가 명시하지 않는 한 기본 모델도 변경하지 않습니다. 관련 문서:

​
명령어

​
openclaw promos list

현재 진행 중인 프로모션을 모델, 권장 기본 모델, 남은 시간, 정확한 신청 명령어와 함께 나열합니다. --json은 원시 페이로드를 출력합니다.

​
openclaw promos claim <slug>

진행 중인 프로모션을 신청합니다.
  1. ClawHub에서 프로모션을 가져와 유효 기간 내에 있는지 확인합니다.
  2. 프로모션의 제공자, 인증 방식, 선언된 Plugin 패키지가 설치된 OpenClaw 버전과 호환되는지 검증합니다. 알 수 없는 ID나 패키지 불일치는 거부됩니다. 프로모션으로 인해 CLI가 이미 실행 방법을 알고 있지 않은 작업을 실행하는 일은 절대 없습니다.
  3. 기존 제공자 자격 증명이 있으면 재사용합니다. 없으면 제공자의 일반 인증 절차를 진행하며, 먼저 무료 키를 발급받을 수 있는 프로모션 가입 URL을 출력합니다. --api-key <key>를 사용하면 프롬프트 없이 API 키 인증을 완료하며, 이는 openclaw onboard의 비대화형 플래그와 동일하게 작동합니다. 키를 명령줄에 노출하지 않으려면 대신 제공자의 환경 변수(예: OPENROUTER_API_KEY)로 내보내십시오. 기존 환경 변수 자격 증명은 자동으로 감지되므로 플래그가 필요하지 않습니다.
  4. 프로모션 모델을 별칭과 함께 등록합니다. 기존 별칭은 절대 덮어쓰지 않습니다.
  5. 프로모션의 권장 모델을 기본 모델로 설정할지 묻습니다. --set-default를 사용하면 질문을 건너뛰며, 그렇지 않으면 기본 설정이 변경되지 않습니다.
프로모션 기간이 종료되면 제공자는 무료 모델 제공을 중단하지만, 구성과 자격 증명은 그대로 유지됩니다. 언제든지 openclaw models set <model>을 사용하여 다른 모델로 전환할 수 있습니다.

​
models list에서의 수동적 검색

openclaw models list는 ClawHub에 직접 요청하지 않아도 프로모션을 표시합니다.
  • 아직 구성하지 않은 모델이 포함된 진행 중인 혜택은 표 아래의 “프로모션을 통해 이용 가능” 그룹에 각각의 신청 명령어와 함께 표시됩니다.
  • promos claim을 통해 등록한 모델에는 promo 태그가 표시되며, 혜택 기간이 지나면 promo ended로 바뀝니다.
  • 새로운 혜택이 처음 감지되면 openclaw promos list를 안내하는 일회성 알림이 표시됩니다. 이미 나열하거나 신청한 혜택은 다시 알리지 않습니다.
이는 로컬에 캐시된 ClawHub의 호스팅 프로모션 피드 사본을 읽습니다. 일반적으로 조건부 요청을 통해 하루에 한 번 새로 고치며, 캐시된 스냅샷이 만료되면 그보다 일찍 새로 고칩니다. 새로 고침에 실패하면 오류를 표시하지 않고 건너뜁니다. 오래된 캐시의 새로 고침은 최대 2.5초까지만 기다리며 목록 표시를 중단시키지 않습니다. --json 및 --plain 출력은 프로모션 섹션이나 알림 없이 기계 처리에 적합한 형식을 유지합니다. 신청 시에는 항상 실시간 ClawHub API를 통해 다시 검증하므로, 캐시된 사본에 계속 표시되더라도 조기에 철회된 혜택은 거부됩니다.