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

​
主要な設定

​
前提条件

​
追加要件

  • 選択した Model ID が対応プロバイダーのものである
  • macOS、Linux、または Windows WSL2

​
インストール

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

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

​
手動設定

対話型の Hermes Agent モデル設定を主な方法として使用します。代替手段として、コマンドと環境変数のオプションも利用できます。

​
設定手順

1

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

2

OpenAI または OpenAI Compatible プロバイダーを選択する

プロバイダー一覧から OpenAI または OpenAI Compatible を選択します。
3

BetterToken の設定を入力する

次を入力します。
  • Base URL: https://www.bettertoken.ai/v1
  • API Key：BetterToken API Key
  • Model：モデル広場からコピーした、対応プロバイダーのモデル ID
4

Hermes Agent を再起動する

設定を更新した後、現在の Hermes Agent セッションを終了して再開します。
5

Hermes Agent を起動する

​
OpenClaw から移行する

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

​
接続を確認する

短いテストプロンプトを送信します。認証または Model ID のエラーなしでツールがレスポンスを返せば、接続は機能しています。設定を変更した後はツールを完全に再起動してください。

​
モデルを切り替える

モデルセレクターを開くか、設定の Model フィールドを変更します。モデル広場にある正確な Model ID を使用してから、現在のセッションを再起動してください。

​
よくあるエラー

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

  • リクエストが失敗する、またはレスポンスが返らない場合は、Base URL が正確に https://www.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://www.bettertoken.ai/v1 を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に要求されない限り、/chat/completions や /responses を追加しないでください。