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	モデル広場にある現在の Model ID

前提条件

現在のバージョンのツールがインストールされている
BetterToken API Key：登録して取得
モデル広場の Model ID

登録して BetterToken API Key を取得

アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。

追加要件

モデル広場から正確な Model ID をコピーしてください。
macOS、Linux、Windows 10/11、または WSL2
ツールを使うモデルには 64K 以上のコンテキストウィンドウが必要

インストール

Hermes Agent をインストールする

Desktop（macOS / Windows）

Hermes は macOS と Windows では Desktop インストーラーを推奨しています。Hermes Desktop をダウンロードし、OS に対応するインストーラーを実行します。

Linux / macOS / WSL2

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

インストール後、新しいターミナルを開くか shell を再読み込みしてから hermes を実行します。

Windows PowerShell

Hermes Agent は Windows 10 と Windows 11 をネイティブでサポートします。PowerShell または Windows Terminal で次を実行します。

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

管理者権限は不要です。インストール後は新しい PowerShell ウィンドウを開き、更新された User PATH を読み込みます。

hermes --version
hermes doctor

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

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

手動設定

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

項目	値
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	モデル広場にある現在の Model ID

設定手順

対話型設定

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

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

hermes model

Custom endpoint を選択する

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

BetterToken の設定を入力する

次を入力します。

Base URL: https://bettertoken.ai/v1
API Key：BetterToken API Key
Model：モデル広場からコピーした、モデル ID

API mode を聞かれた場合は OpenAI-compatible Chat Completions を選択します。context length はモデルの公開値を使い、64K 以上であることを確認します。

Hermes Agent を起動する

hermes --tui

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

設定ファイル

対話型設定では endpoint が検証されて保存されます。手動で設定する場合は ~/.hermes/config.yaml にモデル設定を追加します。

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

API Key は ~/.hermes/.env に分けて保存します。

OPENAI_API_KEY=YOUR_API_KEY

ネイティブ Windows では、これらのファイルは %LOCALAPPDATA%\hermes\ にあります。値を置き換えた後、hermes doctor を実行します。

OpenClaw から移行する

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

hermes claw migrate --dry-run

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

hermes claw migrate

移行後も、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 を使い、設定済みのプロバイダーとモデルを切り替えます。

よくあるエラー

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

トラブルシューティング

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

追加の認証ヘッダーが必要な Gateway では、Hermes の config.yaml で providers.<provider-name> の下に extra_headers を設定できます。名前付きプロバイダーの設定に従って必要なヘッダー名を指定し、認証情報の値は公開しないでください。