Hermes Agent로 Discord에서 업무 자동화 비서 운영하기

Discord에서 AI 비서를 운영하려면 먼저 Hermes Agent를 설치하고, 모델 제공자와 도구 권한을 확인한 뒤, Hermes Gateway로 Discord 봇을 연결해야 합니다. 이 가이드는 홈페이지·쇼핑몰·콘텐츠 운영자가 반복 확인, 자료 정리, 파일 점검, 예약 보고 같은 업무를 Discord 대화 안에서 처리하도록 만드는 실전 흐름입니다.

Hermes Agent는 터미널, 파일, 브라우저, cron, 메모리, 스킬 같은 도구를 사용할 수 있는 업무 자동화 에이전트입니다. Discord AI 비서로 연결하면 ‘가이드 초안 점검해줘’, ‘오늘 문의 현황 요약해줘’, ‘매일 오전 리포트 보내줘’처럼 메신저에서 바로 요청하고 결과를 받을 수 있습니다.

다만 AI 에이전트는 일반 챗봇보다 권한이 큽니다. 설치보다 중요한 것은 어떤 도구를 켜고, 어떤 작업은 사람 승인 뒤 실행하게 할지, 어떤 채널에서 어떤 보고를 받을지 운영 규칙을 먼저 정하는 것입니다.

1. 이 가이드로 해결되는 것

• Hermes Agent를 Discord AI 비서로 쓰기 위한 전체 구조를 이해합니다.
• 모델 제공자, 도구 권한, Discord Gateway, 승인 규칙을 순서대로 점검합니다.
• 업무 자동화 에이전트에게 안전하게 지시하는 메시지 템플릿을 만듭니다.
• 예약 리포트와 간단한 운영 점검을 cron으로 검증합니다.
• 실제 고객정보·파일·계정 권한을 다룰 때 필요한 보안 기준을 세웁니다.

2. 준비물

• Hermes Agent를 실행할 Mac, Linux, WSL 또는 서버 환경
• Hermes에서 사용할 모델 제공자 계정 또는 Nous Portal 등 공식 지원 제공자
• 관리 권한이 있는 Discord 서버와 봇을 초대할 채널
• 반복 업무 예시 2~3개: 문의 요약, 사이트 점검, 파일 정리, 일정 리포트 등
• 토큰·API 키를 채팅창에 직접 붙여넣지 않는 운영 규칙

정책·요금·화면 구성은 도구 업데이트에 따라 바뀔 수 있습니다. 설치 전에는 Hermes Agent 공식 문서의 Quickstart, Configuration, Messaging Gateway, Tools, Cron 페이지를 함께 확인하세요.

3. 소요시간/난이도

• 예상 소요시간: 기존 서버가 있으면 45~70분, 처음 설치하면 1~2시간
• 난이도: 중급. 터미널 명령어와 Discord 봇 설정을 한 번 이상 다뤄본 운영자에게 적합합니다.
• 처음 목표: 모든 자동화를 한 번에 붙이지 말고, ‘Discord에서 테스트 메시지 → Hermes 응답 → 안전한 읽기 작업 1개’까지만 성공시키는 것입니다.

4. 단계별 설정 방법

단계 1. Hermes Agent 기본 설치와 첫 응답 확인

먼저 Discord를 붙이기 전에 Hermes가 로컬에서 정상 응답하는지 확인합니다. 공식 Quickstart의 핵심은 설치, 모델 선택, 첫 대화 검증을 먼저 끝낸 뒤 게이트웨이와 cron을 붙이는 순서입니다.

# 설치 후 기본 점검 예시
hermes setup
hermes doctor
hermes chat -q "한국어로 HERMES_OK 라고만 답해줘"

여기서 실패하면 Discord 연결을 진행하지 마세요. 모델 제공자, API 키, OAuth 로그인, config.yaml 설정을 먼저 고칩니다. 기본 대화가 불안정하면 메신저 자동화도 똑같이 불안정합니다.

단계 2. 모델·도구 권한을 업무 기준으로 고르기

Hermes Agent는 terminal, file, browser, memory, session_search, cronjob 같은 도구를 상황에 따라 사용할 수 있습니다. Discord AI 비서의 첫 운영 범위는 읽기·점검·요약 중심으로 좁게 잡는 것이 좋습니다.

# 모델 선택
hermes model

# 플랫폼별 도구 활성화 확인
hermes tools

• 처음 켜기 좋은 도구: web/search, browser, read-only 파일 점검, session_search, cron 보고
• 주의해서 켜야 할 도구: terminal, patch/write_file, 외부 메시지 발송, 결제·광고·세금계산서 API
• 채널 운영 규칙: ‘조회·요약은 자동’, ‘삭제·발행·송금·광고 변경은 사람 승인 후’로 나눕니다.

단계 3. Discord Gateway 연결 준비

Discord에서 AI 비서를 운영하려면 Hermes Gateway가 필요합니다. Gateway는 Discord, Telegram, Slack 같은 메신저를 Hermes와 연결하는 백그라운드 프로세스입니다.

