Hermes 에이전트의 API 주소나 키는 분명히 변경되었지만, Open WebUI는 여전히 설정되어 있습니다. 이는 보통 Hermes가 재시작하지 않아서가 아니라, Open WebUI가 처음 시작할 때만 이 환경 변수들을 읽고, 연결 정보는 자체 내부 데이터베이스에 기록되기 때문입니다. 공식 문서가 이를 명확히 상기시켜 줍니다.
올바른 대처 방법
- 연결 매개변수만 변경하고 싶다면, Docker 환경 변수만 바꾸는 것이 아니라 Open WebUI의 관리자 설정으로 직접 가서 수정하세요.
- 새 환경 변수로 처음부터 다시 시작하고 싶다면, Open WebUI 데이터 볼륨을 삭제하고 재시작하세요.
- 동시에 Hermes
API_SERVER_KEY가 동기화되어 업데이트되었는지 반드시 확인하세요. 그렇지 않으면 프론트엔드가 인증 오류를 계속 보고할 수 있습니다.
왜 많은 사람들이 이 질문을 헤르메스 질문으로 착각하는지
"OPENAI_API_BASE_URL 바꿨고 OPENAI_API_KEY 했는데 페이지는 변하지 않는다"는 식으로 보이기 때문에, 본능적으로 헤르메스가 여전히 캐싱 중이라는 것입니다. 사실 캐시는 Hermes Agent가 아니라 Open WebUI 자체에서 설정됩니다.
이 질문의 가장 시간을 절약하는 결론은 환경 변수 변경이 첫 시작 시에만 효과적이라는 점입니다. 기존 인스턴스는 관리자 UI에서 변경하거나 Open WebUI 데이터 볼륨을 지우면 재구성할 수 있습니다.
공식 오픈 소스 주소: https://github.com/NousResearch/hermes-agent; 공식 문서 입력: https://hermes-agent.nousresearch.com/.
