안녕하세요 VPS를 사용하지 않고 로컬로 사용하기 위한 가이드가 있을까요?

Question

안녕하세요. 회사에서 사용하려하는데 VPS 연결을 보안상 사용이 어려울것 같아서 로컬로 연결하고자 혼자 셋팅해보고 있는데요. 아래와 같은 오류에서 헤르메스 게이트웨이와 연결이 되지 않는 이슈가 있어서 문의 드립니다. 로컬 연결을 할수 있는 방법은 없을까요? 그리고 현재 강의는 헤르메스 초기 셋팅부터 순차적으로 설명해주시는 것 같은데, 기존 강의에서 사용했던 직원들을 그대로 DeskRPG로 마이그레이션 하는 방법은 없을까요? 항상 감사합니다.

Dante(곽지호) · Answer

안녕하세요. 회사 환경에 맞춰 직접 세팅하고 포트까지 파고들어 주셔서 감사합니다. 먼저 포트 이야기부터 드리자면, 9119번은 게이트웨이가 아니라 헤르메스 대시보드(웹 관리 화면)의 포트입니다. 헤르메스는 포트를 두 개 씁니다. 사람이 브라우저로 보는 대시보드가 9119번이고, DeskRPG 같은 다른 앱이 직원에게 말을 거는 API 서버가 8642번입니다. 그래서 DeskRPG가 8642번을 찾는 것은 정상이고, 9119번으로 맞추시면 대시보드에 연결을 시도하게 되어 동작하지 않습니다. 9119번만 보이고 8642번이 보이지 않았다면 API 서버가 아직 켜지지 않은 상태라는 뜻입니다. 그리고 스크린샷의 "소유 관계를 확인할 수 없습니다" 오류는 수강생님 설정 문제가 아니라 DeskRPG 쪽 문제였고, 최신 버전에서 고쳐졌습니다. 최근 헤르메스가 설치 방식을 바꿨는데, 사용하신 DeskRPG 버전(2026.923.1)의 연결 마법사가 새 방식으로 설치된 게이트웨이를 알아보지 못했습니다. 아래 "API 인증 키를 먼저 설정해야 합니다" 문구도 같은 이유로 뜬 것입니다. VPS 없이 같은 컴퓨터에서 연결하는 로컬 방식도 정식으로 지원합니다. 해결은 터미널에서 아래 세 줄을 순서대로 실행하시면 됩니다. 실행 중인 DeskRPG가 있다면 먼저 종료해 주세요. hermes update hermes gateway restart npx deskrpg@latest start 그다음 브라우저에서 게이트웨이 연결, 로컬을 선택하고 설치 검토 화면에서 연결을 누르시면 됩니다. API 서버 켜기, 키 발급, 포트 설정, 게이트웨이 재시작까지 마법사가 처리하니 포트를 손으로 바꾸실 필요는 없습니다. 직원이 여러 명이면 마법사가 8642번 근처의 빈 포트를 직원마다 따로 잡아 줍니다. 기존 직원 마이그레이션도 같은 화면에서 됩니다. (1) 연결할 때 "가져올 기존 프로필"에서 원하는 직원을 체크하시거나 (2) 연결한 뒤 게이트웨이 화면의 "Hermes에 있는 직원 가져오기"에서 모두 가져오기를 누르시면 됩니다. DeskRPG는 직원을 복사하는 게 아니라 헤르메스에 있는 직원을 그대로 연결하는 방식입니다. 그래서 강의에서 만든 성격( SOUL.md ), 스킬, 메모리가 그대로 유지되고, DeskRPG 안에서도 같은 직원으로 일합니다. 그래도 막히면 hermes --version 결과와 빨간 오류 문구를 함께 남겨 주세요. 바로 확인해 드리겠습니다. 감사합니다. :)

심현용 · Answer

좀 더 파보니 보통 헤르메스 gateway 포트는 8642 포트로 실행되는데 제 환경에서는 9119 포트로 실행되는 차이가 있었습니다. deskrpg에서는 무조건 8642 포트로 실행한 gateway를 찾는것으로 보이는데 이것을 9119로 설정을 맞출수 있는 방법이 있을까요?

인프런 AI 인턴 · Answer

안녕하세요, 인프런 AI 인턴입니다. 심현용님. 로컬 환경에서 Hermes를 사용하려는 상황과 관련하여 아래 유사 질문을 참고해 보실 수 있습니다. 로컬 환경의 헤르메스와 텔레그램 통신의 개념 로컬 PC에서 실행 중인 Hermes도 텔레그램이나 Slack 같은 외부 서비스와 통신할 수 있습니다. 다만 Hermes 게이트웨이 프로세스가 실행 중이어야 하며, 외부에서 메시지를 받으려면 PC가 켜져 있고 네트워크 연결이 유지되어야 합니다. 현재 첨부하신 오류는 로컬 Hermes의 설치 경로, 프로필, API 포트 와 대시보드에 등록된 게이트웨이 정보가 일치하지 않을 때 발생하는 유형으로 보입니다. 따라서 다음 항목을 우선 확인해 보시는 것이 좋습니다. Hermes가 실제로 실행 중인지 확인 대시보드에 선택한 프로필이 default 프로필과 일치하는지 확인 Hermes의 API 포트가 대시보드에 설정된 포트와 동일한지 확인 플러그인이 연결하려는 Hermes 경로가 현재 실행 중인 로컬 설치 경로와 동일한지 확인 Hermes 게이트웨이를 재시작한 뒤 설치 항목을 다시 검색 추가로 로컬 PC를 항상 켜둘 수 없는 경우에는 VPS나 별도 서버가 필요하지만, 회사 보안 정책상 VPS를 사용할 수 없다면 사내 PC 또는 내부 서버에서 Hermes를 실행하는 방식으로 구성할 수 있습니다. slack 에 연결한 헤르메스를 외부에서 사용 하는 방법 이 게시글의 답변에서도 Hermes는 기본적으로 서버 프로그램이므로, 로컬 PC에서 사용할 경우 해당 PC가 켜져 있고 Hermes가 실행 중이어야 외부 메신저와 계속 통신할 수 있다고 설명하고 있습니다. 또한 대시보드와 Hermes 서버 프로세스는 별개의 구성이라는 점도 참고해 주세요. 현재 오류 화면에 표시된 구체적인 Hermes 실행 명령어, API 포트, 대시보드 연결 설정값이 없어 정확한 수정 방법까지 확정하기는 어렵습니다. 저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.