# 메시징 플랫폼 설정 마법사
hermes gateway setup

# 게이트웨이 실행 또는 상태 확인
hermes gateway run
hermes gateway status

Discord 봇에는 최소한 메시지 보기, 메시지 보내기, 히스토리 읽기 권한이 필요합니다. 운영 채널을 별도로 만들고, 처음에는 관리자·담당자만 접근하게 제한하세요.

단계 4. 첫 업무 지시 템플릿 만들기

Hermes Agent는 막연한 요청보다 범위, 자료 위치, 금지 행동, 결과 형식이 있는 지시에서 안정적으로 동작합니다. 아래처럼 읽기 전용 업무부터 시작하세요.

오늘 HOWCONTENT 사이트 상태를 읽기 전용으로 확인해줘.
- 대상: https://howcontent.co.kr/guides
- 확인: 200 응답, 제목 노출, 최신 글 3개 링크
- 금지: 파일 수정, 배포, Notion 변경
- 결과: 표로 요약하고 이상 있으면 원인 후보 2개만 제시

이 형식은 홈페이지 운영, 쇼핑몰 상품 점검, 광고 랜딩페이지 확인, Notion 게시글 검수에도 그대로 응용할 수 있습니다.

단계 5. 예약 리포트는 cron으로 작게 시작하기

Hermes cron은 예약된 시간에 새 에이전트 세션을 실행하고 결과를 지정한 채널로 보낼 수 있습니다. 처음에는 사이트 상태나 게시글 노출 확인처럼 위험이 낮은 읽기 작업만 등록합니다.

# 등록된 예약 작업 확인
hermes cron list
hermes cron status

# 예: 매일 오전 점검은 대화형 /cron 또는 hermes cron create로 등록

단계 6. 승인 규칙과 금지선을 문서화하기

업무 자동화 에이전트 운영에서 가장 중요한 질문은 ‘무엇을 할 수 있나’가 아니라 ‘무엇을 자동으로 하면 안 되나’입니다. Discord 채널 상단 고정 메시지나 팀 문서에 아래 기준을 적어두세요.

• 자동 허용: 공개 페이지 확인, 읽기 전용 리포트, 초안 작성, 내부 파일 요약
• 승인 필요: Git push, Vercel 배포, Notion 공개 게시, 고객 메시지 발송, 광고 상태 변경
• 항상 금지: 토큰 출력, 쿠키 공유, 고객 개인정보 전문 노출, 확인 없는 삭제

5. 잘 되었는지 확인하는 방법

설정이 끝났다면 기능이 ‘보이는지’보다 실제로 안전하게 동작하는지 확인해야 합니다. 다음 순서로 검증하세요.

1. Discord 테스트 채널에서 ‘현재 시간과 사용 가능한 도구를 요약해줘’라고 요청합니다.
2. Hermes가 응답하고, 필요하면 도구 사용 진행 상황이 표시되는지 확인합니다.
3. 읽기 전용 사이트 점검을 지시하고, 실제 URL·상태 코드·근거가 결과에 포함되는지 봅니다.
4. 위험 작업을 일부러 요청해 ‘승인 필요’ 또는 ‘실행하지 않음’으로 멈추는지 확인합니다.
5. 예약 작업이 있다면 hermes cron list와 gateway 로그에서 마지막 실행·전달 상태를 확인합니다.

6. 자주 나는 오류와 해결법

오류 1. Discord에서 봇이 답하지 않습니다

먼저 Hermes Gateway가 실행 중인지 확인하고, Discord 봇 권한과 메시지 콘텐츠 접근 설정을 점검합니다. 채널 접근 권한이 없으면 Hermes가 정상이어도 메시지를 읽지 못합니다.

hermes gateway status
hermes doctor

오류 2. 로컬에서는 되는데 Discord에서는 도구를 못 씁니다

Hermes는 플랫폼별로 활성화된 도구가 다를 수 있습니다. hermes tools에서 Discord 또는 gateway/cron 플랫폼의 toolset 구성을 확인하세요.

오류 3. 너무 많은 권한을 요구합니다

처음부터 터미널·파일쓰기·외부 발송을 모두 켜지 마세요. 조회형 업무와 보고형 업무를 먼저 안정화한 뒤, 필요한 권한만 추가합니다.

오류 4. 예약 작업 결과가 엉뚱한 채널에 갑니다

cron 작업의 delivery target을 확인하세요. 운영용 Discord 스레드가 정해져 있다면 origin에 의존하지 말고 명시적인 대상 채널·스레드를 지정하는 편이 안전합니다.

오류 5. AI가 실행한 결과를 믿기 어렵습니다

결과에 URL, 파일 경로, HTTP 상태, 테스트 출력처럼 재검증 가능한 근거를 요구하세요. ‘완료했다’는 말만 있고 실제 근거가 없으면 성공으로 처리하지 않습니다.

7. 운영 체크리스트

