본문으로 이동

Hermes: 두 판 사이의 차이

학교의 모든 지식. SMwiki
← 이전 편집
편집 취소Sam (토론 | 기여)
봇, 사무관, 인터페이스 관리자, 푸시 구독 관리자, 기록보호자, 관리자, 교사
9,600 편집
시각위키텍스트
잔글 →설치
잔글 →채널
 
(같은 사용자의 중간 판 4개는 보이지 않습니다)
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"
|+ 요구사항
!과정
!설명
!비고
|-
|-
! 항목
|설정 시작
! 요구 조건
|LLM 모델 등 연결을 하게 되는데... 이건 좀 공부가 필요할 듯;
쉬우면..서도 어렵다. 매번 할때마다 헷갈리고;;
|hermes setup
|-
|-
| 운영체제
|채널 연동
| Linux (Ubuntu 20.04+), macOS 12+, Windows 10+
|[[메신저 채널 연동]] 참고.
|-
|
| PHP
| 8.2 이상
|-
|-
| 데이터베이스
|게이트웨이 실행
| MariaDB 10.6+, MySQL 8+, PostgreSQL 13+, SQLite 3
|<code>nohup hermes gateway > hermes.log 2>&1 &</code> 으로 백그라운드에서 돌려도 되지만, 재부팅하면 꺼짐.
|-
하여, systemd로 만드는 게 일반적이다.
| 웹서버
| Apache 2.4+, Nginx + PHP-FPM
|-
| 메모리
| 2GB 이상 (권장 4GB)
|-
| 저장 공간
| 1GB 이상
|}


== 준비물 ==
* 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> 로 본다.
|[Unit]
Description=Hermes Gateway


* 웹서버 접근 권한 또는 로컬 서버 환경
After=network.target
* 데이터베이스 생성 권한 (운영 환경)
* Hermes 설치 파일 또는 Git 소스


== 설치 절차 ==
[Service]


=== 1. 설치 파일 얻기 ===
User=id8436
Git으로 소스를 가져오거나 공식 배포 파일을 다운로드합니다.


# Git
ExecStart=경로 gateway
<source lang="bash">
git clone https://github.com/example/hermes.git
cd hermes
</source>


# 또는 배포 파일
Restart=always
[source|https://example.com/hermes/releases]


=== 2. 의존성 설치 ===
[Install]
PHP 의존 패키지를 설치합니다.


<source lang="bash">
WantedBy=multi-user.target
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
| 업로드 허용
|설정 반영 후엔 재시작.
| true
hermes gateway restart
| 파일 업로드 활성화
|-
| 로그 레벨
| warning
| 로그 출력 수준
|-
|-
| 캐시
|시작
| enabled
|처음 시작하면 모델 켜고 기타 등등 시간이 조금 걸린다.
| 캐시 활성화
|hermes chat
|}
|}


기본 설정 예시:
== 채널 ==
 
채널 연동을 위에서 잘 했다고 가정 하에...
<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` 경로 확인
* `index.php` 처리 규칙 확인
 


=== 슬렉 ===
채널에서 /invite @Hermes 따위로 초대하여...[아직 검증 안됨.]
[[분류:Hermes]]
[[분류:Hermes]]

2026년 6월 22일 (월) 08:20 기준 최신판

개요

[편집 | 원본 편집]

설치

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

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

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

이후 자동으로 설정 진행.

hermes --version

hermes doctor

설정

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

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

hermes setup
채널 연동 메신저 채널 연동 참고.
게이트웨이 실행 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

사용

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

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

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

hermes gateway restart

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

채널

[편집 | 원본 편집]

채널 연동을 위에서 잘 했다고 가정 하에...

슬렉

[편집 | 원본 편집]

채널에서 /invite @Hermes 따위로 초대하여...[아직 검증 안됨.]

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