Hermes 에이전트에 "설정 누락", "옵션이 존재하지 않음", 또는 이전 설정이 작동하지 않는 경우, 먼저 hermes config check를 실행한 후 hermes config migrate 실행을 실행하세요. 이렇게 하면 수동으로 config.yaml을 변경하는 것보다 더 안정적입니다.
업데이트 후에 왜 설정이 사라졌나요?
Hermes의 기능은 빠르게 변하며, 새 버전에서는 압축, 도구, 플랫폼, 플러그인 또는 상황에 따른 옵션을 추가할 수 있습니다. 이 필드들이 이전 ~/.hermes/config.yaml에서 제공되지 않을 때는 프로그램이 기본값을 사용하려고 했지만, 일부 기능은 명시적으로 완료해야 할 수도 있습니다. 공식 문서에서는 config check와 config migrate를 최신 표준 처리 경로로 사용합니다.
권장 수리 순서
- 먼저
hermes config실행해서 현재 구성이 정상적으로 읽힐 수 있는지 확인해 보세요. - 일반 구성이나 키가 누락되었는지 확인하기 위해
hermes config check수행하세요. - 누락된 항목을 인터랙티브하게 채우기 위해
hermes config migrate실행하세요. - API 키, 봇 토큰, 비밀번호와 같은 민감한 정보가
hermes config set KEY VALUE로 작성되면 자동으로.env에 저장됩니다.
구성 우선순위도 명확히 확인할 수 있어야 합니다
Hermes의 구성 우선순위는 CLI 매개변수가 가장 높은 우선순위를 차지하고, 그 다음이 config.yaml, .env, 마지막으로 기본값입니다. 따라서 업데이트 후 "변경은 되었지만 효과가 없다"고 느껴진다면, 시작 명령어에 --model나 --profile 같은 임시 매개변수가 포함되어 있는지 확인해야 합니다.
결론은 간단합니다: 업데이트된 구성 문제는 먼저 공식 명령어에 넘기고, 필드의 의미가 알려졌을 때만 수동으로 편집됩니다. 이렇게 하면 잘못된 파일에 키를 쓰는 것을 방지하고 다음 업그레이드의 필요성을 줄일 수 있습니다.