• 첫 설정 후 hermes doctor로 기본 상태를 점검했다.
• Discord 테스트 채널과 운영 채널을 분리했다.
• 조회·요약·초안 작성과 실제 변경 작업의 승인 기준을 나눴다.
• 토큰·고객정보·계정 권한을 채팅에 직접 노출하지 않는 규칙을 만들었다.
• cron 작업은 읽기 전용부터 시작했고, 전달 대상 채널을 확인했다.
• 실행 결과에는 상태 코드, URL, 파일 경로, 로그 같은 검증 근거를 포함하게 했다.
• 팀원이 쓰는 요청 템플릿을 3개 이상 만들어 고정했다.

8. 업무별 요청 예시

홈페이지 운영자용

/guides 목록과 sitemap.xml을 읽고 최신 가이드가 포함되어 있는지 확인해줘.
변경 작업은 하지 말고, 누락이 있으면 가능한 원인만 정리해줘.

쇼핑몰 운영자용

상품 상세페이지 3개의 첫 화면, CTA, 배송/교환 안내 노출 여부를 체크리스트로 검토해줘.
고객 개인정보나 주문 데이터는 조회하지 마.

콘텐츠 운영자용

이번 주 발행 후보 5개를 SEO 관점에서 정리하고, 각 글의 검색 질문과 필요한 이미지 역할을 제안해줘.
Notion에는 아직 쓰지 말고 초안만 보여줘.

우리 팀에서 Hermes Agent, Discord AI 비서, 업무 자동화 에이전트 구조를 도입하고 싶지만 보안·권한·운영 규칙까지 정리하기 어렵다면 HOWCONTENT가 현재 업무 흐름에 맞춰 작은 자동화부터 설계해드릴 수 있습니다.

9. FAQ

Q1. Discord에서 AI 비서를 운영하려면 어떻게 해야 하나?

Hermes Agent를 먼저 설치하고 모델·도구 설정을 끝낸 뒤, Hermes Gateway로 Discord를 연결합니다. 그다음 테스트 채널에서 읽기 전용 요청을 성공시키고 운영 채널로 확장하세요.

Q2. Hermes Agent는 어떤 업무를 자동화할 수 있나?

사이트 상태 점검, 문서 요약, 파일 정리, 브라우저 기반 확인, 예약 리포트, 초안 작성, 내부 체크리스트 작성 같은 반복 업무를 자동화할 수 있습니다. 외부 발송·배포·삭제는 승인 절차를 두는 것이 안전합니다.

Q3. Discord AI 비서와 일반 챗봇의 차이는 무엇인가요?

일반 챗봇은 주로 답변을 생성하지만, Hermes Agent 기반 Discord AI 비서는 설정된 도구를 사용해 파일·브라우저·예약 작업·세션 기록을 실제로 확인하고 실행 결과를 보고할 수 있습니다.

Q4. 비개발자도 Hermes Agent를 쓸 수 있나요?

기본 설치와 Gateway 연결에는 터미널 작업이 필요합니다. 하지만 운영 단계에서는 Discord에서 요청 템플릿을 쓰는 방식으로 비개발자도 반복 점검과 보고를 맡길 수 있습니다.

Q5. 어떤 권한부터 켜는 것이 안전한가요?

처음에는 읽기 전용 확인, 웹 검색, 브라우저 검증, 세션 검색, 예약 보고처럼 되돌릴 필요가 없는 범위부터 시작하세요. 파일 수정, 배포, 외부 메시지 발송은 검수 후 단계적으로 추가합니다.

Q6. cron으로 완전 자동 발행까지 해도 되나요?

가능은 하지만 바로 권장하지 않습니다. 초안 생성과 점검 보고까지 자동화하고, 공개 발행·배포·고객 발송은 승인 큐를 거치는 구조가 더 안전합니다.

Q7. 토큰이나 API 키는 어디에 넣어야 하나요?

일반적으로 비밀값은 환경 파일이나 안전한 비밀 저장소에 두고, Discord 메시지에 직접 붙여넣지 않습니다. Hermes 설정에서도 config.yaml에는 일반 설정, .env에는 비밀값을 두는 식으로 구분합니다.

마무리: 작게 시작해서 운영 규칙을 먼저 고정하세요

Hermes Agent로 Discord에서 업무 자동화 비서를 운영할 때 가장 좋은 시작점은 ‘작은 읽기 작업 1개를 매일 안정적으로 처리하게 만드는 것’입니다. 그다음 팀의 반복 업무를 하나씩 붙이면 AI 도입이 보여주기식 챗봇이 아니라 실제 운영 시스템으로 바뀝니다.

HOWCONTENT는 홈페이지·쇼핑몰·콘텐츠 운영에 필요한 자동화 흐름을 실제 업무 기준으로 설계합니다. Discord AI 비서, 문의 요약, 사이트 점검, 콘텐츠 발행 루틴처럼 반복되는 일을 줄이고 싶다면 현재 운영 방식부터 함께 정리해보세요.