본문으로 이동

Hermes: 두 판 사이의 차이

학교의 모든 지식. SMwiki
← 이전 편집
편집 취소Sam (토론 | 기여)
봇, 사무관, 인터페이스 관리자, 푸시 구독 관리자, 기록보호자, 관리자, 교사
9,684 편집
시각위키텍스트
잔글 →설치
 
(같은 사용자의 중간 판 12개는 보이지 않습니다)
8번째 줄: 8번째 줄:
|-
|-
|준비
|준비
|
|필요한 것은 설치 과정 중에 자동으로 설치된다.
|sudo apt update
|sudo apt update
sudo apt install -y curl
|-
|-
|설치
|설치
|필요한 것들이 자동 설치되는데, 꽤 걸린다.
|공식 홈페이지에서 손쉽게 안내한다.
|<nowiki>curl -fsSL https://openclaw.ai/install.sh | bash</nowiki>
터미널에서 설치하는 게 간편하지. 웬만한 것들은 자동으로 해주니까.
 
* 필요한 것들이 자동 설치되는데, 꽤 걸린다.
* 설치할 때 이것저것 묻는데, openclaw가 있으면 통합할거냐고도 물어본다.
* 설치할 때 로그인이 필요하다. 링크를 주는데, 거기 로그인해서 구독제를 선택한다.(free 있음) 카드와 연결하면 됨. 이걸 해야 다음단계로 진행된다.
* 툴 선택에선 그냥 맘 편하게 다 체크하면..
* 게이트웨이는.. LLM 중계자.. 및 채널과 연동하는 녀석인데... 잘 모르면 설치하는 게 편할 듯.
|https://hermes-agent.nousresearch.com/
|-
|-
|확인
|확인
|버전 출력되면 성공.
|버전 출력되면 성공.
이후 자동으로 설정 진행.
이후 자동으로 설정 진행.
|openclaw --version
|hermes --version
hermes doctor
|}
|}


 
=== 설정 ===
 
== 지원 환경 ==
지원되는 운영체제와 요구사항은 다음과 같습니다.
 
{| class="wikitable"
{| class="wikitable"
|+ 요구사항
!과정
|-
!설명
! 항목
!비고
! 요구 조건
|-
| 운영체제
| Linux (Ubuntu 20.04+), macOS 12+, Windows 10+
|-
| PHP
| 8.2 이상
|-
| 데이터베이스
| MariaDB 10.6+, MySQL 8+, PostgreSQL 13+, SQLite 3
|-
|-
| 웹서버
|설정 시작
| Apache 2.4+, Nginx + PHP-FPM
|LLM 모델 등 연결을 하게 되는데... 이건 좀 공부가 필요할 듯;
쉬우면..서도 어렵다. 매번 할때마다 헷갈리고;;
|hermes setup
|-
|-
| 메모리
|채널 연동
| 2GB 이상 (권장 4GB)
|[[메신저 채널 연동]] 참고.
|디스코드의 경우, ~/.hermes/.env에서DISCORD_REQUIRE_MENTION=False 입력으로 멘션 없이 채팅 가능하다.
|-
|-
| 저장 공간
|게이트웨이 실행
| 1GB 이상
|<code>nohup hermes gateway > hermes.log 2>&1 &</code> 으로 백그라운드에서 돌려도 되지만, 재부팅하면 꺼짐.
|}
하여, systemd로 만드는 게 일반적이다.


== 준비물 ==
* which hermes 해서 나온 경로를 비고의 ExecStart 로 넣는 넛이 목표다.(보통 <code>/home/사용자명/.local/bin/hermes</code>)(마지막에 띄어쓰고 gateway는 살려둔다.)
설치 전에 다음을 준비합니다.
* sudo nano /etc/systemd/system/hermes-gateway.service
* 코드를 기입한다.
* sudo systemctl daemon-reload
* sudo systemctl enable hermes-gateway 
* sudo systemctl start hermes-gateway
* <code>systemctl status hermes-gateway</code> 로 확인.
* 로그는 <code>journalctl -u hermes-gateway -f</code> 로 본다.
|<syntaxhighlight lang="ini">
[Unit]
Description=Hermes Gateway
After=network.target


* 웹서버 접근 권한 또는 로컬 서버 환경
[Service]
* 데이터베이스 생성 권한 (운영 환경)
User=id8436
* Hermes 설치 파일 또는 Git 소스
ExecStart=경로 gateway
Restart=always


== 설치 절차 ==
[Install]
 
WantedBy=multi-user.target
=== 1. 설치 파일 얻기 ===
</syntaxhighlight>
Git으로 소스를 가져오거나 공식 배포 파일을 다운로드합니다.
|-
 
|대시보드
# Git
|9119 포트로 대시보드를 띄운다.
<source lang="bash">
설정은 hermes에게 맡기면 된다. 아이디와 비밀번호 주고 tailscale 등으로 접속할 거라고.
git clone https://github.com/example/hermes.git
|hermes dashboard
cd hermes
sudo systemctl restart hermes-dashboard
</source>
|}
 
