목표는 내가 허용한 사용자만 접근하는 봇 하나다. 모델 공급자 하나로 먼저 CLI 응답을 확인한 다음 Slack을 연결한다. 기본 경로는 Apple Silicon macOS의 CLI 설치다. 다른 OS는 사전 점검에서 현재 공식 지원 경로를 선택한다. native Windows를 일괄 미지원으로 취급하지 않는다.
검증 범위: 기존 Mac의 설치 메타데이터·코드·번들 문서를 읽어 작성한 절차 제안이다. 새 기기에서 설치를 재현한 결과가 아니다. 공식 최신 문서 교차 검증을 반영했다. 조사 시 최신 릴리스는 v0.22.5이며 로컬 설치 v0.22.2와 구분한다. 문서 비교는 신규 설치 테스트가 아니다.
먼저 읽기: 내가 할 일과 CLI AI에게 맡길 일
CLI AI에게 아래 단계의 프롬프트를 차례대로 복사한다. AI는 컴퓨터 확인, 지원되는 설치 방법 조사, 설정 준비와 오류 진단을 맡는다. 한 단계가 성공한 뒤 다음 단계로 간다.
사람이 직접 하는 일은 다음 다섯 가지다.
- 사용할 모델 공급자 하나를 고르고 로그인·요금 조건을 확인한다.
- Slack에서 앱을 만들고 권한을 검토해 설치에 동의한다. 서로 다른 두 토큰인 app-level token과 bot token을 발급한다.
- 두 토큰은 AI 채팅에 보내지 않고, 사람이 쓰는 별도 로컬 터미널이나 편집기에 직접 넣는다. AI가 보는 터미널은 비밀 입력에 쓰지 않는다.
- 본인 Member ID를 허용 사용자로 지정하고 봇을 테스트 채널 하나에 초대한다.
- DM 한 번, 채널에서 봇 멘션 한 번, 같은 스레드에서 후속 메시지 한 번을 직접 보내 확인한다. 자동 시작은 성공 후 원하는 경우에만 승인한다.
기본 대화 방식: 채널에서는 처음에 봇을 @mention하고, 그 스레드 안에서는 멘션 없이 대화를 이어 간다. 다른 새 채널 메시지에는 다시 멘션이 필요하다. 기본편에는 Docker나 공개 URL 설정이 없다.
별도 비밀 관리 앱이 반드시 있어야 하는 것은 아니다. 일반 로컬 터미널의 공식 대화형 입력이나 로컬 편집기도 가능하다. 다만 화면 공유·녹화·터미널 기록·AI 화면 캡처가 없어야 하며, 토큰을 명령 인자나 셸 히스토리에 넣지 않는다. 이 조건을 확인할 수 없으면 입력을 멈춘다.
0. 모든 단계 앞에 붙이는 공통 안전 계약
아래 블록을 CLI AI 대화 첫 메시지에 붙이고, 이후 단계 프롬프트를 순서대로 전달한다.
너는 초보자의 Hermes + Slack 설치를 돕는 CLI AI다. 아래 계약은 모든 단계에 적용한다.
1. 먼저 OS/CPU/셸/현재 사용자와 기존 Hermes·서비스를 읽기 전용으로 조사한다. 기존 설치가 있으면 새 gateway를 추가 실행하거나 업데이트·재설치하지 말고 재사용 가능성을 확인한다.
2. 설치된 버전의 --help, 공식 문서, 지원되는 설정만 사용한다. Hermes source/core 수정, fork, monkey patch, 승인 우회 실행기를 만들지 않는다.
3. 매 단계는 사전 조건→작업→검증→실패 시 중단/복구 순서다. 실패를 무시하고 다음 단계로 넘어가지 않는다. 미확인과 성공을 구분한다.
4. 기존 설정/사용자 수정 내용을 보존한다. 변경 전 비공개 로컬 백업과 제한된 권한을 준비하고 비밀 없는 변경 요약을 보여 준다. 기존 서비스 중단·재시작, 권한 변경, 자동 시작, 공개 노출은 구체적 변경안에 대한 사람 승인을 받은 뒤에만 한다.
5. OAuth 로그인, 워크스페이스 선택, 앱 설치 동의, 토큰 발급, 채널 초대와 테스트 메시지는 사람이 한다. 관리자 권한이나 공개 네트워크 노출을 기본 전제로 하지 않는다.
6. 토큰/키를 AI 채팅이나 Slack에 붙여 달라고 하지 않는다. 비밀 파일을 읽거나 cat/env/printenv로 출력하지 않는다. 토큰은 사람이 AI가 캡처하지 않는 별도 로컬 터미널의 공식 입력이나 로컬 편집기에 직접 넣게 한다. 인자·셸 히스토리·스크립트·로그·스크린샷·클립보드 산출물·Git에 남기지 않는다.
7. 자격증명은 값 대신 존재/유효성 성공·실패만 확인한다. 대화에 보이는 터미널에서는 입력하지 않도록 안내한다. 별도 일반 로컬 터미널/편집기를 사용해도 되지만 화면 캡처·기록·히스토리 노출이 없음을 확인할 수 없으면 멈춘다. 자동 생성한 토큰 입력 스크립트로 대체하지 않는다.
8. Docker/ngrok/LiteLLM/n8n/Qdrant/Ollama는 기본 연결에 설치하지 않는다. 다른 서비스·라우팅·토큰·스케줄을 건드리지 않는다.
9. 오래 걸리는 요청에 후속 메시지를 반복 전송하지 않는다. 먼저 로컬 상태/마스킹된 로그로 실행 중인지 확인한다. 재시도는 중복 작업 여부를 확인한 뒤 한 번씩 한다.
10. 완료 보고에는 버전·바뀐 비밀 없는 설정 키·검증 결과·남은 수동 행동·복구 방법을 적는다. 신선한 설치를 테스트하지 않았다면 그렇게 명시한다.
입력 준비물: 설치할 컴퓨터, 지원되는 모델 공급자 계정 하나, 앱을 설치할 수 있는 Slack 워크스페이스, 테스트 채널 하나. 조직의 앱 승인이 필요하면 승인 전까지 중단한다. 기존 운영 봇을 테스트 봇으로 바꾸지 않는다.
1. 설치 전에 환경과 기존 실행 상태 확인
공통 안전 계약을 적용해 읽기 전용 사전 점검만 해 줘.
OS/버전/CPU/셸, Hermes 실행 파일 위치와 지원되는 버전 조회, 기존 gateway·사용자 서비스의 존재, 작업 폴더 쓰기 가능 여부를 확인해 줘. 프로세스 전체 인자나 환경변수는 출력하지 마.
비밀 파일의 내용은 읽지 말고 존재/권한 메타데이터와 필요한 설정 키만 확인해 줘. 원시 config나 로그를 통째로 출력하지 마.
공식 설치 문서와 현재 설치 방식에 맞는 경로 하나를 추천하고, 필요한 다운로드·디스크·예상 변경을 설명해 줘. 기존 설치면 유지하고 문서와 버전 차이를 먼저 보고해 줘. 버전 조회가 잠금 파일 쓰기를 요구하거나 실패하면 권한을 바꾸거나 직접 내부 실행기로 우회하지 말고 중단해 줘.
아직 설치/서비스 실행/토큰 입력을 하지 마.
확인할 결과기대 결과: 설치 유무와 재사용/새 설치 선택이 명확하다. 버전·아키텍처가 불명확하면 다음으로 가지 않는다. 읽기 불가능한 파일은 접근 권한을 넓혀 해결하지 않는다.
2. 공식 지원 방식으로 설치하고 버전 기록
새 기기에서만 사용하는 요청이다. 기존 설치는 유지하며 단계 3으로 간다. “최신”은 시간이 지나므로 문서에 적힌 숫자를 무조건 설치하지 않는다. 설치 시 선택한 안정 버전/배포 방식을 기록하고 같은 버전으로 재현할 수 있는 공식 방법을 확인한다.
사전 점검을 통과한 새 기기다. 공식 Hermes 설치 문서에서 이 OS/CPU에 지원되는 CLI 설치 방법을 확인해 줘.
선택한 안정 릴리스, 다운로드 출처, 공식 버전 고정/선택 지원 여부와 설치기의 실제 옵션을 확인한 구체적 설치안을 먼저 보여 줘. 내가 설치를 승인하면 그 방법만 실행해 줘. 승인 전에는 다운로드 스크립트를 실행하지 마.
버전 고정 옵션이 문서화돼 있지 않으면 플래그를 발명하거나 임의 git checkout/pip 설치로 대체하지 말고 재현성 한계를 설명해 줘. 새 설치를 위해 기존 설치를 업그레이드하지 마.
설치 후 새 셸에서 hermes --version과 hermes --help를 확인하고 버전·설치 방식·출처를 비밀 없는 기록으로 남겨 줘. 실패하면 다음 단계로 가지 말고 원인을 요약해 줘. 아직 gateway를 시작하지 마.
공식 출처: 설치 문서, 릴리스 목록. 공식 POSIX 설치기 주소는 https://hermes-agent.nousresearch.com/install.sh다. 주소 자체가 실행 승인이나 고정 버전을 뜻하지 않는다. 이 안내는 원격 스크립트 자동 실행 명령을 제공하지 않는다.
검증: 설치 버전 출력 및 도움말 정상. 실패 시 설치 로그에서 비밀 없는 오류 부분만 읽는다. 복구는 이번 설치가 만든 항목을 식별하고 공식 제거/복구 절차를 검토한 뒤 사람 승인으로 시행한다. 기존 홈·설정·공용 런타임을 지우지 않는다.
3. 모델 공급자 하나만 로그인
설치 버전 도움말과 공식 모델 설정 문서를 확인하고, 내가 가진 계정으로 지원되는 공급자 하나만 연결하게 도와줘.
지원되는 OAuth/device login 또는 API key 방식 중 하나를 선택할 수 있게 인증 방식·요금 주체·모델 접근 조건을 설명해 줘. 구독이 API 사용 권한을 자동 제공한다고 가정하지 마.
설치 버전에서 지원되는 hermes model 및 필요 시 hermes auth 명령을 확인한 뒤 사람이 로그인/동의하도록 중단해 줘. device code도 공개 채팅에 출력하지 말고 로컬 로그인 화면에서만 다루게 해 줘.
API key가 필요하면 로컬 입력 화면의 마스킹·저장 방식을 확인해 줘. 비밀을 에이전트가 보는 터미널이나 채팅에 입력시키지 마.
인증 완료 후 사람에게 CLI에서 '테스트입니다. OK 한 단어만 답하세요.'를 한 번 입력하도록 안내해 줘. 사용 가능 모델 하나와 성공 여부만 기록해 줘. fallback/router는 만들지 마.
확인할 결과기대 결과: Slack 없이도 모델이 한 번 응답한다. 로그인 성공만으로 모델 호출 성공을 간주하지 않는다. 401은 인증, 403은 계정/모델 권한, 429는 제한·잔액을 확인하고 공급자 문서에 맞게 대응한다. 무한 재시도·공급자 자동 추가는 하지 않는다. 복구는 이번 선택만 원복하고 기존 인증은 임의 삭제하지 않는다.
4. Slack 앱 계획과 사람이 해야 할 작업
설치 버전에서 hermes slack manifest --help 및 gateway setup 도움말을 확인해 줘. 새 Slack 앱에 agent-view 매니페스트를 지원하면 공식 생성 명령으로 비밀 없는 매니페스트를 준비해 줘. 이 옵션이 없으면 현재 버전의 공식 지원 방법을 확인하고 멈춰서 선택안을 제시해 줘.
생성될 파일의 기존 내용이 있으면 보존해 줘. 각 scope/event의 목적, Socket Mode 여부, DM 메시지 허용 설정을 요약하고 사람이 Slack에서 검토할 체크리스트를 만들어 줘. 앱 생성/설치 동의/토큰 발급을 대신 클릭하지 마.
필요한 자격증명 종류는 SLACK_BOT_TOKEN과 SLACK_APP_TOKEN으로 설명하되 값은 받지 마. 허용 사용자 식별자는 display name이 아니라 Slack Member ID임을 설명해 줘.
설치 v0.22.2 코드·번들 문서에서 확인한 생성 명령은 hermes slack manifest --agent-view --write다. 대상 버전 도움말을 확인한 뒤 사용한다. 매니페스트는 권한을 미리 선언하지만 사용자의 동의를 대신하지 않는다. 생성된 모든 권한을 검토하고 불필요한 기능은 지원되는 범위에서 줄인다.
사람만 수행할 체크포인트
- Slack 앱 관리에서 대상 워크스페이스를 확인한다. 새 앱을 매니페스트로 만들고 이름은 예를 들어
Study Helper로 정한다. 실운영 앱을 덮어쓰지 않는다. - Socket Mode가 켜져 있는지 확인하고, app-level token을
connections:write권한으로 발급한다. 이것은xapp-종류이며 봇 토큰과 다르다. - 앱의 Bot OAuth scopes와 bot events를 검토한다. 기본 대화는
app_mention,message.im,message.channels가 중요하고, private channel은message.groups, group DM은message.mpim도 필요하다. 실제 요구 목록은 생성된 버전별 매니페스트를 기준으로 한다. - App Home에서 메시지 탭과 사용자 메시지 허용을 확인한다. 새 앱 Agent view와 기존 Assistant view UI는 다를 수 있다. DM을 보낼 수 없다면 이 부분을 확인한다.
- 워크스페이스 설치 동의를 사람이 승인한다.
xoxb-종류의 bot token을 발급받는다. 조직 관리자 승인 대기면 다음 단계로 가지 않는다. scopes/events 변경 뒤에는 재설치가 필요한지 확인한다. - 본인 Member ID와 테스트 채널을 확인한다. 봇을 그 채널에 직접 초대한다. private channel은 초대가 필요하다.
- 두 토큰은 다음 단계의 안전한 로컬 입력에서만 넣는다. 토큰 값은 AI/Slack/이 문서/셸 명령에 붙이지 않는다. 노출되면 사용을 중단하고 사람이 Slack에서 폐기·재발급한다.
권한·이벤트 전체 목록을 고정 JSON으로 복제하지 않는다. 설치 버전의 생성 매니페스트를 사람이 검토한다. 기능을 줄이려면 지원 여부를 확인하고 scopes/events/실제 기능을 함께 검증한다.
5. 공식 gateway 설정 경로로 연결
모델 CLI 테스트와 Slack 사람 체크포인트를 통과했다. 설치 버전에서 지원되는 hermes gateway setup을 사용해 Slack 하나를 설정하게 도와줘.
먼저 기존 gateway 실행 여부를 확인하고 중복 실행하지 마. 사람이 직접 실행하는 로컬 대화형 입력 화면에서 토큰을 넣도록 안내하되, 토큰이 화면에 보이거나 세션에 기록되는 방식이면 멈춰 줘. 대안은 사람이 별도 일반 로컬 터미널이나 비기록 로컬 편집기를 쓰는 방법으로 설명해 줘. 표준 경로 ~/.hermes/.env와 ~/.hermes/config.yaml은 설명해도 되지만 실제 개인 값·식별자는 공유하지 마.
SLACK_ALLOWED_USERS는 본인 Member ID 한 명으로 시작하고 allow-all은 켜지 마. 초대와 지원되는 allowed_channels 설정으로 테스트 채널 하나로 제한하는 구체적 변경안을 제시해 줘. ID는 사람이 로컬에서 입력하고 공유 출력에는 placeholder만 사용해 줘. 예약 발송은 설정하지 마.
지원되는 YAML 경로와 환경변수 우선순위를 확인하고, 테스트 채널에서 require_mention=true, strict_mention=false, thread_require_mention=false, allow_bots=none 정책을 적용할 최소 변경을 비밀 없는 diff로 제시해 줘. 기존 설정이면 정책 변경 승인을 기다려 줘. free-response 예외 채널은 만들지 마.
설정 키 오타·동일 키 중복·관리자 pins·서비스 환경변수 우선순위를 확인해 줘. 비밀 없는 유효 설정 검증 후에만 다음 단계로 넘어가 줘.
확인할 결과기대 결과: 설정 저장과 유효 정책이 확인된다. .env 형식에 저장하는 설치 방식은 파일이 자동 암호화됐다고 가정하지 않는다. 사람이 소유권·사용자만 읽을 수 있는 권한·백업·Git 제외를 확인한다. 표준 경로 ~/.hermes/.env에는 Slack 토큰·허용 사용자 환경변수를, ~/.hermes/config.yaml에는 지원되는 정책 설정을 둔다. 설치·프로필 방식에 따라 실제 적용 위치가 다를 수 있으므로 도움말을 확인한다. 표준 경로와 key 이름은 설명하되 실제 개인 토큰·Member ID·채널 ID는 공유 예제에 복제하지 않는다.
정책의 의미:
| 상황 | 이 안내의 의도 |
|---|---|
| 허용된 사용자의 1:1 DM | @mention 없이 응답; 사용자 인증/allowlist는 별도로 적용 |
| 채널 새 메시지 | 봇을 직접 @mention해야 응답 |
| 참여한 스레드의 후속 메시지 | 멘션 없이 대화 이어가기 |
| 그룹 DM | 1:1 DM과 달리 공유 공간 정책 적용 |
| 다른 봇의 메시지 | 기본편에서는 무시 |
기본 정책에서는 봇이 참여한 스레드의 후속 메시지에 멘션 없이 응답할 수 있다. require_mention은 새 채널 대화를 시작할 때 적용된다. 그룹 DM은 1:1 DM과 다른 공유 공간이며, 실제 동작은 적용 설정과 사용자·채널 제한을 함께 확인한다.
선택: 바쁜 워크스페이스에서 매번 멘션하기
봇이 스레드 후속 대화에 자동 참여하는 것을 원하지 않을 때만 사람이 별도 선택한다. 지원되는 설정으로 strict_mention=true, thread_require_mention=true를 요청하고, require_mention=true, allow_bots=none과 채널 제한을 유지한다. 기존 운영 설정 변경은 승인 후 적용한다. 코드 수정은 하지 않는다.
이 선택에서는 아래 테스트 C의 기대 결과만 무멘션 응답 없음으로 바뀐다. DM은 여전히 멘션 없이 사용할 수 있다. free-response 예외·강제 처리 경로도 있으므로 설정 이름만 보고 모든 트리거를 차단한다고 단정하지 않고 실제 테스트한다.
6. gateway 한 개와 수동 smoke test
이제 기존 gateway 여부를 다시 확인해 줘. 없을 때만 공식 foreground 명령 hermes gateway run을 도움말로 확인·설명하고 실행 승인을 받아 한 개를 시작해 줘. 기존 서비스면 두 번째 foreground gateway를 띄우지 말고 승인된 적용 절차만 안내해 줘.
아래 수동 테스트를 사람에게 한 건씩 요청하고 이전 요청이 끝나기 전에 다음 메시지를 보내지 않게 해 줘. 외부 메시지는 대신 보내지 마.
실패하면 다음 테스트/자동 시작으로 진행하지 말고 마스킹된 로컬 로그, 인증, Socket Mode, scopes/events, channel membership, allowlist, mention 정책 순으로 진단해 줘. 원시 로그/토큰/메시지 원문은 결과에 붙이지 마.
사람이 직접 Slack에서 실행한다.
| 순서 | 행동 | 통과 기준 |
|---|---|---|
| A | 봇 1:1 DM: 테스트입니다. OK만 답해 주세요. |
한 번 응답 |
| B | 테스트 채널: @Study Helper 테스트입니다. OK만 답해 주세요. |
해당 메시지/스레드에 한 번 응답 |
| C | 같은 스레드: 이어서 답해 주세요. OK만 써 주세요. |
기본 정책에서 멘션 없이 한 번 응답; 선택한 엄격 정책에서는 응답 없음 |
| D | 같은 스레드: @Study Helper 이번에는 답해 주세요. |
한 번 응답 |
| E | 채널 새 메시지, 멘션 없음 | 응답 없음 |
권한 없는 계정 테스트는 그 사람의 동의와 조직 정책을 먼저 확인한 경우에만 한다. 현재 테스트와 구분된 별도 승인으로 실행한다. 새 채널 메시지의 무멘션 차단과 선택한 엄격 정책의 무멘션 차단은 로그에 이벤트가 도착했는지와 정책상 무시됐는지를 함께 확인한다. 일정 시간 조용하다는 것만으로 올바른 gating을 증명하지 않는다.
느려도 반복 지시하지 않는다. 모델 요청이 진행 중인지 먼저 본다. 정상 응답은 한 번, 같은 이벤트 중복 처리 없음, 대상 스레드와 모델 오류 없음까지 확인해야 성공이다. 이번 문서 작성에서 위 테스트는 실행하지 않았다.
7. 선택: 승인한 사용자 자동 시작
수동 테스트 결과를 먼저 요약해 줘. 모두 통과했을 때만 현재 OS와 설치 방식에서 지원되는 사용자 서비스 설치/상태/중지/제거 명령을 --help와 공식 문서로 확인해 줘.
로그 위치, 로그인 시 동작과 절전/네트워크 끊김 한계, 변경되는 사용자 서비스 항목, 중복 실행 방지와 복구 방법을 보여 주고 자동 시작을 원하는지 승인받아 줘. 시스템 서비스나 sudo를 기본 사용하지 마.
내가 승인하면 공식 사용자 서비스 방식만 적용하고 서비스 하나·재연결·DM 한 건의 수동 검증을 안내해 줘. 설치 실패나 보류를 성공 처리하지 마.
설치 문서에는 hermes gateway install 사용자 서비스 경로가 있다. 실제 OS·설치 버전 도움말을 우선한다. 설치만으로 재부팅 후 동작을 검증했다고 기록하지 않는다. 사람이 실제 재로그인/재부팅을 승인하고 수행한 경우에만 그 결과를 추가한다.
문제가 생겼을 때
| 증상 | 먼저 확인 | 피할 행동 / 복구 |
|---|---|---|
| DM 전송 자체 불가 | App Home 메시지 허용, 앱 설치 | Hermes 재설치로 해결하려 하지 않음 |
| DM 정상, 채널 무응답 | 봇 초대, events, scopes, 채널 제한, @mention | 공개 webhook/ngrok 추가 금지 |
| 인증 오류 | 토큰 종류·동일 앱 소속·폐기 여부 | 값 출력 대신 사람 재입력; 필요 시 수동 rotate |
| 스레드에 계속 끼어듦 | 실제 strict/thread 정책, free-response 예외, 환경 우선순위 | core 패치 대신 지원 설정; 승인 후 변경분 원복 |
| 중복 응답 | gateway 중복, 이벤트 중복 처리, 다른 봇/서비스 | 새 gateway 추가 금지; 소유자 승인 후 이번 실행만 중지 |
| 응답 지연·취소 | 실행 중 요청, 공급자 제한, 마스킹된 로그 | 반복 follow-up 금지; 중단/재시도는 중복 여부 확인 |
| 잠금·권한 오류 | 현재 사용자/설치 소유자·서비스 상태 | chmod/sudo/잠금 삭제 금지; 원인 보고 후 중단 |
롤백 원칙: 새로 만든 foreground 프로세스만 공식 종료 방식으로 끝내고, 승인한 변경 키만 비공개 백업과 비교해 복원한다. 서비스 제거는 이번 단계에서 설치한 서비스만 대상으로 사람 승인을 받는다. 토큰 폐기·앱 제거는 사람이 Slack에서 수행하며 기존 운영 앱·데이터를 삭제하지 않는다. 비밀 백업을 공유 산출물에 넣지 않는다.
기본편 완료 기록
OS/CPU: <검증한 환경>
Hermes 버전/설치 방식/출처: <확인 결과>
공급자/모델: <공개 가능한 이름만>
CLI 모델 호출: PASS/FAIL/미실행
Slack Socket Mode 연결: PASS/FAIL/미확인
대화 정책: 기본(스레드 후속 무멘션 허용) / 선택한 엄격 정책
DM / 채널 첫 멘션 / 스레드 무멘션 후속 / 새 채널 무멘션 차단: 각각 PASS/FAIL/미실행
선택한 엄격 정책일 때 스레드 무멘션 차단 / 스레드 멘션 응답: 각각 PASS/FAIL/미실행 또는 해당 없음
서비스: foreground 또는 승인된 사용자 서비스 / 실제 재부팅 검증 여부
미해결 항목/복구 방법: <비밀 없는 설명>
이 기록이 채워진 다음에만 고급편으로 간다.
공식 근거와 기능 범위
공식 설치기는 uv/Python 등 런타임을 관리하므로 오래된 수동 Python 설치를 선행 요구하지 않는다. Hermes 자체를 pip/uv tool/brew로 임의 설치하는 레시피는 사용하지 않는다. 설치기는 브라우저·컴퓨터 사용 구성요소도 준비할 수 있으므로 “채팅만 가능한 무실행 도구”라고 설명하지 않는다. Blank Slate도 파일·터미널 기능을 가질 수 있다. 도구 권한은 실제 설정과 사람 승인으로 제한한다. hermes setup --portal은 최소 공급자 하나 연결과 다르며 이 기본편의 필수 절차가 아니다. hermes login은 현재 문서에서 deprecated이므로 버전에 맞는 hermes auth를 확인한다.
POSIX 비밀 파일은 사용자만 읽는 600 권한을 기준으로 사람이 검토하고, 기존 파일 권한 변경은 구체적 승인을 받아 시행한다. Windows 권한은 POSIX chmod 대신 해당 OS 방식을 확인한다. macOS launchd, Linux systemd, Windows 작업 스케줄러를 혼동하지 않는다. WSL 기본편은 foreground 성공까지로 끝내고 자동 시작은 별도 검증한다. /etc/wsl.conf를 덮어쓰지 않는다. 잠자거나 꺼진 컴퓨터가 자동 시작 설정만으로 온라인 상태를 유지하지는 않는다. Intel macOS는 문서의 지원 조건이 충돌할 수 있어 설치 전 현재 배포판 지원 여부를 별도 확인한다.
진단 명령 후보는 hermes doctor, hermes status, hermes gateway status, hermes logs gateway -n 100이다. 실제 설치 버전 도움말에서 명령·옵션을 확인하고 비밀 없는 부분만 요약한다. Slack 스레드 중단 !stop과 최상위 /stop은 설치 버전 지원을 확인한다. 중단 없이 기다릴지, 중단 후 재시도할지 사람이 선택하게 하며 반복 follow-up으로 중단을 유발하지 않는다.