Coding Agent 설정

Hermes Agent 설치 및 API 설정

Hermes Agent를 설치하고 BetterToken Base URL 및 API Key를 설정한 다음 모델을 선택하고 일반적인 오류를 해결하세요.

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

주요 설정

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
모델	모델 광장의 현재 Model ID

사전 요구 사항

최신 버전의 도구가 설치되어 있음
BetterToken API Key: 등록하고 발급받기
모델 광장의 Model ID

가입하고 BetterToken API Key 받기

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

추가 요구 사항

모델 광장에서 정확한 Model ID를 복사하세요.
macOS, Linux, Windows 10/11 또는 WSL2
도구 사용을 위한 최소 64K context window의 모델

설치

Hermes Agent 설치

Desktop (macOS / Windows)

Hermes는 macOS와 Windows에서 Desktop installer 사용을 권장합니다. Hermes Desktop을 다운로드하고 운영체제에 맞는 installer를 실행하세요.

Linux / macOS / WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows PowerShell

Hermes Agent는 Windows 10과 11을 native로 지원합니다. PowerShell 또는 Windows Terminal에서 실행하세요.

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

관리자 권한은 필요하지 않습니다. 설치 후 새 PowerShell 창을 여세요.

hermes --version
hermes doctor

기능 빠른 참고

기능	용도
Terminal UI	터미널에서 agent와 직접 chat
Skills	반복 tasks를 위한 reusable workflows 저장
MCP	local 또는 remote tool capabilities 연결
Scheduled tasks	timed jobs 및 recurring workflows 실행
Subagents	complex work를 focused agents로 분할
Message gateway	agent를 더 많은 message entry points에 연결

수동 설정

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

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
모델	모델 광장의 현재 Model ID

설정

Interactive setup

model selector 실행

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

hermes model

Custom endpoint 선택

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

BetterToken config 입력

다음을 입력하세요.

Base URL: https://bettertoken.ai/v1
API Key: BetterToken API Key
모델 광장에서 정확한 Model ID를 복사하세요.

Hermes가 API mode를 묻는다면 Chat Completions를 선택하세요. Agent tool use에는 context가 64K 이상인 model을 선택하세요.

Hermes Agent 시작

hermes --tui

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

Config files

~/.hermes/config.yaml에 custom provider를 추가하세요.

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: "https://bettertoken.ai/v1"

BetterToken API Key는 ~/.hermes/.env에 별도로 저장하세요.

OPENAI_API_KEY=YOUR_API_KEY

YOUR_MODEL_ID를 모델 광장의 Model ID로, YOUR_API_KEY를 BetterToken API Key로 바꾸세요. Native Windows에서는 이 files가 %LOCALAPPDATA%\hermes\에 있습니다.

OpenClaw에서 migration

이미 OpenClaw를 사용한다면 먼저 현재 Hermes Agent version이 migration command를 제공하는지 확인하세요. 무엇이든 변경하기 전에 dry run을 실행하세요.

hermes claw migrate --dry-run

output을 확인한 후 migration을 실행하세요.

hermes claw migrate

migration 후에도 Hermes Agent Base URL, API Key 및 model ID를 검토하세요. 이는 https://bettertoken.ai/v1, BetterToken API Key 및 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를 선택하세요.

일반적인 오류

오류	확인할 사항
`401` 또는 `Unauthorized`	BetterToken API Key를 확인하고 앞뒤 spaces를 제거하세요.
`404`	Base URL을 확인하고 specific endpoint path를 추가하지 마세요.
`model not found`	모델 광장에서 현재 Model ID를 복사하세요.
Changes가 적용되지 않음	configuration을 저장하고 도구를 완전히 다시 시작하세요.

문제 해결

requests가 실패하거나 response를 반환하지 않으면 Base URL이 정확히 https://bettertoken.ai/v1인지 확인하세요. 이 field에 /chat/completions를 추가하지 마세요.
Hermes가 model이 존재하지 않는다고 보고하면 Model이 모델 광장의 모델 ID인지 확인하세요.
모델 광장에서 정확한 Model ID를 복사하세요.
변경 후에도 Hermes가 이전 model을 사용하면 현재 Hermes Agent session을 종료하고 hermes를 다시 실행하세요.
BetterToken에는 보통 extra User-Agent 또는 custom headers가 필요하지 않습니다. custom gateway, tenant routing, observability 또는 caching layer가 명시적으로 요구할 때만 headers를 추가하세요.

게이트웨이에 추가 인증 헤더가 필요하다면 Hermes의 config.yaml에서 providers.<provider-name> 아래에 extra_headers를 설정할 수 있습니다. 이름이 지정된 provider 설정에 따라 필요한 헤더 이름을 지정하고 인증 값은 공개하지 마세요.

기술 세부 정보

Protocol, endpoint 및 내부 provider 필드

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