|
|
| 1번째 줄: |
1번째 줄: |
| == 개요 == | | == 개요 == |
|
| |
|
| === 설치 === | | === 지원 환경 === |
| {| class="wikitable"
| |
| !과정
| |
| !설명
| |
| !비고
| |
| |-
| |
| |준비
| |
| |
| |
| |sudo apt update
| |
| sudo apt install -y curl
| |
| |-
| |
| |설치
| |
| |필요한 것들이 자동 설치되는데, 꽤 걸린다.
| |
| |<nowiki>curl -fsSL https://openclaw.ai/install.sh | bash</nowiki>
| |
| |-
| |
| |확인
| |
| |버전 출력되면 성공.
| |
| 이후 자동으로 설정 진행.
| |
| |openclaw --version
| |
| |}
| |
| | |
| | |
| | |
| == 지원 환경 == | |
| 지원되는 운영체제와 요구사항은 다음과 같습니다. | | 지원되는 운영체제와 요구사항은 다음과 같습니다. |
|
| |
|
| 52번째 줄: |
29번째 줄: |
| |} | | |} |
|
| |
|
| == 준비물 == | | === 설치 === |
| 설치 전에 다음을 준비합니다.
| | {| class="wikitable" |
| | !과정 |
| | !설명 |
| | !비고 |
| | |- |
| | |준비 |
| | |파이썬 기반이라, 파이썬이 필요하다. |
| | |sudo apt update |
| | sudo apt install -y curl |
|
| |
|
| * 웹서버 접근 권한 또는 로컬 서버 환경
| | sudo apt install -y python3 python3-venv python3-pip |
| * 데이터베이스 생성 권한 (운영 환경)
| | |- |
| * Hermes 설치 파일 또는 Git 소스
| | |설치 |
| | |공식 홈페이지에서 손쉽게 안내한다. |
| | 터미널에서 설치하는 게 간편하지. 웬만한 것들은 자동으로 해주니까. |
|
| |
|
| == 설치 절차 ==
| | * 필요한 것들이 자동 설치되는데, 꽤 걸린다. |
| | | * 설치할 때 이것저것 묻는데, openclaw가 있으면 통합할거냐고도 물어본다. |
| === 1. 설치 파일 얻기 ===
| | * 설치할 때 로그인이 필요하다. 링크를 주는데, 거기 로그인해서 구독제를 선택한다.(free 있음) 카드와 연결하면 됨. 이걸 해야 다음단계로 진행된다. |
| Git으로 소스를 가져오거나 공식 배포 파일을 다운로드합니다.
| | * 툴 선택에선 그냥 맘 편하게 다 체크하면.. |
| | | * 게이트웨이는.. LLM 중계자인데... 잘 모르면 설치하는 게 편할 듯. |
| # Git
| | |https://hermes-agent.nousresearch.com/ |
| <source lang="bash">
| | |- |
| git clone https://github.com/example/hermes.git
| | |확인 |
| cd hermes
| | |버전 출력되면 성공. |
| </source>
| | 이후 자동으로 설정 진행. |
| | | |hermes --version |
| # 또는 배포 파일
| | hermes doctor |
| [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" |
| |+ 권장 설정 항목
| | !과정 |
| |-
| | !설명 |
| ! 항목 | | !비고 |
| ! 권장값 | |
| ! 설명 | |
| |-
| |
| | 언어
| |
| | ko
| |
| | 위키 언어
| |
| |-
| |
| | 업로드 허용
| |
| | true
| |
| | 파일 업로드 활성화
| |
| |-
| |
| | 로그 레벨
| |
| | warning
| |
| | 로그 출력 수준
| |
| |- | | |- |
| | 캐시 | | |설정 시작 |
| | enabled | | |LLM 모델 등 연결을 하게 되는데... 이건 좀 공부가 필요할 듯; |
| | 캐시 활성화 | | |hermes setup |
| |} | | |} |
|
| |
| 기본 설정 예시:
| |
|
| |
| <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` 처리 규칙 확인
| |
|
| |
|
| |
| [[분류:Hermes]] | | [[분류:Hermes]] |
개요
지원 환경
지원되는 운영체제와 요구사항은 다음과 같습니다.
요구사항
| 항목
|
요구 조건
|
| 운영체제
|
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
|
| 메모리
|
2GB 이상 (권장 4GB)
|
| 저장 공간
|
1GB 이상
|
설치
| 과정
|
설명
|
비고
|
| 준비
|
파이썬 기반이라, 파이썬이 필요하다.
|
sudo apt update
sudo apt install -y curl
sudo apt install -y python3 python3-venv python3-pip
|
| 설치
|
공식 홈페이지에서 손쉽게 안내한다.
터미널에서 설치하는 게 간편하지. 웬만한 것들은 자동으로 해주니까.
- 필요한 것들이 자동 설치되는데, 꽤 걸린다.
- 설치할 때 이것저것 묻는데, openclaw가 있으면 통합할거냐고도 물어본다.
- 설치할 때 로그인이 필요하다. 링크를 주는데, 거기 로그인해서 구독제를 선택한다.(free 있음) 카드와 연결하면 됨. 이걸 해야 다음단계로 진행된다.
- 툴 선택에선 그냥 맘 편하게 다 체크하면..
- 게이트웨이는.. LLM 중계자인데... 잘 모르면 설치하는 게 편할 듯.
|
https://hermes-agent.nousresearch.com/
|
| 확인
|
버전 출력되면 성공.
이후 자동으로 설정 진행.
|
hermes --version
hermes doctor
|
설정
| 과정
|
설명
|
비고
|
| 설정 시작
|
LLM 모델 등 연결을 하게 되는데... 이건 좀 공부가 필요할 듯;
|
hermes setup
|