클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

OpenClaw 모델 전환기

OpenClaw(龙虾) 인스턴스의 모델 설정을 안전하게 바꾸고 401·채널 없음·thinking 레벨 오류까지 진단해 고쳐주는 스킬.

유틸리티고급★ 1,323⑂ 212AI 점수 7/10마지막 업데이트: 2026. 8. 8.

무엇을 해주나

  • openclaw.json 설정 파일이 실제로 어디에 있는지(홈 디렉터리의 3가지 후보 경로, 미러 파일 포함) 찾아내고 모두 동일하게 수정합니다.
  • 설정을 건드리기 전에 실제 completion 요청(curl)으로 엔드포인트와 모델 ID가 살아 있는지 먼저 검증합니다.
  • scripts/switch-model.py로 백업 → 모델 정의 추가 → agents.defaults.model.primary 변경 → 미러 동기화 → 게이트웨이 재시작을 한 번에 처리합니다.
  • 실제 에이전트 1턴을 돌려 result: success, fallbackUsed: false인지 확인하는 검증 단계를 강제합니다.
  • 흔한 실패 패턴을 함정 카탈로그로 정리: 환경변수 KIMI_API_KEY가 provider 키를 가로채는 문제, 플러그인이 thinking 레벨을 이진값으로 하드코딩하는 문제, 503 No available channel, 잘못된 파일을 편집한 경우 등.

이런 분께 추천

  • OpenClaw / Kimi Claw 봇을 직접 운영하며 모델을 k2p6 → k3처럼 올리거나 롤백하는 분
  • 릴레이(new-api 계열) API를 쓰면서 401·채널 없음 오류로 반복 삽질한 분
  • 설정 파일을 손으로 고쳤는데 아무것도 안 바뀌는 미스터리를 겪은 분

활용 예시

  1. "OpenClaw 모델을 k3로 바꿔줘" → 설정 경로 탐색 → curl 프로브 → 스크립트 실행 → ping 검증까지 자동 진행.
  2. "봇이 계속 Invalid token이라는데 curl로는 되는데?" → 함정 #1(환경변수 키 하이재킹) 진단 절차 안내.
  3. "Thinking level max is not supported 오류" → 플러그인 제약 확인 후 커스텀 provider 또는 params.canonicalModelId 우회 제안.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 openclaw-model-switch 폴더를 내 ~/.claude/skills/openclaw-model-switch/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/daymade/claude-code-skills.git && cp -r claude-code-skills/openclaw-model-switch ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 스킬 저장소를 내려받습니다: git clone https://github.com/daymade/claude-code-skills.git
  3. 스킬 폴더를 Claude Code 스킬 디렉터리로 복사합니다: mkdir -p ~/.claude/skills && cp -r claude-code-skills/openclaw-model-switch ~/.claude/skills/
  4. scripts/switch-model.py가 함께 복사되었는지, python3 --version이 동작하는지 확인합니다.
  5. Claude Code를 다시 시작하고 "OpenClaw 모델을 k3로 바꿔줘"처럼 요청하면 스킬이 트리거됩니다.
  6. 중요: 실행 전 openclaw.json을 직접 백업해 두고, API 키가 든 설정 파일은 절대 깃에 커밋하지 마세요.
GitHub에서 원본 보기 ↗라이선스: MIT