왜 Hermes 에이전트 API 서버는 401이나 CORS를 가져오나요? 첫째, 브라우저 직접 연결과 Open WebUI 직접 연결을 구분하세요

Hermes Agent API Server는 401이나 CORS를 보고하는데, 보통 같은 문제는 없습니다. 401 은 올바른 Authorization: Bearer ...을 가져오지 않는다는 뜻입니다; CORS 는 브라우저가 Hermes를 직접 호출할 때만 처리하면 됩니다. Open WebUI 같은 서버 측 도킹의 경우, 공식 문서에는 일반적으로 CORS가 전혀 필요하지 않다고 명확히 명시되어 있습니다.

먼저 당신이 어떤 관계인지 판단하세요

• Open WebUI / LibreChat / LobeChat: 대부분은 서버 측에서 Hermes에 요청하는 것으로, 기본 URL과 베어러 토큰이 짝지어 있으면 보통 API_SERVER_CORS_ORIGINS 필요하지 않습니다.
• 예를 들어 fetch: 브라우저 직접 연결과 같은 화이트리스트 API_SERVER_CORS_ORIGINS=http://localhost:3000.

가장 빠른 수사 순서

1. API_SERVER_ENABLED=true와 API_SERVER_KEY가 설정되었는지 확인하세요.
2. 공식 예제 curl를 사용해 먼저 http://localhost:8642/v1/chat/completions을 요청한 후 프론트엔드를 대기열에 넣으세요.
3. 브라우저가 오류를 보고하면 API_SERVER_CORS_ORIGINSit을 보상하고, 애초에 호스트를 0.0.0.0에 묶지 마세요.
4. 공개 접속으로 변경할 때는 토큰을 유지하고 CORS 화이트리스트를 좁혀야 합니다.

한마디로 말해: 401은 먼저 토큰을 확인하고, CORS는 먼저 토큰이 브라우저와 직접 연결되어 있는지 확인합니다. Open WebUI와 fetch 오류를 혼동하지 마세요.

공식 오픈 소스 주소: https://github.com/NousResearch/hermes-agent; 공식 문서 입력: https://hermes-agent.nousresearch.com/.