# 또는 배포 파일
[source|https://example.com/hermes/releases]
 
=== 2. 의존성 설치 ===
PHP 의존 패키지를 설치합니다.
 
<source lang="bash">
composer install
</source>
 
=== 3. 데이터베이스 생성 ===
운영 환경에서는 먼저 DB를 생성합니다.
 
# MariaDB 예시
<source lang="sql">
CREATE DATABASE hermes DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'hermes_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON hermes.* TO 'hermes_user'@'localhost';
</source>
 
=== 4. 웹 서버 설정 ===
Apache 또는 Nginx에서 설치 경로를 웹root로 연결합니다.
 
* Apache: `DocumentRoot` 설정
* Nginx: `root` 설정과 `index.php` 처리
 
=== 5. 초기화 실행 ===
설치 스크립트 또는 웹 초기화 페이지를 실행합니다.
 
* 웹: `http://your-domain/install.php`
* CLI: `php bin/hermes install`
 
== 기본 설정 ==
설치 후 `LocalSettings.php`(미디어위키) 또는 Hermes 전용 설정 파일에서 값을 조정합니다.


=== 사용 ===
{| class="wikitable"
{| class="wikitable"
|+ 권장 설정 항목
!과정
!설명
!비고
|-
|-
! 항목
|설정 시작
! 권장값
|LLM 모델 등 연결을 하게 되는데... 이건 좀 공부가 필요할 듯;
! 설명
쉬우면..서도 어렵다. 매번 할때마다 헷갈리고;;
|hermes setup
|-
|-
| 언어
|설정 변경
| ko
|
| 위키 언어
* 환경변수 설정: nano ~/.hermes/.env
* 설정 파일 수정: hermes config edit
|설정 반영 후엔 재시작.
sudo systemctl restart hermes-gateway
|-
|-
| 업로드 허용
|시작
| true
|처음 시작하면 모델 켜고 기타 등등 시간이 조금 걸린다.
| 파일 업로드 활성화
터미널 창보단 dashboard가 더 편하다.
|hermes chat
|-
|-
| 로그 레벨
|
| warning
|
| 로그 출력 수준
|
|-
| 캐시
| enabled
| 캐시 활성화
|}
|}


기본 설정 예시:
== 설치 후 처음 요구할 것 ==
 
아래 예시처럼 기본적인 것들을 프롬프트에 입력한다.(claude-sonnet-4.6 이상의 똑똑한 모델이어야 제대로 알아먹고 수정하는 듯하다. 문제는 비용. 아래 명령 실행해보니.. 대략 2$ 정도 소요되었다. Qwen 류도 적절히 작동한다.)
<source lang="php">
$wgLanguageCode = 'ko';
$wgEnableUploads = true;
$wgLogLevel = 'warning';
</source>
 
== 확인 방법 ==
설치가 성공했는지 확인합니다.
 
* Hermes 메인 페이지 접속
* `Hermes/변경이력` 페이지 존재 확인
* 관리자 패널에서 상태 확인
 
== 자주 나는 오류 ==
 
=== 업로드 불가 ===
* 웹서버 `upload_max_filesize` 설정 확인
* PHP `memory_limit` 확인
 
=== 데이터베이스 연결 오류 ===
* DB 사용자 권한 재확인
* `host`, `port`, `charset` 설정 확인


=== 웹서버 404 오류 ===
=== 권장 ===
* DocumentRoot 또는 `root` 경로 확인
* 비용 절감형 라우팅으로 설정해줘. 기본(일반 채팅·요약)은 로컬 LLM(OpenAI 호환 엔드포인트)으로, 복잡한 작업(코딩·추론)은 Claude/GPT 계열 강력 모델로 자동 라우팅해줘. 단, 로컬 LLM 사용할 때 기본적인 컨텍스트 확인해서 적절히 배치해줘.
* `index.php` 처리 규칙 확인
* 작업 시 OpenClaw를 적극 활용해줘. 파일 수정이나 명령 실행 전에는 필요한 범위를 먼저 좁혀줘.
* 내 SOUL.md를 작성해줘. 나는 물리 교사이고, 과학적 정확성을 우선하며, 코드는 파이썬/Arduino 위주, 답변은 간결하되 개념 설명이 필요하면 단계별로.


=== 선택 ===
* 대시보드를 tailscale을 통해 이용하려는데, 외부에서 접속 가능하게 정리해줘. 재부팅되어도 다시 켜지게 systemd 등록해줘.


=== 사용 중 팁. ===
출력이 의도와 어긋나면 agent.md 업데이트 해줘, 앞으로는 이렇게 답해줘. 등 명령하면 스스로 손본다.
[[분류:Hermes]]
[[분류:Hermes]]

2026년 7월 1일 (수) 07:18 기준 최신판

개요

[편집 | 원본 편집]

설치

[편집 | 원본 편집]
과정 설명 비고
준비 필요한 것은 설치 과정 중에 자동으로 설치된다. sudo apt update
설치 공식 홈페이지에서 손쉽게 안내한다.

터미널에서 설치하는 게 간편하지. 웬만한 것들은 자동으로 해주니까.

  • 필요한 것들이 자동 설치되는데, 꽤 걸린다.
  • 설치할 때 이것저것 묻는데, openclaw가 있으면 통합할거냐고도 물어본다.
  • 설치할 때 로그인이 필요하다. 링크를 주는데, 거기 로그인해서 구독제를 선택한다.(free 있음) 카드와 연결하면 됨. 이걸 해야 다음단계로 진행된다.
  • 툴 선택에선 그냥 맘 편하게 다 체크하면..
  • 게이트웨이는.. LLM 중계자.. 및 채널과 연동하는 녀석인데... 잘 모르면 설치하는 게 편할 듯.
 https://hermes-agent.nousresearch.com/
확인 버전 출력되면 성공.

이후 자동으로 설정 진행.

hermes --version

hermes doctor

설정

[편집 | 원본 편집]
과정 설명 비고
설정 시작 LLM 모델 등 연결을 하게 되는데... 이건 좀 공부가 필요할 듯;

쉬우면..서도 어렵다. 매번 할때마다 헷갈리고;;

hermes setup
채널 연동 메신저 채널 연동 참고. 디스코드의 경우, ~/.hermes/.env에서DISCORD_REQUIRE_MENTION=False 입력으로 멘션 없이 채팅 가능하다.
게이트웨이 실행 nohup hermes gateway > hermes.log 2>&1 & 으로 백그라운드에서 돌려도 되지만, 재부팅하면 꺼짐.

하여, systemd로 만드는 게 일반적이다.

  • which hermes 해서 나온 경로를 비고의 ExecStart 로 넣는 넛이 목표다.(보통 /home/사용자명/.local/bin/hermes)(마지막에 띄어쓰고 gateway는 살려둔다.)
  • sudo nano /etc/systemd/system/hermes-gateway.service
  • 코드를 기입한다.
  • sudo systemctl daemon-reload
  • sudo systemctl enable hermes-gateway
  • sudo systemctl start hermes-gateway
  • systemctl status hermes-gateway 로 확인.
  • 로그는 journalctl -u hermes-gateway -f 로 본다.
 
[Unit]
Description=Hermes Gateway
After=network.target

[Service]
User=id8436
ExecStart=경로 gateway
Restart=always

[Install]
WantedBy=multi-user.target
대시보드 9119 포트로 대시보드를 띄운다.

설정은 hermes에게 맡기면 된다. 아이디와 비밀번호 주고 tailscale 등으로 접속할 거라고.

hermes dashboard

sudo systemctl restart hermes-dashboard

사용

[편집 | 원본 편집]
과정 설명 비고
설정 시작 LLM 모델 등 연결을 하게 되는데... 이건 좀 공부가 필요할 듯;

쉬우면..서도 어렵다. 매번 할때마다 헷갈리고;;

hermes setup
설정 변경
  • 환경변수 설정: nano ~/.hermes/.env
  • 설정 파일 수정: hermes config edit
 설정 반영 후엔 재시작.

sudo systemctl restart hermes-gateway

시작 처음 시작하면 모델 켜고 기타 등등 시간이 조금 걸린다.

터미널 창보단 dashboard가 더 편하다.

hermes chat

설치 후 처음 요구할 것

[편집 | 원본 편집]

아래 예시처럼 기본적인 것들을 프롬프트에 입력한다.(claude-sonnet-4.6 이상의 똑똑한 모델이어야 제대로 알아먹고 수정하는 듯하다. 문제는 비용. 아래 명령 실행해보니.. 대략 2$ 정도 소요되었다. Qwen 류도 적절히 작동한다.)

권장

[편집 | 원본 편집]
  • 비용 절감형 라우팅으로 설정해줘. 기본(일반 채팅·요약)은 로컬 LLM(OpenAI 호환 엔드포인트)으로, 복잡한 작업(코딩·추론)은 Claude/GPT 계열 강력 모델로 자동 라우팅해줘. 단, 로컬 LLM 사용할 때 기본적인 컨텍스트 확인해서 적절히 배치해줘.
  • 작업 시 OpenClaw를 적극 활용해줘. 파일 수정이나 명령 실행 전에는 필요한 범위를 먼저 좁혀줘.
  • 내 SOUL.md를 작성해줘. 나는 물리 교사이고, 과학적 정확성을 우선하며, 코드는 파이썬/Arduino 위주, 답변은 간결하되 개념 설명이 필요하면 단계별로.

선택

[편집 | 원본 편집]
  • 대시보드를 tailscale을 통해 이용하려는데, 외부에서 접속 가능하게 정리해줘. 재부팅되어도 다시 켜지게 systemd 등록해줘.

사용 중 팁.

[편집 | 원본 편집]

출력이 의도와 어긋나면 agent.md 업데이트 해줘, 앞으로는 이렇게 답해줘. 등 명령하면 스스로 손본다.

원본 주소 "https://smwiki.info/index.php?title=Hermes&oldid=11347"