주요 설정
사전 요구 사항
추가 요구 사항
- 선택한 Model ID가 지원되는 provider에서 옴
- macOS, Linux, or Windows WSL2
설치
Hermes Agent 설치
- macOS / Linux / WSL2
- Windows
기능 빠른 참고
수동 설정
interactive Hermes Agent model setup을 기본 경로로 사용하세요. command 및 environment-variable options는 대안으로 계속 사용할 수 있습니다.설정
- Interactive setup
- CLI config
- Environment variables
1
model selector 실행
2
OpenAI 또는 OpenAI Compatible provider 선택
provider list에서 OpenAI 또는 OpenAI Compatible를 선택하세요.
3
BetterToken config 입력
다음을 입력하세요.
- Base URL:
https://www.bettertoken.ai/v1 - API Key: BetterToken API Key
- Model: 모델 광장에서 복사한 지원되는 provider의 model ID
4
Hermes Agent 다시 시작
config를 업데이트한 후 현재 Hermes Agent session을 종료하고 다시 시작하세요.
5
Hermes Agent 시작
OpenClaw에서 migration
이미 OpenClaw를 사용한다면 먼저 현재 Hermes Agent version이 migration command를 제공하는지 확인하세요. 무엇이든 변경하기 전에 dry run을 실행하세요.https://www.bettertoken.ai/v1, BetterToken API Key 및 지원되는 provider의 model ID와 일치해야 합니다.
연결 확인
짧은 테스트 prompt를 보내세요. 도구가 authentication 또는 Model ID 오류 없이 response를 반환하면 연결이 작동합니다. configuration을 변경한 후에는 도구를 완전히 다시 시작하세요.모델 전환
model selector를 열거나 configuration의Model field를 변경하세요. 모델 광장의 정확한 Model ID를 사용한 다음 현재 session을 다시 시작하세요.
일반적인 오류
문제 해결
- requests가 실패하거나 response를 반환하지 않으면 Base URL이 정확히
https://www.bettertoken.ai/v1인지 확인하세요. 이 field에/chat/completions를 추가하지 마세요. - Hermes가 model이 존재하지 않는다고 보고하면 Model이 모델 광장의 지원되는 provider model ID인지 확인하세요.
- authentication이 실패하면 복사된 spaces를 확인하고 선택한 Model ID가 지원되는 provider에서 왔는지 확인하세요.
- 변경 후에도 Hermes가 이전 model을 사용하면 현재 Hermes Agent session을 종료하고
hermes를 다시 실행하세요. - BetterToken에는 보통 extra
User-Agent또는 custom headers가 필요하지 않습니다. custom gateway, tenant routing, observability 또는 caching layer가 명시적으로 요구할 때만 headers를 추가하세요.
실제 API Keys를 repository에 commit하지 마세요. team-shared setup에는 environment variables 또는 local config를 우선 사용하세요.
관련 FAQ
- MCP와 API Key 및 Base URL 비교
- model_provider, base_url 및 wire_api란 무엇인가요?
- Cline에서 OpenAI-compatible API 구성
- OpenClaw BetterToken 설정 가이드
Advanced setup
지원 Provider
표시된 상태는 이 페이지에서 설명하는 BetterToken 설정 방식에 적용됩니다.
설정 방식 설명
설정 방식 설명
- 수동 설정: API Key, Base URL, Model을 입력하세요.
- 지원되지 않음: 검증된 직접 연결 방식이 아직 없습니다.
기술 세부 정보
Protocol, endpoint 및 내부 provider 필드
Protocol, endpoint 및 내부 provider 필드
이 설정은
https://www.bettertoken.ai/v1을 사용합니다. 도구가 OpenAI-compatible endpoint path를 추가합니다. 특정 field에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.