> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent のセットアップ：インストール、API Key、Base URL、カスタムモデル

> Hermes Agent をインストールし、BetterToken の Base URL と API Key を設定して、対応プロバイダーのモデルを選び、よくあるエラーを解決します。

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

## 主要な設定

| 項目       | 値                                                                   |
| -------- | ------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                 |
| Base URL | `https://www.bettertoken.ai/v1`                                     |
| Model    | <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある現在の Model ID |

## 前提条件

* 現在のバージョンのツールがインストールされている
* BetterToken API Key：<a href={"https://bettertoken.ai/register"}>登録して取得</a>
* <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>の Model ID

### 追加要件

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

## インストール

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

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>

  <Tab title="Windows">
    Windows ではまず WSL2 を推奨します。ネイティブ PowerShell のサポートは、現在の Hermes Agent バージョンに依存します。ネイティブ Windows を使う場合は、インストール済みバージョンのインストーラー表示に従ってください。
  </Tab>
</Tabs>

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

| 機能              | 用途                         |
| --------------- | -------------------------- |
| Terminal UI     | ターミナルでエージェントと直接チャット        |
| Skills          | 繰り返すタスクのための再利用可能なワークフローを保存 |
| MCP             | ローカルまたはリモートのツール機能を接続       |
| Scheduled tasks | 時刻指定のジョブと定期ワークフローを実行       |
| Subagents       | 複雑な作業を焦点を絞ったエージェントに分割      |
| Message gateway | より多くのメッセージ入口にエージェントを接続     |

## 手動設定

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

| 項目       | 値                                                                   |
| -------- | ------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                 |
| Base URL | `https://www.bettertoken.ai/v1`                                     |
| Model    | <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある現在の Model ID |

### 設定手順

<Tabs>
  <Tab title="対話型設定">
    <Steps>
      <Step title="モデルセレクターを実行する">
        ```bash theme={null}
        hermes model
        ```
      </Step>

      <Step title="OpenAI または OpenAI Compatible プロバイダーを選択する">
        プロバイダー一覧から **OpenAI** または **OpenAI Compatible** を選択します。
      </Step>

      <Step title="BetterToken の設定を入力する">
        次を入力します。

        * **Base URL**: `https://www.bettertoken.ai/v1`
        * **API Key**：BetterToken API Key
        * **Model**：<a href={"https://bettertoken.ai/pricing"}>モデル広場</a>からコピーした、**対応プロバイダーのモデル ID**
      </Step>

      <Step title="Hermes Agent を再起動する">
        設定を更新した後、現在の Hermes Agent セッションを終了して再開します。
      </Step>

      <Step title="Hermes Agent を起動する">
        ```bash theme={null}
        hermes
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI 設定">
    コピー＆ペーストのコマンドを使いたい場合は、Hermes Agent 設定を直接書き込みます。

    ```bash theme={null}
    hermes config set llm.provider openai
    hermes config set llm.base_url "https://www.bettertoken.ai/v1"
    hermes config set llm.api_key "YOUR_API_KEY"
    hermes config set llm.model "YOUR_MODEL_ID"
    ```

    `YOUR_API_KEY` を BetterToken API Key に置き換え、`YOUR_MODEL_ID` を<a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある対応プロバイダーのモデル ID に置き換えます。

    その後、Hermes Agent を起動します。

    ```bash theme={null}
    hermes
    ```
  </Tab>

  <Tab title="環境変数">
    API Key を Hermes Agent 設定に保存したくない場合は、現在のシェルでエクスポートします。

    ```bash theme={null}
    export OPENAI_API_BASE="https://www.bettertoken.ai/v1"
    export OPENAI_API_KEY="YOUR_API_KEY"
    export HERMES_MODEL="YOUR_MODEL_ID"
    hermes
    ```

    これらの変数は現在のシェルセッションにのみ適用されます。新しいターミナルで再度エクスポートするか、自分のシェルプロファイルに追加してください。
  </Tab>
</Tabs>

### OpenClaw から移行する

すでに OpenClaw を使用している場合は、まず現在の Hermes Agent バージョンで移行コマンドが提供されているか確認します。変更前にドライランを実行してください。

```bash theme={null}
hermes claw migrate --dry-run
```

出力を確認したら、移行を実行します。

```bash theme={null}
hermes claw migrate
```

移行後も、Hermes Agent の **Base URL**、API Key、モデル ID を確認してください。これらは `https://www.bettertoken.ai/v1`、BetterToken API Key、対応プロバイダーのモデル ID と一致している必要があります。

## 接続を確認する

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

## モデルを切り替える

モデルセレクターを開くか、設定の `Model` フィールドを変更します。<a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある正確な Model ID を使用してから、現在のセッションを再起動してください。

## よくあるエラー

| エラー                      | 確認事項                                       |
| ------------------------ | ------------------------------------------ |
| `401` または `Unauthorized` | BetterToken API Key を確認し、先頭または末尾の空白を削除します。 |
| `404`                    | Base URL を確認し、特定の Endpoint パスを追加しないでください。  |
| `model not found`        | モデル広場から現在の Model ID をコピーします。               |
| 変更が反映されない                | 設定を保存して、ツールを完全に再起動します。                     |

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

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

<Note>
  実際の API Key をリポジトリにコミットしないでください。チームで共有する設定には、環境変数またはローカル設定を優先してください。
</Note>

### 関連 FAQ

* [MCP と API Key / Base URL の違い](/ja/faq/concepts/mcp-vs-api-key-base-url)
* [model\_provider、base\_url、wire\_api とは何ですか？](/ja/faq/codex/model-provider-base-url-wire-api)
* [Cline で OpenAI 互換 API を設定する方法](/ja/faq/cline/openai-compatible-api)
* [OpenClaw の BetterToken セットアップガイド](/ja/ai-tools/openclaw)

## 詳細設定

## 対応プロバイダー

| プロバイダー | 対応状況 |
| ------ | ---- |
| Claude | 未対応  |
| GPT    | 手動設定 |
| Kimi   | 手動設定 |
| GLM    | 手動設定 |

<Note>ここに示す対応状況は、このページで説明する BetterToken の設定方法に適用されます。</Note>

<Accordion title="設定方法の説明">
  * **手動設定**：API Key、Base URL、Model を入力します。
  * **未対応**：検証済みの直接接続方法はまだありません。
</Accordion>

## 技術詳細

<Accordion title="プロトコル、Endpoint、内部プロバイダーフィールド">
  この設定では `https://www.bettertoken.ai/v1` を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に要求されない限り、`/chat/completions` や `/responses` を追加しないでください。
</Accordion>