Skip to main content
Hermes Agent を BetterToken に接続するには、API Key を用意し、以下の Base URL を入力して、モデル広場から現在の Model ID を選択します。

​
主要な設定

​
前提条件

​
追加要件

  • 選択した Model ID が対応プロバイダーのものである
  • macOS、Linux、Windows 10/11、または WSL2
  • ツールを使うモデルには 64K 以上のコンテキストウィンドウが必要

​
インストール

​
Hermes Agent をインストールする

Hermes は macOS と Windows では Desktop インストーラーを推奨しています。Hermes Desktop をダウンロードし、OS に対応するインストーラーを実行します。
WSL2 もサポートされますが必須ではありません。Linux 環境または Web Dashboard の埋め込みターミナルが必要な場合に選択してください。

​
機能のクイックリファレンス

​
手動設定

Hermes Agent の対話型モデル設定を主な方法として使用します。手動設定が必要な場合のみ、設定ファイルを直接編集します。

​
設定手順

1

モデルセレクターを実行する

実行中の Hermes チャットを終了してから次を実行します。
2

Custom endpoint を選択する

プロバイダー一覧から Custom endpoint (self-hosted / VLLM / etc.) を選択します。
3

BetterToken の設定を入力する

次を入力します。
  • Base URL: https://bettertoken.ai/v1
  • API Key：BetterToken API Key
  • Model：モデル広場からコピーした、対応プロバイダーのモデル ID
API mode を聞かれた場合は OpenAI-compatible Chat Completions を選択します。context length はモデルの公開値を使い、64K 以上であることを確認します。
4

Hermes Agent を起動する

クラシックなターミナル UI を使う場合は hermes を実行します。

​
OpenClaw から移行する

すでに OpenClaw を使用している場合は、まず現在の Hermes Agent バージョンで移行コマンドが提供されているか確認します。変更前にドライランを実行してください。
出力を確認したら、移行を実行します。
移行後も、Hermes Agent の Base URL、API Key、モデル ID を確認してください。これらは https://bettertoken.ai/v1、BetterToken API Key、対応プロバイダーのモデル ID と一致している必要があります。

​
接続を確認する

hermes --tui または hermes を起動し、Reply with HERMES_OK only. Do not use tools. と送信します。認証、endpoint、Model ID のエラーなしで HERMES_OK が返れば接続は成功です。

​
モデルを切り替える

プロバイダーの追加や再設定には、チャット外で hermes model を実行します。チャット内では /model を使い、設定済みのプロバイダーとモデルを切り替えます。

​
よくあるエラー

​
トラブルシューティング

  • リクエストが失敗する、またはレスポンスが返らない場合は、Base URL が正確に https://bettertoken.ai/v1 であることを確認します。このフィールドに /chat/completions を追加しないでください。
  • Hermes がモデルが存在しないと報告する場合は、Model がモデル広場にある対応プロバイダーのモデル ID であることを確認します。
  • 認証に失敗する場合は、コピーした空白を確認し、選択した Model ID が対応プロバイダーのものであることを確認します。
  • 変更後も Hermes が古いモデルを使用する場合は、現在の Hermes Agent セッションを終了して hermes を再度実行します。
  • BetterToken では通常、追加の User-Agent やカスタムヘッダーは必要ありません。カスタムゲートウェイ、テナントルーティング、可観測性、キャッシュレイヤーで明示的に要求される場合にのみヘッダーを追加してください。
実際の API Key をリポジトリにコミットしないでください。チームで共有する設定には、環境変数またはローカル設定を優先してください。

​
関連 FAQ

​
詳細設定

​
対応プロバイダー

ここに示す対応状況は、このページで説明する BetterToken の設定方法に適用されます。
  • 手動設定：API Key、Base URL、Model を入力します。
  • 未対応：検証済みの直接接続方法はまだありません。

​
技術詳細

この設定では https://bettertoken.ai/v1 を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に要求されない限り、/chat/completions や /responses を追加しないでください。