Hermes の設定

Hermes Agent はカスタムの OpenAI-compatible Provider 経由で InOneAPI に接続できます。エンドポイント・認証情報・モデルは公式のモデルウィザードで保存することを推奨します。

推奨：公式ウィザードを使う

hermes model を実行し、Custom endpoint を選びます。
名前に InOneAPI、Base URL に https://api.inoneapi.com/v1 を入力します。
InOneAPI の API キーを入力し、API mode は Chat Completions を選択します。
モデル詳細ページの YOUR_MODEL_ID を選びます。自動検出の一覧に表示されない場合は ID を手入力してください。
保存してそのモデルを選択します。既存のセッションでは /model で切り替えられます。Windows では WSL2 の利用を推奨します。

ウィザードは現在のバージョンに合わせて認証情報とプロバイダーを保存するため、モデル詳細ページでは Hermes の設定ファイルを生成しません。手動設定も公式にサポートされていますが、バージョンによって model、旧バージョンの custom_providers リスト、新バージョンの providers 辞書のいずれかを使用します。これらの構造を直接混在させることはできません。CC Switch のプロバイダー断片を config.yaml 全体の置き換えとして扱わないでください。

設定の確認

モデルを選択後に読み取り専用タスクを実行し、コンソールで公共モデル ID・ステータスコード・Token・費用・トレースを確認します。続いてツール呼び出しを伴う簡単なタスクを 1 回テストし、選択したモデルが Hermes の使うツール形式に対応しているかを確認してください。

よくある問題

YAML が解析できない：インデントはスペースを使用し、Tab は混在させないでください。
401：ウィザードを再実行して API キーを確認します。環境変数を手動設定した場合は、古い値が認証情報を上書きしていないか点検します。
404：モデル ID と base_url 内の /v1 を確認します。
ツール呼び出しが失敗する：プロトコルが利用できても、モデルにツール機能があるとは限りません。モデルを切り替えるか、関連する機能を無効化してください。

Hermes 専用のキーを作成し、月次予算と利用モデル制限を設定すると、チームの利用量から自動化タスクを個別に識別できます。

任意：CC Switch にインポート

モデル詳細ページで本ツールと API キーを選択し、「CC Switch を開いてインポート」をクリックします。CC Switch 公式版を使用してください。インポートリンクには現在のモデル ID が含まれるため、再入力する必要はありません。インポートを確認した後、本ツールのプロバイダー有効化と既定モデルの設定で接続を完了します。app 非対応と表示された場合は、CC Switch を更新するか本文の手動設定に従ってください。

インポートリンクはプロバイダーを追加するだけで、既定モデルの設定や正常なリクエストを保証するものではありません。リンクには API キーが含まれるため、共有しないでください。手動設定と CC Switch インポートはどちらか一方だけで構いません。

CC Switch の現在のソースは、Hermes 用に base_url、api_key、api_mode: chat_completions、models を snake_case で生成します。インポート後も hermes model または /model でプロバイダーとモデルを選択する必要があります。

公式リファレンス：Hermes AI Providers。