Skip to main content
Hermes Agent를 BetterToken에 연결하려면 API Key를 준비하고 아래 Base URL을 입력한 후 모델 광장에서 현재 Model ID를 선택하세요.

​
주요 설정

​
사전 요구 사항

​
추가 요구 사항

  • 선택한 Model ID가 지원되는 provider에서 옴
  • macOS, Linux, Windows 10/11 또는 WSL2
  • 도구 사용을 위한 최소 64K context window의 모델

​
설치

​
Hermes Agent 설치

Hermes는 macOS와 Windows에서 Desktop installer 사용을 권장합니다. Hermes Desktop을 다운로드하고 운영체제에 맞는 installer를 실행하세요.
WSL2도 지원되지만 필수는 아닙니다. Linux 환경이나 Web Dashboard의 embedded terminal이 필요할 때 사용하세요.

​
기능 빠른 참고

​
수동 설정

Interactive Hermes Agent model setup을 기본 경로로 사용하세요. Manual setup이 필요한 경우에만 config files를 직접 수정하세요.

​
설정

1

model selector 실행

Hermes chat이 열려 있다면 먼저 session을 종료하세요. 그런 다음 실행하세요.
2

Custom endpoint 선택

provider list에서 **Custom endpoint (self-hosted / VLLM / etc.)**를 선택하세요.
3

BetterToken config 입력

다음을 입력하세요.
  • Base URL: https://bettertoken.ai/v1
  • API Key: BetterToken API Key
  • Model: 모델 광장에서 복사한 지원되는 provider의 model ID
Hermes가 API mode를 묻는다면 Chat Completions를 선택하세요. Agent tool use에는 context가 64K 이상인 model을 선택하세요.
4

Hermes Agent 시작

Classic terminal interface를 사용하려면 hermes를 실행하세요.

​
OpenClaw에서 migration

이미 OpenClaw를 사용한다면 먼저 현재 Hermes Agent version이 migration command를 제공하는지 확인하세요. 무엇이든 변경하기 전에 dry run을 실행하세요.
output을 확인한 후 migration을 실행하세요.
migration 후에도 Hermes Agent Base URL, API Key 및 model ID를 검토하세요. 이는 https://bettertoken.ai/v1, BetterToken API Key 및 지원되는 provider의 model ID와 일치해야 합니다.

​
연결 확인

Hermes Agent를 시작하고 다음 테스트 prompt를 보내세요. Reply with HERMES_OK only. Do not use tools. response가 정확히 HERMES_OK라면 연결이 작동합니다.

​
모델 전환

Session 밖에서는 hermes model을 실행하세요. Active chat에서 이미 configured된 provider 또는 model을 바꾸려면 /model을 사용하세요. 모델 광장의 정확한 Model ID를 선택하세요.

​
일반적인 오류

​
문제 해결

  • requests가 실패하거나 response를 반환하지 않으면 Base URL이 정확히 https://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

​
Advanced setup

​
지원 Provider

표시된 상태는 이 페이지에서 설명하는 BetterToken 설정 방식에 적용됩니다.
  • 수동 설정: API Key, Base URL, Model을 입력하세요.
  • 지원되지 않음: 검증된 직접 연결 방식이 아직 없습니다.

​
기술 세부 정보

이 설정은 https://bettertoken.ai/v1을 사용합니다. 도구가 OpenAI-compatible endpoint path를 추가합니다. 특정 field에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.