클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

OpenClaw 모델 전환·복구

OpenClaw 인스턴스의 openclaw.json을 안전하게 진단·수정해 모델을 교체하고 401·채널 없음·thinking 레벨 오류를 복구하는 스킬.

개발·코딩고급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.

무엇을 해주나

  • OpenClaw(및 Kimi Claw) 게이트웨이가 실제로 읽는 설정 파일(~/.openclaw/openclaw.json 등 후보 경로 전체)을 찾아내고 미러 파일까지 동일하게 맞춰줍니다.
  • 설정을 건드리기 전에 실제 completion 요청으로 엔드포인트·모델을 프로브해 원인을 먼저 가립니다(릴레이의 /v1/models 목록은 신뢰하지 않음).
  • scripts/switch-model.py로 백업 → 모델 정의 추가 → agents.defaults.model.primary 변경 → 게이트웨이 재시작까지 한 번에 처리합니다.
  • 실제 에이전트 턴을 돌려 result: success / fallbackUsed: false를 확인하는 종단 검증 절차를 강제합니다.
  • Invalid token(환경변수 키 하이재킹), Thinking level not supported(플러그인 제약), No available channel(그룹/네트워크 미제공), "고쳤는데 안 바뀜"(엉뚱한 파일 수정) 같은 대표 함정을 증상표로 정리해 줍니다.

이런 분께 추천

  • OpenClaw / 龙虾 봇을 직접 운영하며 Kimi k2p6 → k3 같은 모델 업그레이드·롤백을 자주 하는 분
  • 모델 설정을 바꿨는데 계속 fallback이 걸리거나 401이 떠서 원인을 못 잡고 있는 분
  • 여러 설정 미러 파일 때문에 수정이 되돌아가는 문제를 겪는 운영자

활용 예시

  1. "OpenClaw 모델을 k3로 올려줘" → 설정 경로 확인 → curl 프로브로 200 확인 → switch-model.py k3 --restart → 에이전트 턴 검증.
  2. "봇이 계속 LLM error new_api_error: Invalid token을 뱉는다" → 토큰은 curl에서 정상인데 실패 → 환경변수 KIMI_API_KEY 하이재킹(트랩 #1)으로 진단.
  3. "Thinking level \"max\" is not supported가 뜬다" → kimi-provider 플러그인의 이진 thinking 제약을 우회하도록 커스텀 프로바이더/params.canonicalModelId 설정 안내.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/openclaw-model-switch/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

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 && mkdir -p ~/.claude/skills && cp -r claude-code-skills/openclaw-model-switch ~/.claude/skills/

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

  1. 터미널을 엽니다.
  2. 스킬 저장소를 내려받습니다: git clone https://github.com/daymade/claude-code-skills.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 이 스킬만 복사합니다: cp -r claude-code-skills/openclaw-model-switch ~/.claude/skills/
  5. ls ~/.claude/skills/openclaw-model-switch 로 SKILL.md, scripts/, references/ 가 들어왔는지 확인합니다.
  6. Claude Code를 다시 실행한 뒤 "OpenClaw 모델을 k3로 바꿔줘" 처럼 요청하면 스킬이 발동합니다.
  7. 실행 전 준비물: openclaw CLI, python3, curl, 그리고 릴레이 baseUrl/apiKey. 설정 파일에는 API 키가 들어 있으니 git에 커밋하지 마세요.
GitHub에서 원본 보기 ↗라이선스: MIT