openclaw doctor 로 해결이 안되는 경우

 

 

)

openclaw doctor가 말해준 핵심은 두 가지입니다.

1. 설정 스키마가 2026.2.17 버전과 안 맞는다.
   • models.providers.openai.api: Invalid input
   • models.providers.openai: Unrecognized key: "env"
   • agents: Unrecognized key: "mode"openclaw+1
2. **Anthropic 기본 프로필은 결제 제한(billing cooldown)**이라 당장은 Opus 4.6도 못 씀.github+1

그래서 먼저 config를 버전에 맞게 최소 형태로 고쳐서 Gateway를 살리고,
그다음 OpenAI + (옵션으로 Anthropic)만 깨끗하게 붙이는 방향이 좋습니다.

---

1단계: 깨끗한 최소 config로 되돌리기

1. 현재 설정 파일 백업

 

bash

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak.$(date +%Y%m%d-%H%M)

1. 버전에 맞는 최소 유효 config로 덮어쓰기
   (스키마 오류 나는 env, mode, 잘못된 api 전부 제거)

 

bash

cat > ~/.openclaw/openclaw.json << 'EOF' { "gateway": { "host": "127.0.0.1", "port": 18789 }, "models": { "providers": { "openai": { "type": "openai" } } }, "agents": { "defaults": { "model": { "primary": "openai/gpt-4o" } } } } EOF

이 상태는:

• OpenAI 기본 프로바이더 1개
• 기본 모델은 openai/gpt-4o
• 불필요한 env, mode, 커스텀 api 키 없음 → 스키마 통과openclaw+1

1. Gateway 다시 점검

 

bash

openclaw doctor

여기서 더 이상 models.providers.openai.api / env / agents.mode 에러가 나오지 않아야 합니다.

---

2단계: Gateway가 제대로 뜨는지 확인

 

bash

systemctl --user status openclaw-gateway.service # 또는 journalctl --user -u openclaw-gateway.service -n 50 --no-pager

문제 없으면:

 

bash

openclaw models list

에서 openai/gpt-4o 가 정상으로 보여야 합니다.[docs.openclaw]​

---

3단계: gpt‑4o‑mini를 스키마에 맞게 추가

이제 버전에 맞는 방식으로 gpt‑4o‑mini만 추가합니다.
(공식 문서에 맞춰 api/env를 쓰지 않고, 타입 기반 설정으로 둡니다.)aimlapi+1

 

bash

nano ~/.openclaw/openclaw.json

"models" 블록을 아래처럼 수정:

 

text

{ "gateway": { "host": "127.0.0.1", "port": 18789 }, "models": { "providers": { "openai": { "type": "openai", "models": [ { "id": "gpt-4o-mini", "name": "GPT-4o mini", "contextWindow": 128000, "maxTokens": 16000 } ] } } }, "agents": { "defaults": { "model": { "primary": "openai/gpt-4o-mini", "fallbacks": ["openai/gpt-4o"] } } } }

설명:

• type: "openai" → 이 버전에서 권장되는 방식 (엔진이 baseUrl, api 등을 알아서 넣음)[docs.openclaw]​
• models[].id는 슬래시 없이 gpt-4o-mini
• primary는 openai/gpt-4o-mini (provider prefix 포함)[docs.openclaw]​

---

4단계: OpenAI API 키는 환경변수로만 관리

이 버전 스키마에서는 env 키를 직접 config에 쓰면 안 되므로:

 

bash

export OPENAI_API_KEY="sk-..." grep OPENAI_API_KEY ~/.bashrc || echo 'export OPENAI_API_KEY="sk-..."' >> ~/.bashrc

• openclaw 프로세스가 이 환경변수를 inherit하도록,
  systemd 유저 서비스에도 필요하면 넣어야 합니다 (지금은 일단 셸 기준).[docs.aimlapi]​

---

5단계: 다시 doctor / 모델 상태 확인

 

bash

openclaw gateway restart openclaw doctor openclaw models list

이제 이상적인 모습:

 

text

openai/gpt-4o-mini text(+image) 128k no yes default,configured openai/gpt-4o text(+image) 125k no yes fallback#1,configured

• default,missing 대신 default,configured
• Config invalid... openai.api/env/mode 에러는 더 이상 안 나와야 합니다.kaxo+1

---

6단계: Anthropic/Opus 4.6은 나중에 (지금은 결제 제한)

doctor 출력에 이미:

anthropic:default: disabled:billing (9h) — Top up credits (provider billing) or switch provider.

 

라고 되어 있어서, 지금은 Anthropic 기본 프로필이 과금 제한으로 막혀 있는 상태입니다.reddit+1

• 당장은 OpenAI 쪽(gpt‑4o‑mini, gpt‑4o)을 먼저 안정화시키고
• 나중에 크레딧 충전 후 Anthropic provider를 추가하는 게 좋습니다.

---

핵심 요약

1. 현재 에러는 config 스키마 불일치 + Anthropic 결제 제한 때문.
2. openclaw.json을 위의 최소 예제로 리셋 → doctor 에러 제거.
3. 같은 파일에서 openai provider에 gpt‑4o‑mini만 추가, OPENAI_API_KEY는 환경변수로만 설정.
4. openclaw gateway restart → openclaw models list로 default,missing이 default,configured로 바뀌었는지 확인.

지금 ~/.openclaw/openclaw.json 전체 내용을 보여주시면, 그 파일 기준으로 “이 줄 지우고, 여기 이렇게 바꿔라” 식으로 딱 맞게 수정안도 적어 줄 수 있습니다.