Hermes Agent：実践者向けリファレンス（2026年版）

要点： Hermes Agentは、Nous Researchが開発したオープンソースの自己改善型AIエージェントです。CLIおよびマルチプラットフォーム対応のメッセージングgatewayとして動作し、永続的なアイデンティティとメモリをディスクに保存します。使用を重ねるほど改善されるskillを集約し、Nous Portal、OpenRouter、Anthropic、GitHub Copilot、z.ai、Kimi、MiniMax、DeepSeek、Qwen Cloud、Hugging Face、Google、xAI/SuperGrok、独自のセルフホスト型エンドポイントなど、OpenAI互換のあらゆるLLMプロバイダーに対応しています。¹²¹⁹ 現在のリリースはv0.21.5（タグv2026.9.24、2026年9月24日）で、v0.21系の変更をまとめたパッチです。変更内容は「v0.21.5の新機能」で説明しており、それ以降のリリースセクションは新しいものから順に並んでいます。⁵² 多くの新規ユーザーにとって最も難しいのは、プロバイダー認証です。タグv2026.9.24時点で、Hermesの静的な選択リストには39のプロバイダーが含まれています。さらに、同梱されている38個のプロバイダープラグインとカスタムエンドポイントによって、このリストが自動的に拡張されます。認証経路は3種類あり、.env内のAPIキー、hermes modelによるOAuth、またはconfig.yaml内のカスタムエンドポイントです。⁵³ まず理解すべきなのは認証モデルです。それ以外のすべては、どのプロバイダーが解決されるかによって決まります。

Hermes Agentはチャットラッパーではなく、完全なエージェントランタイムとして動作します。 ファイルシステムの読み取り、サンドボックス化されたバックエンドでのコマンド実行、Webスクレイピング、サブエージェントの起動、スケジュールされたcronジョブの実行に対応しています。また、単一のgatewayプロセスからTelegram/Discord/Slack/WhatsApp/Signal/Emailと通信し、経験をもとに独自のskillを作成します。¹ CLIは、run_agent.pyの会話ループ上に構築されたターミナルUIです。gatewayは、メッセージングプラットフォームからのメッセージを同じ会話ループへ振り分ける常駐プロセスです。³

Hermesを使いこなせるかどうかは、次の5つのシステムを理解しているかで決まります。 これらを習得すれば、Hermesは大きな力を発揮します。

1. プロバイダーの解決：認証フローがAPI呼び出しにどのように対応するか
2. 設定の階層：config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. ツールとtoolsetのシステム：エージェントに何ができるか、プラットフォームごとにどう制限されるか
4. Skillsシステム：エージェントが作成し、進化させる手続き的メモリ
5. Gateway、cron、profile：その場限りではなく、普段使っている環境でHermesを動かす仕組み

重要なポイント

• プロバイダー認証には、1つではなく3つの経路があります。 .env内のAPIキー、hermes model/hermes authによるOAuth、またはconfig.yaml内のカスタムエンドポイントです。慣れ親しんだ方法ではなく、プロバイダーに合った経路を選びましょう。
• プロバイダーの切り替えは、1つのコマンドで完了します。 hermes modelでは、OAuthログインを含む対応済みの全プロバイダーを対話形式で設定できます。また、/model provider:modelを使えば、履歴を失わずにセッション途中で切り替えられます。²
• ユーザーが編集する設定ファイルは2つです。 ~/.hermes/config.yamlには設定、~/.hermes/.envにはシークレットを保存します。auth.json、SOUL.md、MEMORY.md、skills/はHermesが直接管理します。SOUL.mdは手作業でも編集できますが、それ以外はエージェント自身が操作します。⁴
• HermesはOpenClawの後継です。 移行する場合は、hermes claw migrateによって30以上のカテゴリの状態を自動的にインポートできます。⁵
• 補助タスクには、デフォルトでメインモデルが使われます。 ビジョン、承認の分類、圧縮、セッションタイトルは、それぞれ独立した「補助」LLM呼び出しとして実行されます。このタグでは、autoによってすべてがメインのチャットモデルに振り分けられます。設定は不要ですが、高価な推論モデルでは、こうした副次的なタスクにも無視できないコストがかかります。必要に応じて、個々のauxiliary.<task>スロットに安価で高速なモデルを指定しましょう。⁴³⁴

以下の各セクションは、hermes-agent.nousresearch.com/docsの公式ドキュメントと、github.com/NousResearch/hermes-agentのソースツリーに基づいています。すべての事実には、出典となる具体的な公式ページを示す脚注が付いています。

目的別ガイド

Hermes の仕組み：メンタルモデル

Hermes は、どのエントリーポイントからでも呼び出せる単一の会話ループを中心に構成されています。エントリーポイントには、CLI（cli.py）、メッセージング gateway（gateway/run.py）、エディター統合用の ACP アダプター、バッチランナー、API サーバーがあります。³ これらは最終的にすべて、run_agent.py の AIAgent.run_conversation() を呼び出します。このメソッドは次の処理を行います。

1. agent/prompt_builder.py を介して、SOUL.md、MEMORY.md、USER.md、skill、コンテキストファイル、ツールのガイダンスからシステムプロンプトを構築します（2026年9月の分割により、新しい agent/ パッケージへ移動しました）³
2. runtime_provider.py を介してランタイムプロバイダーを決定します。この段階で認証、ベース URL、API モードが選択されます³
3. chat_completions、codex_responses、anthropic_messages の3つの API モードのいずれかを使用してプロバイダーを呼び出します³
4. 返されたツール呼び出しを、model_tools.py と中央ツールレジストリ（tools/registry.py）を介してディスパッチします³
5. モデルが最終応答を生成するまでループし、その後セッションを FTS5 対応の SQLite に永続化します³

このループを理解することが重要なのは、personality、メモリ、skill、圧縮、フォールバックといったすべての機能が、いずれかの段階に結び付いているためです。設定キーを見て「これは何をするものだろう」と思ったら、たいていは「上記ループの第1、第2、第3、第4段階のいずれかを調整するもの」と考えればよいでしょう。

プラットフォームに依存しないコア。 1つの AIAgent クラスが、CLI、gateway、ACP、バッチ、API サーバーを担います。プラットフォームごとの差異はエージェント自体ではなく、エントリーポイント側にあります。³ ターミナルと Telegram で同じスラッシュコマンドを使えるのはこのためです。コマンドは hermes_cli/commands.py の共有 COMMAND_REGISTRY からディスパッチされます。⁶

ディレクトリ構造がそのままシステムです。 Hermes はすべてを ~/.hermes/（デフォルト以外の profile では $HERMES_HOME）以下に保存します。⁴

~/.hermes/
├── config.yaml        # Settings (model, terminal, TTS, compression, etc.)
├── .env               # API keys and secrets
├── auth.json          # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md            # Primary agent identity (slot #1 in system prompt)
├── memories/          # Persistent memory (MEMORY.md, USER.md)
├── skills/            # Bundled + agent-created + hub-installed skills
├── cron/              # Scheduled jobs
├── sessions/          # Gateway session state
└── logs/              # agent.log, gateway.log, errors.log (secrets auto-redacted)

上記の各ファイルには固有の役割があり、重複はありません。「Hermes は X をどこに保存するのか」を知りたい場合、答えはこの中のいずれかです。

v0.21.5 の新機能（9月24日ロールアップ）

Hermes Agent v0.21.5（タグ v2026.9.24、2026年9月24日）は現在のリリースであり、v0.21.x 系列で3つ目となる小規模なロールアップです。「このタグは、v0.21.4 以降にマージされた約460件の PR を、下流の利用者向けに安定版のタグ付きリリースとしてまとめたものです」。厳選されたリリースノートは、今回も v0.22.0 まで延期されています。タグ時点のソースで確認した、運用者向けの変更点は次のとおりです。⁵²⁵³

• Hindsight メモリがコアツリーから分離されました。 同梱されていた Hindsight プロバイダーと hermes-agent[hindsight] pip extra は削除されました。Hindsight は今後、Vectorize が管理するプラグインカタログからインストールしますが、リリースノートにはこの変更が記載されていません。設定で memory.provider: hindsight を指定している場合、hermes update は、その指定を含むすべての profile ホームへカタログのプラグインをインストールします。それでも見つからなければ、エージェントの初回起動時にインストールされます。ただし、security.allow_lazy_installs が false の場合は、hermes plugins install hindsight を実行してください。設定、.env キー、メモリデータは変更されません。外部メモリプロバイダーをご覧ください。
• gateway.multiplex_profiles: false は廃止されました。 gateway はこの設定をその場で true に書き換え、枠付きの通知を一度だけ表示します。独自の gateway を維持する必要がある名前付き profile では、その config.yaml に gateway.standalone: true を設定します。ホストを停止せず、提供中の profile を1つだけオフラインにするには、hermes -p <name> gateway stop を実行すると、その profile を待機状態にできます。メッセージング Gatewayをご覧ください。
• Nous と OpenRouter の選択画面に新しいモデルが追加されました： GPT-6 Sol と GPT-6 Luna（それぞれ -pro バリアントあり）、および Claude Opus 5.5 です。
• プラグインの互換性に変更はありません： plugins.allow_deprecated_imports: true は引き続き機能します。

更新方法：hermes update またはインストーラーのワンライナーを使用します。Docker と Hermes Cloud のイメージは nousresearch/hermes-agent:v2026.9.24 からビルドされます。⁵²

v0.21.4の新機能（第2次ロールアップパッチ）

Hermes Agent v0.21.4（タグ v2026.9.21、2026年9月21日）は、v0.21.x系で意図的に内容を絞った第2次ロールアップです。リリース自身の説明では、「パッチリリース。このタグでは、v0.21.3以降にマージされた約1,800件のPRを、ダウンストリーム利用者（Dockerイメージ、Hermes Cloud、ホスト型デプロイ）向けの安定版タグ付きリリースとしてまとめています」。v0.21.3以降の期間には、「5,169個の変更ファイル」にわたる「5,071件の非マージコミット」、「1,812件のマージ済みPR」、「2,116件のクローズ済みissue」が含まれます。コミット数では、v0.21.1の5,139件に次いでプロジェクト史上2番目に大きなタグ間期間であり、マージ済みPR数では過去最大です。整理された全体像は今回も先送りされており、原文どおり、「この期間の完全に整理されたリリースノートはv0.22.0で公開され、v0.21.0以降のすべてを記録します」および「この期間の内容は何も省略されません」と説明されています。今回のノートには未記載とする項目も列挙されており、以下の各項目はタグ時点のソースで確認済みです。このガイドの既存セクションに影響する項目には、行内に参照先を示しています。⁵⁰⁵¹

• ホストごとにgatewayは1つだけとなり、Desktopは再生成せずに接続します。 OSユーザーごと、ホストごとに実行できるのは1つの hermes serve と1つの hermes gateway run で、それぞれがすべてのprofileを多重化するという方針です。これは、新しいホスト全体のシングルトン層によって強制されます。先に起動したプロセスが稼働中ずっと保持するホストロックと、(pid, createTime) を格納するランデブーレコードを組み合わせることで、2回目の起動時に所有者が同一の稼働中プロセスであることを確認し、別のポートをバインドせず接続できます。古い状態かどうかは推測せず必ず検証されます。Desktopアプリ側も同じ仕組みを利用し、2つ目のバックエンドを生成するのではなく、ホスト上で稼働中のバックエンドへ接続します。仕組みの詳細はメッセージングgatewayで説明しています。⁵¹
• コネクターがバックエンド所有の単一操作となり、セットアップカードも統一されます。 manage_connections ツール呼び出しによって、バックエンド上の純粋なデータとして構成された接続状態マシンが動作します。Desktop、TUI、CLIでは、いずれも同じセットアップカードとして表示されます。不足している認証情報ごとにフィールドが用意され、必須フィールドすべてにテキストが入力されるまで、カードのアクションは実行できません。Nous無料枠のサブセクションをご覧ください。⁵¹
• --format stream-json：機械可読なワンショット実行。 hermes chat -q ... --format stream-json は、CIランナーやオーケストレーター向けに、stdoutの各行へ1つのJSONオブジェクトを出力します。最初に system/init イベント、続いて text 差分／tool_use／tool_result イベント、最後に終了コード、最終テキスト、トークン統計を格納した終端の result エンベロープが出力されます。診断情報とセッションIDはstderrに残り、ツール出力はイベントごとに5,000文字までに制限されます。このフラグは --quiet を暗黙的に有効化し、-q または --query-file が必須で（指定がない場合は終了コード2）、--tui とは併用できません。hermes chat のオプション表にこのフラグを掲載しています。⁵¹
• skills.auto_load によってskillをすべてのセッションへ固定できます。 config.yaml の skills.auto_load に列挙した名前は、CLI、TUI、gateway、cron、APIのいずれでも、新しいセッションごとに完全な形で読み込まれます。解決処理は、プロンプトが最初に構築される際に一度だけ行われます。Skills Systemには「固定されたSkills」のサブセクションが追加されています。⁵¹
• 未承認DM向けの decline オプション。 unauthorized_dm_behavior に、pair と ignore に続く3つ目の値として decline が追加されました。丁寧な拒否メッセージを1度送信した後、その送信者に対して24時間応答しません。ユーザー認証とペアリングをご覧ください。⁵¹
• mcp.discovery_concurrency でMCP検出時の同時接続数を制限できます。 デフォルトは4で、0 は無制限を意味します。設定済みのサーバーには引き続きすべて接続しますが、一斉には接続しなくなります。MCP連携をご覧ください。⁵¹
• session_search に期間指定と再検索機能が追加されます。 検出の入力形式で after／before の範囲を指定できるようになりました（ISO形式、または 7d のような相対期間）。また、複数語のクエリで結果が0件だった場合、FTS5で暗黙的にすべての語をAND検索する代わりに、いずれかの語に一致する条件で再検索します。セッション検索をご覧ください。⁵¹
• hermes sessions set-journal-mode delete|wal：オフラインのジャーナル変換ツール。 SQLiteのジャーナルモードが誤った状態で固定された state.db を自分で修復できる手段です。これまでは PRAGMA journal_mode=DELETE を手動で実行する必要がありました。まずgateway、dashboard、およびすべてのCLIを停止してください。別のプロセスがデータベースを保持している間は処理を拒否し、開いているプロセスが終了するのを待たずにモードを切り替え、その後SQLiteヘッダーのバイト列を検証します。Windowsには保持プロセスのスキャン機能がないため、すべてのHermesプロセスを自分で停止して --force を指定するまで処理を拒否します。hermes doctor からもこのコマンドが案内されるようになりました。トップレベルコマンドの hermes sessions 行に記載しています。⁵¹
• Desktop：フォント設定、ワンクリックのエンジン更新、プラグインのアンインストール。 設定にフォントファミリーのフィールドが追加され、profileごとに desktop.font_family として保存されます。チャットとUI全体でテーマのサンセリフ書体を上書きでき、候補リストの先頭にはアクセシビリティに配慮した書体（OpenDyslexic、Atkinson Hyperlegible、Lexend）が並びます。空欄の場合はテーマ側の指定が使われます。管理対象のローカルモデルランタイムでは、更新がある場合に「Update engine」ボタンが表示されます。更新に失敗した場合もボタンは表示されたままとなり、直接再試行できます。また、Pluginsハブでは確認ダイアログを経てプラグインをアンインストールできます。⁵¹
• 動画カタログ：LTX 2.5とKling O3。 FAL動画プラグインに ltx-2.5（Lightricksのオープンソース音声・動画モデル：ネイティブ音声、最大20秒／4Kの画像から動画への変換、カメラモーションのプリセット、低価格帯。ただしfalでは1440p／2160pで10秒を超えるクリップは拒否されます）と kling-o3（Kuaishouの最先端モデルファミリー、プレミアム価格帯：ネイティブな複数ショットのストーリーテリング、オプション音声、3～15秒）が追加されました。⁵¹
• プラグインカタログが同梱ディレクトリとなり、Webサイトでも公開されます。 リポジトリの plugin-catalog/ ディレクトリは、v2026.9.14 時点の9件から、このタグでは228件まで増えました。プラグインごとにレビュー済みのYAMLが1つあり、正確なコミットSHAに固定されています。ドキュメントサイトでは、プラグインごと、作者ごとのページも生成され、それぞれに固定コミットのREADMEが表示されます。リリースで紹介された10件のコミュニティプラグインは、タグ時点ですべてカタログに収録されています。詳細はプラグインシステムで説明しています。⁵¹
• さらに大規模な修正が、profile／多重化の分離、cron、カンバン、Desktop、state.db にわたって行われました。リリースではカテゴリ名のみが示されており、これらの修正を整理した記録はv0.22.0で公開される予定です。⁵⁰

この期間にも、プラグイン互換機能のrevertはまだ反映されていません。 COMPAT_MANIFEST.md、compat_manifest.json、互換shimはいずれも v2026.9.21 に残っています。この期間における hermes_cli/plugin_compat.py の変更は、プロセス全体で共有するスキャンキャッシュ（多重化gatewayは提供対象のprofileごとにプラグインを検出しますが、全プラグインのソースを毎回再解析すると起動経路でprofileあたり約0.4秒かかっていました）と、WindowsでのPOSIX形式の一致パス（#112576）のみです。日付ゲートとリテラルの真偽値による回避手段は変更されていないため、plugins.allow_deprecated_imports: true を指定すれば、影響を受けるプラグインを引き続き読み込めます。プラグインシステムの互換性に関する囲みで、現在の状態を説明しています。⁴²

更新方法は変わりません。gitインストールでは hermes update、新規インストールではシェルインストーラーを使用します。DockerとHermes Cloudのイメージはこのタグからビルドされます（nousresearch/hermes-agent:v2026.9.21）。⁵⁰

v0.21.3の新機能（9月14日パッチ）

Hermes Agent v0.21.3（タグ v2026.9.14、2026年9月14日）は、main のさらに3日分を2項目のノートにまとめたものです。Cloudエージェントは最新のリリースタグへ自動更新され、それらへ接続するにはリモートgatewayのサインイン修正が必要だったため、このタイミングでリリースされました。（1）リモートdashboardのセッションが、更新要求の集中によって失効しなくなりました。gateway上の2つの更新経路（CookieゲートとDesktopのネイティブBearer経路）は、同じローテーション式refresh tokenを持つ同時リクエストを単一の処理へまとめるようになりました。これにより、Desktopの復帰時に要求が集中しても、すでにローテーション済みのトークンがPortalの再利用検出へ再送され、セッション全体が失効することはありません。また、更新処理はイベントループの外で実行されるため、IDプロバイダーが遅くても /api/status が停止しなくなりました。（2）長時間稼働するプロセスで、state.db の書き込みハンドルが重複して作成されなくなりました。gateway、dashboard／Desktopバックエンド、ACP、CLIの読み取り処理は読み取り専用で接続し、同一プロセス内の書き込み処理はレジストリのハンドルを共有します。この期間の統計は、「2,642個の変更ファイル」にわたる「1,036件の非マージコミット」と「338件のマージ済みPR」です。それ以外は意図的に先送りされています。リリースでは、今回記載しない項目（すべてのモデル選択画面における推論エフォート選択、OpenRouter OAuth PKCE、HEIF／HEIC／AVIFのデコード、FALカタログの大量追加、Slackで貼り付けられた表とAgent Sessions API、VM間ファイルシステム上での state.db のWAL拒否など）を明示したうえで、整理された記録について原文どおり、「この期間の完全に整理されたリリースノートはv0.22.0で公開され、v0.21.0以降のすべてを記録します」および「この期間の内容は何も省略されません」と約束しています。⁴⁹

そして、プラグイン互換機能の期限は予定どおり到来しました。 v0.21.1で予告された2026年9月14日の削除は、コードのrevertではなく、同梱コードの日付ゲートとして発効しました。タグ v2026.9.14 の hermes_cli/plugin_compat.py には COMPAT_REMOVAL_DATE = 2026-09-14 があり、removal_in_effect() はその日以降（またはマニフェストファイルがなくなった時点）にtrueを返します。そのため、影響を受ける外部プラグインは読み込み時に無効化され、赤い通知が表示されます。まだ実施されていないのは、古いインポートパスを実際に削除するrevertです。COMPAT_MANIFEST.md、compat_manifest.json、互換shimはいずれもタグ時点で残っており、v2026.9.21 および9月22日時点の main にも存在します。そのため、plugins.allow_deprecated_imports: true は現在も回避手段として機能します。ローダーによる処理が許可されれば、古いパスを引き続き解決できるからです。注意点は2つあります。このキーにはリテラルのYAML真偽値を指定する必要があります（コードが受け付けるのは真偽値の True のみです。"true" や "false" のような引用符付き文字列は、ソースコメントの「Literal boolean only」のとおり未設定として扱われます）。また、revertが反映されるとパス自体が消えるため、この回避手段もその時点で使えなくなります。プラグインシステムの互換性に関する囲みで、現在の状態を説明しています。⁴²⁴⁹

v0.21.2 の新機能（state.db パッチリリース）

Hermes Agent v0.21.2（タグ v2026.9.11、2026年9月11日）は、何よりもまず v0.21.0 で壊れたものを修正するためのリリースです。リリースノートでは率直にこう説明しています。「v0.21.0 ではセッションストアの接続処理を大幅に書き換えましたが、一部の環境では state.db が不安定になりました。複数の書き込み元が互いのロックを解除し、正常なデータベースが破損していると報告され、1件の不正な行によって sessions list 全体が失敗していました。このリリースでは、そうした一連の問題を解消するとともに、v0.21.1 以降の4日間に main へ加わった変更をすべて取り込んでいます」。意図的に簡素だった v0.21.1 のリリースノートとは異なり、今回は主要な変更点も記載されています。この期間には「947件の非マージコミット」、「1,869件の変更ファイル」、「140人のコントリビューター」による「312件のマージ済み PR」があり、v0.21.x 全体の厳選された記録は引き続き v0.22.0 でまとめられる予定です。⁴⁸

• state.db の信頼性向上キャンペーン：6件の PR で44件の問題を解決。 リリースでは運用者向けの助言が最初に示されており、ここでも同じ対応を推奨します。0.21.0 または 0.21.1 で state.db が壊れた場合は、hermes doctor を実行してください。構造的な破損と全文検索インデックスの破損を区別して報告するようになり、すべてを「FTS 書き込み破損」とは扱いません。再構築だけでは不十分な場合には、hermes sessions recover --inspect-only（オフライン、非破壊、profile 固定。出力データベースを作成せず、正規テーブルを読み取れるか報告します）も案内されます。根本原因への対処として、ストアに対する2つ目以降の書き込み元はすべて排除されました。profile gateway はホストされたルームの状態を5秒ごとにルートの state.db へ書き込んでいましたが、この連携処理は専用の shared-state.db に移されました。そのため、profile gateway がマスターのセッションストアを書き込み可能な状態で開くことはありません。dashboard は最初に読み取り専用で開きます。cron のライフサイクルガードは、使用中のデータベースに対する生の open() ではなく、追跡対象の接続レジストリを経由するようになりました（使用中のデータベースを直接開くと gateway の POSIX ロックが解除されるため、SQLite を破損させる典型的な原因となります）。また、doctor --fix は安全性を証明できない checkpoint を拒否します。書き込み元以外にも改善があります。FTS インデックスが破損した場合、ターン全体を失敗させるのではなく検索機能を縮退させ、後からインデックスを再構築します。1件の破損行によって sessions list、エクスポート、insights の全体が失敗することもなくなり、不正な行は該当セッションを示す警告とともに ? として表示されます。セッションが別の profile のデータベースにバインドされたり、そこから読み取ったりすることもありません。さらに、読み取り専用で開く際に書き込みロックを取得しなくなったため、稼働中の gateway の背後で単発の hermes を実行した場合、従来は4〜20秒待機した末に失敗していましたが、現在は0.01秒で完了します。⁴⁸
• 複数 profile の分離を強化。 v0.19.0 以降、このガイドでは、profile ルーティングによって各 profile の「設定、skills、メモリ、シークレットが完全に分離される」というプロジェクトの主張を繰り返し紹介してきました。しかし v0.21.2 より前には抜け穴があり、今回それらが解消されました。セカンダリ profile の bot がデフォルト profile の許可リストを継承する、アダプターがデフォルト profile のホストへ認証情報を送信できる、stdio MCP サーバーがデフォルト profile の保管庫にあるシークレットを受け取る、MEDIA: 配信で別の profile の .env、auth.json、state.db を添付できる、webhook と Feishu のコールバックがルーティング先の profile から外れる、セカンダリ profile がプロセス単位のメモから別 profile の Nous bearer を取得する、といった問題です（#107609〜#107630）。1つの多重化された gateway で複数の profile を運用している場合、このリリースでようやく分離に関する主張が実態に即したものとなりました。⁴⁸
• パスワードを認識しない認証情報保管庫。 エージェントはシークレットを一切見ることなく、1Password、Bitwarden、またはローカルの Hermes 保管庫を使って、ブラウザーでのサインイン、支払い、住所入力を行えるようになりました。2要素認証コードは、保存済みの認証キー（TOTP：base32 シードまたは otpauth://totp URI。カウンターベースの HOTP は拒否されます）から取得するか、UI を通じて入力を求めます。どのバックエンドも、ログインメタデータと、不透明な名前空間付きハンドル（ローカルでは vault_、そのほかは op:、bw:）という同一形式の情報をエージェントへ渡します。パスワードは入力時にのみ解決されます。外部マネージャーはセッション中にロックを解除するまでロックされたままであり、マスターパスワードは「ツールの引数にも、argv にもならず、永続化もされません」。これは、provider の API キーを平文の .env から除外した v0.19.0 の SecretSource の取り組みを発展させたものです。保管庫によって、エージェントがブラウザーで使用する認証情報も同様に保護されるようになりました。⁴⁸
• 厳選され、SHA で固定されたプラグインカタログ。 hermes plugins browse では「厳選されたプラグインカタログの全エントリ」を一覧表示し、hermes plugins search ではカタログを検索できます。hermes plugins install は、Git URL や owner/repo に加えてカタログ名も解決します。さらに hermes plugins pack により、「宣言的で共有可能なプラグインセット」が加わりました。1つの hermes-pack.yaml で一連のプラグインを正確なコミット SHA に固定し、pack install では通常の固定バージョンのインストールへ展開されます。機能への同意はプラグインごとに維持されます。pack export では現在のインストール内容から pack を出力し、pack show ではドライランを実行できます。プラグインシステムのコマンドブロックに、新しいサブコマンドを掲載しています。⁴⁸
• Nous の無料枠とガイド付き初回起動。 新規インストールでは、1つのコマンドでサインインすると、無料の推論機能とコネクターをすぐに利用できます。チャット内から /login を実行でき、コネクターツール（Gmail、Linear、Notion など）は tool_search で検索できます。デスクトップ版のガイド付き初回起動は HERMES_GUEST_ONBOARDING=1 で有効になり、値が文字どおり 1 の場合にのみ動作します。デスクトップ版のテストでも、'true'、'0'、空の値ではいずれも無効のままであることが確認されています。また、起動時の判定結果は生成されたバックエンドの環境に書き込まれるため、継承された値が紛れ込むことはありません。Nous Tool Gatewayをご覧ください。⁴⁸
• デスクトップバックエンドの大量生成を解消。 以前の Bot Mode では、起動時と roster の更新時に profile ごとにバックエンドを生成または接続し、Bots roster にカーソルを合わせるだけで各行にバックエンドが生成され、profile の切り替え時にはプライマリが重複して生成されることもありました。この期間に、これらはすべて修正されています。⁴⁸

更新方法に変更はありません。既存のインストールでは hermes update、新規インストールではシェルインストーラーを使用します。⁴⁸

v0.21.1 の新機能（ロールアップパッチ）

Hermes Agent v0.21.1（タグ v2026.9.7、2026年9月7日）は、意図的に簡潔なリリースです。「タグ付きデプロイと下流の利用者向けに、v0.21.0 以降の現在の main をまとめた」「パッチリリース」と位置づけられています。本文には、この期間の統計として「変更された4,364ファイルにわたる、マージを除く5,139コミット（+601,014 / -768,419）」と「マージされた632件の PR」が記載されていますが、詳細は先送りされています。「この期間の完全な精選リリースノートは v0.22.0 で公開されます」。これはプロジェクト史上最大の単一タグ間期間です（それ以前に隣接するタグ間で最大だった v2026.7.20..v2026.7.30 のマージを除く2,790コミットを上回ります）が、最も短いリリースノートで公開されました。v0.22.0 で精選された記録がまとめられるまで、該当タグでの Hermes の運用方法を変えるポイントは以下の6つです。いずれもソースで検証しています。⁴¹

• コードベースが分割され、プラグイン互換性の猶予期間は9月14日に終了しました。 2026年9月の分割（PR #102117）により、リポジトリの大規模なモジュールが役割別のファイルへ分けられました。新しい agent/ パッケージには会話ループの内部実装が収められています（トップレベルモジュール214個と7つのサブパッケージ。prompt_builder.py は現在 agent/prompt_builder.py にあり、run_agent.py は引き続き AIAgent の本体です）。CLI のサブコマンドパーサーは hermes_cli/subcommands/ パッケージ（61モジュール）へ移動しました。静的な CANONICAL_PROVIDERS リストは hermes_cli/models.py から hermes_cli/models_catalog_static.py へ移動しています（リスト自体は変更されておらず、静的な39エントリに加え、同梱されている39個のプロバイダープラグインディレクトリから引き続き自動拡張されます）。また、delegate_task は約12個の tools/delegate_tool_* モジュールに分割されました。内部インポートパスは安定した API ではないため、リポジトリルートに新設された COMPAT_MANIFEST.md が、移動した1,148個の「moved-lazy」公開名を以前のモジュールパスから再エクスポートします。名前が解決されると、プロセス内で名前ごとに一度だけ HermesPluginCompatWarning が発生します。この互換レイヤーは一時的なもので、タグ公開から6日後の2026年9月14日に予定どおり無効化されました。コードの巻き戻しではなく、出荷済みコードにあらかじめ組み込まれていた日付ゲートによるものです。その日以降、影響を受けるサードパーティ製プラグインは読み込まれません。CLI のバナー、hermes doctor、hermes update には無効化されたプラグイン名を示す赤い通知が表示され、デスクトップでは一度だけモーダルが表示されます。hermes plugins list では理由を確認できます。外部プラグインを使用している場合は確認してください。hermes plugins compat <path> を実行すると、古いパス -> 新しいパスの対応がすべて file:line 形式で表示され、未対応箇所が1つでも残っていれば終了コード1を返します（機械可読な出力には --json を使用できます。引数なしで実行すると、インストール済みの全プラグインをスキャンします）。作者の対応が間に合っていないプラグイン向けの回避策として、config.yaml に plugins.allow_deprecated_imports: true を設定できます。この方法は現在も有効です。古いインポートパスを実際に削除する変更は9月22日時点でもまだ取り込まれておらず（タグ v2026.9.21 と main で確認済み）、ローダーの処理を許可すれば古いパスは引き続き解決されます。その後の詳細については、上記の v0.21.2 の新機能をご覧ください。プラグインシステムのセクションには、現在の状態を示すボックスがあります。⁴²
• Gateway の会話は、タイマーでは一切ローテーションされなくなりました。 セッションライフサイクルのドキュメントには、現在の仕様が明記されています。「非アクティブ時間や経過時間によって会話がローテーションされることはありません。/new と /reset は明示的な境界を作成し、長い履歴は引き続きコンテキスト圧縮によって管理されます。従来のタイマー設定は無視されます。既存の SessionResetPolicy データ型は互換性のためだけに残された不活性なデータであり、実行時ポリシーではありません」。境界は明示的にユーザーが作成するものです。OpenClaw 時代のセッションリセットタイマーを hermes claw migrate で引き継いでいても、現在は不活性なデータになっています。メッセージング Gatewayをご覧ください。⁴³
• MCP 認証にデバイスコード方式が追加されました。 hermes mcp login <name> に --flow {browser,device} が追加されています。browser は従来の PKCE フロー、device はブラウザのコールバックが現実的でないマシン向けの RFC 8628 デバイスコードログインです。このフラグはサーバーの oauth.flow 設定より優先されます。この期間には、MCP 認証全体も強化されました。OAuth セッションのあらゆる箇所で profile の所有権が検証されるようになり、不正な OAuth メタデータキャッシュはサーバーを停止させるのではなく無視されます。また、デスクトップはクライアントローカルのコールバックを通じて MCP OAuth を中継します。関連する変更として、-t/--toolsets は、設定済みの MCP サーバーのうち実際に起動するものも絞り込むようになりました。そのため、単発の hermes -z -t <toolsets> 実行では、不要なサーバーのコールドスタートが省略されます。MCP 連携のコマンドブロックには、login と reauth [--all] も掲載されるようになりました。どちらもこの期間より前から存在していましたが、ここでは未文書化でした。⁴⁴
• バックグラウンド処理を正確に扱えるよう、Delegation が改善されました。 以下は、該当タグの delegate ツールのソースから確認した delegate_task の6つの信頼性向上です。（1）バックグラウンドバッチは、デフォルトで1つの完了結果として返されます。delegation.independent_completions を有効にすると、呼び出しが複数の完了単位に分割されます。同じ group 値を持つタスクはまとめて報告され、グループ化されていない各タスクは完了時に個別で報告されます。このデフォルト動作は意図的なものです。ソースには、タスクごとに完了通知が殺到すると、「それを想定していないオーケストレーターが分断された」と記されています。（2）子がバックグラウンドプロセスを process_manage(action="handoff") で親へ引き渡さない限り、子の終了処理時にそのプロセスも停止されます。引き渡されずに残ったプロセスは、結果内で orphaned_processes として列挙されます。一度も読み取られないまま終了した子プロセスは、出力末尾を伴う unread_completions として通知されます。ソースの docstring が示す設計方針では、子が「watcher running」と主張するのを信じるのではなく、親が「実行環境からその事実を知らされなければならない」とされています。（3）delegation.fallback_providers が正式な設定項目になりました。null の場合、固定されていない子は親のフォールバックチェーンを継承し、[] の場合はフォールバックが無効になります。provider、endpoint、model のいずれかで固定された子には、この設定で明示しない限りフォールバックがありません。（4）子のフォールバックチェーンは標準のノーマライザーで解決されるため、不正なエントリが spawn を壊すことはなく、代わりに除外されます。（5）処理単位の途中でクラッシュしても、完了済みの子が失われなくなりました。複数の子を含む処理単位では、完了した各子がその処理単位自身の行に永続的に記録され、復元後の結果にも部分的な成果として残ります。（6）Subagent が1時間のプロンプトキャッシュ階層を継承することはありません。委任された子は5分間の階層へダウングレードされます。1時間の階層は席を離れる人間向けの価格設定であり、並列実行される大量の子向けではないためです。⁴⁵
• プロバイダーと model。 Nous Portal と OpenRouter のカタログに、OpenAI の GPT-6 Astra と Astra Pro、および -fast/-flex の速度階層バリエーション（「価格は2倍、priority tier」／「価格は0.5倍、flex tier」）が追加されました。ChatGPT/Codex の OAuth 経路では、Astra はアカウント単位で制限されており、実際のアカウントスコープでの検出結果だけが利用可能であると示せます。また、オプトイン方式の -900k 選択肢が追加され、表示上の272Kウィンドウを実環境で検証済みの約900Kまで引き上げられます。このサフィックスが通信時に送信されることはありません。ほかにも、anthropic/claude-fable-5.1、google/gemini-3.7-flash と gemini-3.8-flash、qwen/qwen3.8-max-0902 と qwen3.8-flash、さらに Meta の Muse Spark 1.3 ファミリー（1Mコンテキスト、contributor バリエーションを含む）が追加されました。Meta の画像生成プロバイダープラグイン muse-image も加わっています。Tavily は Web 検索・抽出バックエンドとして追加されました（TAVILY_API_KEY。hermes tools で Tavily を選択した場合は、キーなしでも動作します）。管理された llama.cpp ランタイムにより、ローカル model が第一級の利用経路になりました（公式バイナリ、管理対象の単一 llama-server、デスクトップからのワンクリックセットアップ）。ツリー外の外部プロセス型プロバイダーには、専用の解決分岐が用意されています。運用面では、選択画面のリモートカタログが20分ごとに更新されるようになりました（model_catalog.ttl_minutes、デフォルト20）。従来の ttl_hours キーは、ユーザーが明示的に設定していた場合に限り尊重されます。⁴⁶
• デスクトップ：ページに注釈を付け、セッションを制御できます。 アプリ内ブラウザにコメントモードが追加されました。Annotate をクリックし、表示中のページで任意の要素をクリックするか、ドラッグして範囲を選択して、メモを入力します。保存したコメントは番号付きのピンとして残り、それだけでターンが送信されることはありません。作業を終えたら、「Add N comments」で各ピンの切り抜きスクリーンショットとともにコメント一式をコンポーザーへ渡せます。要素への各コメントには、CSS selector、マークアップ、レイアウトに関係する computed styles が含まれるため、agent は画像から推測するのではなく、ソース内の要素を特定できます（パスワード、非表示の値、キーらしい属性は、マークアップがページ外へ送られる前に秘匿されます）。コメント数が多い場合はページ領域ごとにまとめられるため、20件前後のコメントでも、通常は別々のファイルに関わる少数の作業単位へ整理されます。これにより、並列ワーカーへ安全に振り分けられます。そのほか、構造化されたセッション操作とセッション自動化操作、ドラッグによるセッション作成、ほかのコーディング agent のトランスクリプトを読み込むセッションインポート画面、display.resume_last_session（デフォルトは true。コールドスタート時に最後のチャットまたはページを再度開きます）が追加されました。browser.use_real_profile がオフの状態で Browser ペインを初めて開くと、この設定を有効にする選択肢を含む同意確認が表示されます。Capabilities -> Skills には、ワンクリックでインストールできる組み込みのオプション skill カタログが追加されました。さらに、デスクトップ UI にロシア語ロケールが加わっています（CLI の17個のロケールカタログに変更はありません）。⁴⁷

更新方法に変更はありません。既存のインストール環境では hermes update、新規インストールではシェルインストーラーを使用します。この期間の精選された記録は v0.22.0 でまとめられる予定です。上記の項目が、該当タグで実際に変わる点となります。⁴¹

v0.21.0（The Pantheon Release）の新機能

Hermes Agent v0.21.0（タグ v2026.8.31、2026年8月31日）は、現在の機能リリースです。また、v0.20.xの一連のロールアップで先送りされてきた内容をまとめた公式記録でもあります。「このリリースには、v0.20.1〜v0.20.6のインフラストラクチャパッチタグの内容がすべて統合されています。各期間の詳細は、ここに漏れなく記録されています。」位置付けとしてはHeraldの続編です。「v0.20.0でHermesは神々の使者となり、言葉を発して他のエージェントへ伝えました。v0.21.0では、神々が集結します。」統計情報を原文どおり引用すると、「v0.20.0以降： 約5,800コミット · 約2,475件のPRをマージ · 約5,680ファイルを変更 · 約869,000行を追加 · 約135,000行を削除 · 約2,100件のissueをクローズ · 760人以上のコントリビューター」です。³⁵

このリリースは機能分野ごとに整理されているため、以下の概要も同じ構成にしています。既存のガイドセクションに影響する機能については、該当箇所へのリンクを行内に記載しています。

• Bot Mode：エージェント同士の社会を標準機能として構築。 Bot Modeは、v0.20.3期間に同梱されたhermes-botsプラグインから、デスクトップアプリでデフォルト有効の機能へ昇格しました。各エージェントのprofileには、名前、ランダム化／ロック操作に対応した決定論的な顔のアバター、共有名簿上の居場所が割り当てられます。複数のbotとユーザーが同じルームで会話できるDiscord風のグループチャットを作成し、入力欄から任意のbotを@メンションしたり、ルームに名前や画像を設定したりできます。さらに、送信元を明示したエージェント間メッセージカード、送信者側の配信通知、即時起動を実現するpaint-first hydration、Routinesペイン、アプリのデザインシステムに基づく再構築も含まれます。リリースの表現を借りれば、「以前の『マルチエージェント』は配管のような裏側の仕組みを意味していました。今では、同僚が集まるチャットアプリのように見えます。」³⁵
• hermes peer：エージェント間でbot同士のDMを送信。 CLIからでも会話の途中からでも、任意のHermesエージェントがprofileやgatewayをまたいで、ハンドル名を指定して別のエージェントにメッセージを送れます。たとえば、調査botに結果をコーディングbotへ渡すよう依頼し、その場で返信を確認できます。「返信は各エージェントの正規のBot Chatに届くため、エージェント間の会話は使い捨てではなく、永続的に保存されて確認できます。」hermes peerコマンド（peerの追加／一覧表示／削除、dm）は、トップレベルコマンドの表に掲載しています。³⁵
• 記憶を保持するcronジョブ。 スケジュール済みジョブは、実行のたびに記憶を失わなくなりました。cronエージェントは他のエージェントと同様に永続メモリを読み込み、更新します。continuity=trueを設定すると各実行結果が次回へ引き継がれるため、監視処理では報告済みの内容を除外できます。すべてのジョブに永続的なメモ帳用scratchpadが用意され、monitor modeのジョブでは変更がない場合にLLMを完全にスキップします。ジョブ単位でreasoning effortを固定できるほか、cronの出力をbotの正規のBot Chatへ送り、botに実際に応答させることも可能です。スケジュール済みタスク（Cron）のセクションでは、それぞれのタグ時点での仕組みを説明しています。³⁵³⁷
• リアルタイムのsubagentオーケストレーション。 delegate_taskに制御アクションが追加されました。実行中の子エージェントを一覧表示し、処理中に軌道修正を指示したり、途中で停止して部分的な結果を保持したりできます。子エージェントの出力はJSONスキーマに照らして検証でき、委任ごとのコストも結果に表示されます。デフォルト値はsubagent 1体あたり250イテレーション、同時実行する子エージェント10体へ引き上げられました（v0.19.0でmax_async_childrenに代わって導入された統一上限です）。³⁵³⁸
• MCPのコマンドセンター。 MCPサーバーとカタログが、デスクトップの1つのページに統合されました。「何でも貼り付ける」感覚でドラッグしてインポートできるほか、バックグラウンドのヘルスチェックにより、ツール呼び出しが失敗する前に再認証を促します。フリート全体のコスト／使用量を確認できるオーバーレイ（スキーマのトークン推定値、サーバーごとの30日間の使用量）や、明示的な確認を経てMCPサーバーをインストールするhermes://ディープリンクも追加されています。MCP連携をご覧ください。³⁵
• CLIを強化する大規模アップデート。 Ctrl+Pで曖昧検索対応のコマンドパレットを開けます（/paletteからもアクセス可能です）。/modelの選択画面では入力に応じて候補が絞り込まれ、/statusにはreasoning mode、保留中の承認、context使用量が表示されます。ステータスバーには、キャッシュヒット率、レイテンシ、1秒あたりのトークン数をリアルタイムで表示でき、項目ごとに表示を切り替えられます。このほか、グローバル緊急停止、セッションのピン留め／解除、順番に切り替わる入力欄のプレースホルダー、ターミナルペットも追加されました。名称に関する注意点として、リリースでは承認のdry-runチェッカーをhermes approval-checkとしていますが、このタグ時点で実際に提供されているのはhermes approvals testです。approval-checkというサブコマンドは存在しません。³⁵⁴⁰
• エージェントがデスクトップのブラウザを操作。 アプリ内ブラウザは、エージェントが見ることしかできないウィンドウではなくなりました。Hermesが直接ページを移動し、クリックして内容を読み取れます。また、完全なリンクコンテキストメニューを備えた状態で、ページをシステムブラウザに開くこともできます。³⁵
• 6つの新規プロバイダーとモデルカタログの大幅拡充。 Meta Model API（Muse Spark）、CommandCode、Tencent TokenPlan、Nebius Token Factory、Ramp Router、Actual Computerが追加されました。このうち3つ（Meta AI、CommandCode、Actual Computer）は以前のロールアップ期間中に導入され、すでにプロバイダーマトリクスへ掲載されています。今回、Tencent TokenPlan、Nebius Token Factory、Ramp Routerに加え、ドキュメントで新たに扱われるAlibaba Token Plan SKUもマトリクスへ追加しました。カタログにはGLM-5.3-Flash、qwen3.8-max/flash、Gemini 3.7 Flash、MiniMax M3 free、Nemotron 3.5 Lightning、Muse Spark 1.2も加わっています。併せて、2つの構造的な変更が導入されました。config.yamlのmodel_overridesを使えば、リリースを待たずに任意のモデルのcontext windowや料金を上書きできます。また、プロバイダーをpipでインストールするパッケージとして提供し、entry point経由で検出できるようになりました。さらに、統一された選択ガードのレジストリにより、データを学習に使用するモデルを選ぶ際は、すべての選択画面で警告が表示されます。³⁵³⁶
• 全面的なセキュリティ強化。 保護対象のエージェント指示ファイル（AGENTS.md、skills、メモリストア）への書き込みには、常に承認が必要になりました。これにより、プロンプトインジェクションを受けたエージェントが自身の継続的な指示を密かに書き換えることを防ぎます。徹底的な秘匿化対応によって、ターミナルエラー、.envの読み取り、checkpoint、ACPログにおけるシークレット漏洩の抜け穴も解消されました。承認システムはWindowsの破壊的コマンドにも対応しています。macOSでは、安定したTCC署名ID（hermes desktop --setup-tcc-identity）により、アップデート後も権限付与が維持されます。また、上流での侵害を受け、BlenderのMCPカタログ項目とskillが削除されました。各タグ時点での詳細は、セキュリティ強化をご覧ください。³⁵³⁹
• gatewayの成熟。 Slackにはネイティブのライブカード（実際のストリーミング返信と、オプトイン式の計画／タスクカード）および送信リンクのプレビュー抑制機能が追加されました。Telegramでは、@botnameからすべてのコマンドとskillを検索できるインライン選択機能が導入され、Telegramのコマンドメニュー上限を回避できます。relay経路も成熟し、ネイティブのプラグイン初期化、draft streaming対応のライブカード操作、セッション範囲の分割、音声メモのSTT復旧が実現しました。gateway制御ソケットにより、フリート側の利用者はgatewayへ問い合わせでき、アップデーターはプロセスツリーを強制終了せずにgatewayを穏やかに一時停止できます。さらに、watchdogの作動時にはturn-reaperが停止状態に陥ったワーカーのスタックを取得します。³⁵
• skillsの大幅拡充。 復元された8つの生産性向上skill（document-to-action-items、meeting-action-items、email-inbox-triage、github-issue-to-pr、weekly-review-planning、competitor-news-monitor、product-price-monitor、social-media-content-calendar）、HARから生成するAPIクライアント（「Webサイトを一度監視すれば、以降はブラウザなしで隠しAPIを直接呼び出せます」）、publish-site、session-librarian、blocked-page-recovery、merge-reconciler、plan-interrogationに加え、作成時に助言を提示するSKILL.md linterが追加されました。³⁵

この期間中にrevertされ、リリースには含まれないもの： Model Council mode（/council）とDCP context engineは、いずれも一度導入された後にrevertされました。WS専用gatewayサーバー（#94245）もマージ後にrevert（#96118）されたため、FastAPIは引き続きデスクトップの起動経路上にあります。ただし、シーケンス番号付きイベントリプレイ（#94219）と、WebSocketを介した損失のないデスクトップ再接続はリリースされています。Electronは40.10.2へロールバックされました。v0.20.x期間に関するコミュニティの記事でこれらが紹介されていたとしても、このリリースには含まれていません。³⁵

更新方法に変更はありません。既存のインストール環境ではhermes updateを実行し、新規インストールではシェルインストーラーを使用します。以下のHeraldリリース内にあるロールアップのサブセクションは、各期間で導入された内容をタグ別に記録したものとして引き続き参照できます。³⁵

v0.20.0 の新機能（The Herald Release）

Hermes Agent v0.20.0（タグ v2026.8.3、2026年8月3日）は、v0.21.0 で全体が統合される前の機能リリースでした。その上に v0.20.1（8月13日）と v0.20.2（8月16日）が安定化タグとして続き、さらに v0.20.3（タグ v2026.8.16.2、8月17日公開）、v0.20.4（タグ v2026.8.18、8月18日）、v0.20.5（タグ v2026.8.19、8月21日公開）、v0.20.6（タグ v2026.8.27、8月27日）でも、それぞれ独自の機能追加を含む形で統合リリースが続きました。詳しくは以下のサブセクションをご覧ください。v0.19.0 以降の期間には、650人以上のコントリビューターによる約3,650件のコミット、1,400件のマージ済み PR、1,200件のクローズ済み issue が含まれます。⁵⁵

以前のバージョンの本ガイドで案内していた手順を覆す変更が3つあります。 まずはこちらをお読みください。

• Node 26 が必須になりました。 インストーラーは NODE_VERSION="26" に固定されており、それより古いランタイムは「Node.js … is too old (Hermes requires Node >=26).」というメッセージとともに拒否されます。インストーラー、heal、upgrade のすべてでこの要件が適用されます。なお、ドキュメントサイトのインストールページには現在も Node v22 と記載されていますが、より新しく信頼できる情報源はインストーラースクリプトとリリースノートです。⁵⁵
• pip と Homebrew は、単なる非推奨ではなく提供終了となりました。 原文では「brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels).」と明記されています。pip または brew でインストールした環境を引き続き使用していても、その経路では今後リリースを受け取れません。⁵⁵
• ツール呼び出しのデフォルト反復上限が90回から500回に変更されました。 長時間の自律実行が人為的な上限に達しにくくなり、以下に示す予算逼迫時の各しきい値も、この新しい上限を基準に計算されます。また、read_file のデフォルトも500行から2,000行に増えました。⁵⁵

その他のリリース内容は次のとおりです。

• 対話型音声。 割り込み対応のストリーミング TTS と、デバイス上で動作するウェイクワード機能が追加されました。⁵⁵
• A2A v1.0。 エージェント間プロトコルのプラグインが追加され、issue #514 で長く求められていた機能が実現しました。⁵⁵
• 署名付き送信 Webhook。 これまで hermes webhook は受信専用でしたが、v0.20.0 ではセッション、ターン、ツールのイベントに対応する HMAC 署名付きライフサイクル Webhook の送信機能が追加されました。⁵⁵
• 根拠付き引用。 ファクトチェックモードを備えた新しい skill が追加されました。⁵⁵
• パワーユーザー向け CLI の大規模な機能強化。 !command を使うと、モデルのターンを消費せず即座にシェルコマンドを実行できます。/init はプロジェクトをスキャンし、AGENTS.md を作成または更新します。/diff は、ステージ済み、全体、またはセッション内の変更を、どの画面からでも表示できます。/context はコンテキストウィンドウを占有している内容の内訳を示します。/focus は出力を絞った表示を提供し、非表示になった行も復元できます。Ctrl+S では、書きかけのプロンプトを一時保存できます。hermes import-agent を使えば、Claude Code または Codex CLI のセットアップを1つのコマンドで移行できます。⁵⁵
• シークレット関連機能の拡充。 すべての vault と組み合わせられるコマンドヘルパー型のシークレットソース、対応方法を示す起動エラーを伴うワンコマンドのトークンローテーション、Bitwarden 用のオプトイン式暗号化緊急キャッシュ、profile ホームごとにスコープが限定された vault 注入キー、さらに config.yaml と MCP 設定の間で ${env:VAR} SecretRef が同等に扱われるようになりました。以下で説明する3経路の認証モデルに変更はありません。⁵⁵
• ウォームスタートの高速化。 hermes -w のコールドスタートが、約14秒から1.8秒に短縮されました。⁵⁵
• デスクトップが正式なプラットフォームに。 バージョン付きカードとサンドボックス化されたライブプレビューを備えるアーティファクト、Kanban を最初のデスクトッププラグインとする Plugin SDK、クイック入力用のグローバルホットキー、複数の GUI ウィンドウ、SSH リモートバックエンドモード、RFC 8252 準拠のネイティブサインインが追加されました。⁵⁵

v0.20.3、v0.20.4、v0.20.5、v0.20.6 の統合リリース（8月17日〜27日）

v0.20.0 以降、このプロジェクトでは高頻度でタグ付きの統合リリースが行われましたが、その内容は単なる安定化にとどまりません。4つのリリースはいずれも、同じ文言で精選版のリリースノートを後日に持ち越していました。具体的には、それぞれ「full curated release notes for this window will ship with v0.21.0」と記載されており、現在は v0.21.0 で公開されています。上記の v0.21.0 の新機能 が、この期間全体をまとめた精選版の記録です（リリースでも、対象期間について「are fully documented here」と明記されています）。以下の各ブロックは、当時のタグごとの記録として残しています。精選版ではまとめられた内容について、どのタグで何が導入されたのかを確認できます。^54233035

v0.20.3（v0.20.2 以降、約250件のコミット、約125件の PR）：

• MCP 2.x SDK への移行と、2026-07-28 版ステートレスプロトコルへの対応。 Hermes は現行世代の MCP SDK に移行し、プロトコルのステートレス版に対応しました。⁵⁴
• Bot Mode がバンドル済みプラグインとして登場しました。 コアとなるチームメイトプロトコルを含む hermes-bots として提供されます。⁵⁴
• CommandCode プロバイダープラグインがプロバイダーカタログに加わりました。⁵⁴
• コンピューター操作向けの Cua Driver 0.20 ランタイムコントラクトに加え、サブプロセスの Python ランタイム所有権が強化されました（PYTHONHOME/PYTHONPATH の分離）。⁵⁴
• 信頼性に関しては、cron スケジューラーの自己修復（EMFILE からの復旧、古い claim の整合、停止したジョブの再設定）、セッション引き継ぎ時のデータ損失修正、デスクトップのリモート gateway 接続の自己修復に加え、エコシステム全体に多数の機能が展開されました（プラグインインストール時のセキュリティスキャン、/worktree、/rollback による手動編集の保持、UTF-16 ファイルの読み込み）。⁵⁴

v0.20.4（v0.20.3 以降、約146件のコミット、約74件の PR）：

• デスクトップのガラス調サーフェス：フロスト選択機能と macOS の事前選択に対応した、マットガラスおよび半透明表現が追加されました。⁵⁴
• タブ式の SESSIONS|BOTS サイドバーが追加され、Bot ごとに表示・非表示を切り替えられるようになりました。さらに、長時間実行されるメンバーのターン、Markdown レンダリング、マシン間ルーティングなど、Bot Mode のグループチャットに関する問題も修正されました。⁵⁴
• skill のインストール時に NVIDIA SkillEvaluator Tier 1 のアドバイザリスキャンが実行されるようになりました。skill をインストールすると、ライセンスとセキュリティのチェックが行われます。⁵⁴
• cron のメディア送信が強化され（設定可能なタイムアウト、手動実行時の添付ファイル、実行漏れの可視化）、SessionDB のイベントループスレッドと競合に関する問題が修正されました。また、hermes update が退避ブランチの状態を正確に報告するようになり、kanban に OS ネイティブ通知が追加されました。⁵⁴

v0.20.5（v0.20.4 以降、約746件のコミット、約323件の PR）：

• キー不要の Web 層：新規インストール直後でも API キーなしで Web 検索を利用できます。5ベンダーの無料枠をローテーションし、リング方式でフェイルオーバーします。²³
• CLI の大規模な品質向上：あいまい検索に対応した /model 選択画面、Ctrl+P のコマンドパレット、情報が充実した /status が追加されました。²³
• Bot Mode の本格化：グループルームのスレッド、折りたたみ可能な会話要約、ブロブフェイスのアバター、ドラッグ＆ドロップ対応の PDF／ファイル添付が追加されました。²³
• フリートと worktree のツール：hermes update の処理記録、hermes update --plan（リリースノートでは「fleet --plan verification」と呼ばれていますが、このフラグは fleet コマンドではなく hermes update に属します。パーサーのヘルプによれば「Show the update plan and exit without changing anything」と動作します）、hermes worktree list/prune が追加されました。²³²⁷
• cron ジョブに永続メモリとジョブ単位の推論エフォートが追加されました。 さらに、Composio の評価結果に基づく実行規律とランタイム停止ガード、複数質問による確認、opencode を使わない認証不要プロバイダー、デスクトップのパフォーマンス改善（描画を優先する Bot Mode のハイドレーション、両レンダラーへの React Compiler 導入）も含まれます。²³

v0.20.6（タグ v2026.8.27、8月27日 – v0.20.5 以降、約1,313件のコミット、約525件の PR）：

リリース自体では「Patch release. This tag rolls up the ~525 PRs merged since v0.20.5 into a stable tagged release for downstream consumers」と明記されています。また、説明によると、この期間には約1,557個のファイルにわたる約1,313件のコミット（+177,113／−21,682）、約525件のマージ済み PR が含まれます。³⁰ その説明で取り上げられている主な項目は次のとおりです。

• 同意を前提とした実プロファイルでのブラウジング – ローカルブラウジングでデフォルトの Chromium profile を使用できるようになり、Windows では承認を得てブラウザーを閉じるフローにも対応しました。³⁰
• デスクトップの Browser が独立した OS ウィンドウで動作するようになりました。 さらに、管理対象の SSH リモート更新エンジンとフリート profile レールも追加されました。³⁰
• リモート MCP カタログの拡充：Cloudflare、Grafana Cloud、Better Stack、Railway など、実環境で検証済みのベンダーホスト型サーバーが50以上追加されました。³⁰
• 保存済みシークレットを OS キーチェーンで暗号化するオプトイン機能 – 起動するたびに macOS Keychain のプロンプトが表示されることはなくなりました。³⁰
• 選択画面に新しいモデルを追加：GLM-5.3-Flash、無料の MiniMax M3、動画向けの MiniMax H3 Max が追加されました。³⁰
• web_search／web_extract の結果を TTL 付きでキャッシュする機能と、ステミング対応の複数クエリ tool_searchが追加されました。³⁰
• Lean-tail 圧縮がデフォルトになりました – 以下の コンテキスト圧縮 セクションでは、このタグ時点の設定を説明しています。³⁰³¹
• ターミナルバックエンドがプラグイン対応になりました – ターミナルバックエンドをご覧ください。³⁰³²
• 更新機能とフリート動作の明確化：アップデーターは gateway のプロセスツリーを強制終了せず、制御ソケット経由で一時停止するようになりました。また、イメージまたはパッケージで管理されているインストール環境では、安全でないインプレース更新が拒否されます。³⁰
• cron の永続的なインシデント確認応答と、コードのバージョン不一致をより明確に示すエラー、Slack のリンク展開制御、共有 Docker コンテナ ID が追加されました。³⁰

更新方法に変更はありません。既存のインストール環境では hermes update を使用し、新規インストールではシェルインストーラーを使用します。⁵⁴²³³⁰

v0.19.0 の新機能（The Quicksilver Release）

Hermes Agent v0.19.0（タグ v2026.7.20、2026年7月20日）は、伝令神自身の速さにちなんで名付けられました。このリリースの核となるのは圧倒的な応答速度で、すべてのプラットフォームにおいて、最初のターンでトークンが出力されるまでの時間を約80%短縮しています。さらに、ターミナルでの請求管理、パスワードマネージャーからのシークレット取得、デフォルトで有効になるスマート承認、動作を観察できるサブエージェント、クラッシュしても応答を確実に届ける仕組みが加わりました。v0.18.0以降ではプロジェクト史上最大規模の進展があり、約2,245件のコミット、約1,065件のマージ済みPR、約3,300件のクローズ済みissue、450人以上のコミュニティ貢献者を記録しています。⁵⁶

• あらゆる環境で、最初のトークンまで約80%高速化。 コールド状態での送信からディスパッチまでの時間が、CLI、gateway、TUI、デスクトップ、cronのすべてで約4.3秒から約0.9秒に短縮されました。Discordの機能検出をクリティカルパスから外し、Ollama以外と判明しているプロバイダーではOllamaプローブを省略し、エージェント初期化時のブロッキング処理を排除しています。体感レイテンシも改善されました。推論モデルはデフォルトで思考過程をリアルタイム配信するようになり（display.show_reasoningはON）、応答ボックスも行単位ではなくトークン単位で描画されます。⁵⁶
• デスクトップとTUIのレンダリングを大幅改善。 デスクトップアプリでは約20件のPRによる高速化が実施されました。インクリメンタルなブロック字句解析によってストリーミングMarkdown分割処理のCPU使用量を14分の1に削減し、レビューペインの差分表示を仮想化したほか、大規模なトランスクリプトでもセッションを軽快に切り替えられるようになりました。トークンごとにサイドバーやツール行が再レンダリングされることもありません。TUIでも、ストリーミングされたMarkdownがブロック単位で段階的にレンダリングされるようになりました。⁵⁶
• pipとHomebrewによるインストールは非推奨です。 どちらの方法も「サポート対象外のレガシー」インストールとされ、廃止が予定されていました。その後、v0.20.0で実際に廃止されています。brewおよびpip/PyPI wheelの配布チャネルは終了し、サポート対象はシェルインストーラー、Docker、Nixとなりました。⁵⁶⁵⁵
• パスワードマネージャーからシークレットを取得可能。 新しいプラグイン式のSecretSourceインターフェースにより、読み込み時にBitwardenや1Password（op://参照）からシークレットを取得できます。複数の保管庫を同時に利用でき、優先順位は決定論的に処理されます。競合時の警告や変数ごとの取得元情報にも対応しているため、APIキーを平文の.envに保存する必要がなくなりました。今後の保管庫プロバイダーもプラグインとして追加できます。⁵⁶
• スマート承認がデフォルトに。 Hermesが警戒対象のコマンドを実行しようとすると、コマンドごとに確認を求める代わりに、独立したLLMレビュアーが評価します。各判定が適用されるのは、そのコマンドだけです。ユーザー定義の拒否ルールに一致するコマンドはYOLOモードでもブロックされ、/deny <reason>を使えば拒否理由がエージェントへ伝わり、方針を修正できます。また、ルールキーとともに再導入されたプラグインのpre_tool_call承認アクションにより、ツール呼び出しを人間による承認へエスカレーションできます。⁵⁶
• ターミナルでの請求管理：/subscriptionと/topup。 ターミナルを離れずにNous Portalのプランを管理できます。現在のプランと残りの利用枠を確認し、アップグレードにかかる正確な費用やダウングレードが有効になる時期を事前に確認したうえで、取り消し可能な形で適用できます。デスクトップアプリにも同等の請求設定タブが追加されました。⁵⁶
• サブエージェントの作業を観察し、完了した回答を確実に保持。 delegate_taskによるディスパッチでは、サブエージェントの起動直後からtail -fできるライブトランスクリプトファイルが返されます。すべてのツール呼び出し、結果、ストリーミング応答が、子エージェントごとに人間が読める1つのログへ記録されます。バックグラウンド委任の完了結果は再起動後も保持されます。さらに、gatewayの最終応答はstate.db内の配信義務台帳に記録され、送信中にgatewayが停止しても、次回起動時に再配信されます。max_async_children設定オプションは、統合された委任同時実行数の上限へ移行するため、非推奨となりました。⁵⁶
• 1つのgatewayで複数のprofileを運用。 1つのbotトークンを共有する多重化gatewayで、特定のギルド、チャンネル、スレッドを異なるprofileへルーティングできます。各profileの設定、skills、メモリ、シークレットは完全に分離され、GATEWAY_MULTIPLEX_PROFILESによる上書きにも対応します。ルーティングインデックスはstate.dbへ移行し、sessions.jsonは任意のレガシーミラーとなりました。⁵⁶
• プロバイダーとモデルの大幅拡充。 Fireworks AIが正式対応となり、コスト見積もりに対応したほか、プロバイダー選択画面の第2候補に配置されました。DeepInfraとUpstage Solarも加わっています。モデルカタログにはGPT-5.6（Sol/Terra/LunaおよびPro、全経路で対応）、grok-4.5（GA）、kimi-k3（kimi-k2.xは廃止）、全機能に対応したClaude Sonnet 5が追加されました。プロバイダーごとのenabled: falseフラグとexcluded_providers設定により、使用しないプロバイダーを/modelの選択肢や解決処理から除外できます。⁵⁶
• 推論強度を段階的に調整可能。 新しいmaxとultraの強度レベルがすべてのインターフェースに追加されました。設定内でのモデル別上書き、MoAプリセット内でのスロット別強度（アドバイザーは深く考え、統合モデルは高速性を維持）、補助モデルのタスク別強度、CLIでセッション単位に指定できる/reasoningにも対応しています。⁵⁶
• CLIとMCPの機能拡充。 hermes sessions exportは、Markdown、Quarto、HTML、プロンプトのみ、Hugging Faceトレースの各形式へ出力でき、任意指定の--redactで機密情報を除去できます。/model --onceでは1ターンだけモデルを上書きでき、slash-skillの呼び出しは重ねて指定できます（/skill-a /skill-b do XYZ）。トラブルシューティング用の--safe-mode、設定管理を補完するhermes config get/unsetも追加されました。hermes serveは完全なヘッドレスバックエンドとなり、MCPツールにはmcp__server__tool命名規則が採用されています。⁵⁶

v0.18.xからアップグレードする場合、まず注意すべき変更が2つあります。pipまたはHomebrewによるインストールはサポート対象外のレガシー方式として警告されるため、1行インストーラーへ移行してください。また、max_async_childrenは非推奨となり、統合された委任同時実行数の上限へ置き換えられています。それ以外は追加的な変更です。アップグレードする最大の理由は、最初のターンにおける約80%のレイテンシ短縮、スマート承認、そして完了した回答をクラッシュから守る配信台帳です。

v0.18.0 の新機能（The Judgment Release）

Hermes Agent v0.18.0（タグv2026.7.1、2026年7月1日）は、「判断」にちなんで名付けられました。エージェントが成功を主張するだけでなく、自らの作業を検証し、さらに実際に確認できるアンサンブル推論を実現したリリースです。また、P0/P1のバックログをすべて解消し、約692件の最優先項目を12日間で完了しています。²²

• Mixture-of-Agentsを正式なモデルとして採用。 MoAをすべてのインターフェースでほかのモデルと同じように選択できるようになり、アンサンブル推論の過程も確認できます。各参照モデルの完全な出力が、ラベル付きの独立したブロックとして表示され、回答もリアルタイムでストリーミングされます。不透明に統合された回答を受け取るだけでなく、アンサンブルが考える様子を観察できます。²²
• /goalの完了コントラクト。 エージェントは目標の完了を報告する前にプロジェクトのチェックを実行し、成功したと主張するだけでなく、自らの作業を検証します。自身にも「判断」を適用する仕組みです。²²
• /learn—あらゆる内容を説明してskillに変換。 ワークフローを説明するだけで、再利用可能なskillに変換できます。生成されるskillsは、リポジトリのCONTRIBUTING.md規約に自動で準拠します。²²
• /journeyタイムライン。 メモリとskillsの変遷を時系列で視覚化し、編集も可能です。デスクトップではメモリグラフも利用できます。²²
• バックグラウンドサブエージェントの並列展開。 会話をブロックすることなく、複数のタスクを同時実行するよう委任できます。v0.17.0で導入された単一のバックグラウンドサブエージェントが、複数のサブエージェント群へ進化しました。²²
• デスクトップ版Projects。 プロジェクト、リポジトリ、レーンによる構成モデルを備えた、コーディング向けの正式なProjects機能が追加されました。²²
• ゼロまでスケールするgateway。 gatewayはアイドル時に休止状態へ移行し、シームレスなデプロイに向けてドレイン処理を連携できます。Hermesを常時稼働サービスとして運用する場合に重要な機能です。²²
• Google Vertex AI対応。 GCPサービスアカウント経由でGeminiを利用でき、OAuth2トークンも自動更新されます。これにより、プロバイダーカタログへ新たな選択肢が加わりました。²²
• /promptエディターコマンド。 入力行で苦労することなく複数行のプロンプトを作成できるよう、$EDITORを開きます。²²

v0.17.xからアップグレードする場合、CLIに破壊的変更はありません。アップグレードする最大の理由は、目標を自己検証する完了コントラクト、内容を確認できるアンサンブルを備えた正式なMoA対応、そしてskillを取り込むための/learnです。

v0.17.0（The Reach Release）の新機能

Hermes Agent v0.17.0（タグ v2026.6.19、2026年6月19日）は、エージェントの到達範囲が新しいメッセージングチャネル、モデルプロバイダー、さらに高度なデスクトップおよびダッシュボード操作へと広がったことにちなんで名付けられました。v0.16.xに機能を追加するリリースであり、CLIの操作体系に変更はありません。²¹

• 新しいメッセージングチャネル。 iMessageがMacのリレーなしで、Photon Spectrum（デバイスコードによるOAuth、hermes photon login）を介して動作するようになりました。WhatsApp Business Cloud APIは、ブリッジプロセスを不要にするMeta公式アダプターです。SimpleXでは、グループ、ネイティブ添付ファイル、テキストのバッチ処理、自動承認が利用できます。さらに、プライバシーを契約として保証するウェイクチャネル設計を採用したRaftが、同梱プラットフォームプラグインとして加わりました。²¹
• 新しいモデルとプロバイダー。 カタログにz-ai/glm-5.2（1Mコンテキスト）、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra、grok-composer-2.5-fast（xAI OAuth経由で利用するCursorのモデル、200kコンテキスト）が追加されました。xAIのデフォルトはgrok-build-0.1に変更され、Anthropicのアダプティブモデルは最新のthinking contractに従うようになりました（reasoningフィールドは送信されません）。²¹
• デスクトップとダッシュボード。 デスクトップでは、委任した処理をライブ配信する「watch-windows」付きのバックグラウンドsubagent（delegate_task(background=true)）、Composerのモデルセレクター、再割り当て可能なキーボードショートカット、OSネイティブ通知、スレッドごとのComposer下書き、VS Code Marketplaceテーマ、日本語および繁体字中国語のUIが追加されました。ダッシュボードには、config.yamlを編集せずにモデル、skill、MCPを設定できる完全なprofileビルダー、グローバルprofileスイッチャー、セキュリティスキャンを備えた刷新版Skills Hub、フォーム、スラッシュコマンド、会話、ドキュメントで使用できるパラメーター化テンプレートのAutomation Blueprints、OAuthゲートの内側で401を返す安全なログイン機能が追加されています。²¹
• skillとツール。 image_generateは、対応するすべての画像プロバイダーで、画像を一から生成するだけでなく、元画像の編集や変換もできるようになりました。memoryツールには、1回の呼び出しで追加、置換、削除をアトミックに一括実行するoperations配列が加わりました。新しいsimplify-code skillは、チェスタートンの柵に基づくリスク階層をゲートとして、3つのエージェントによる並列レビューとクリーンアップを実行します。また、3状態のwrite_modeは、真偽値のwrite_approvalに置き換えられました。²¹
• アーキテクチャ。 バックグラウンドsubagentは即座にハンドルを返し、処理結果を新しいターンとして再入力します。ツール呼び出しの途中で確認を求められるMCP elicitation handlerが追加され、後から接続されたMCPツールもターン間で公開されるようになりました（キャッシュセーフ）。cronは、Chronosのマネージドcronプロバイダーに対応するプラグイン可能なCronSchedulerへと変わりました。さらに、新しいManaged scope（/etc/hermes）により、管理者はユーザーが変更できない設定を固定できます。複数gateway構成向けのGateway-Gatewayリレーも追加されました。²¹
• 新しいコマンド。 /version、/billing（対話型ターミナル課金情報）、hermes photon login（iMessage認証）、hermes curator run --consolidateが追加されました。統合処理はオプトインになったため、通常のバックグラウンドキュレーションではトークンを消費しません。²¹
• セキュリティ。 v0.17.0では、シェルエスケープの拒否リストを回避できる問題を修正しました。また、承認モジュールや独自ポリシーのgatewayアダプターが見つからない場合はフェイルクローズし、cronジョブスクリプトのサブプロセスでは環境をサニタイズします。リクエストのデバッグダンプ内にあるシークレットのマスキング、データ持ち出しパターンに対するMCP stdio設定の検査も追加され、CVEを解消するためurllib3とPyJWTが更新されました。²¹

v0.16.xからアップグレードする場合も、CLIを壊す変更はありません。同じエージェントを中心に、新しいチャネル、モデル、操作画面が追加されています。リレー不要のiMessage、WhatsApp公式アダプター、管理者向けのManaged scopeが、アップグレードする主な理由です。

v0.16.0（The Surface Release）の新機能

Hermes Agent v0.16.0（タグ v2026.6.5、2026年6月5日）は、CLIを中心とするエージェントに新しい操作画面をもたらしたことにちなんで名付けられました。最大の特徴は、Hermesがターミナル専用ではなくなったことです。²⁰

• ネイティブデスクトップアプリ。 Hermes DesktopはmacOS、Linux、Windows向けの新しいElectronアプリで、ワンクリックインストールとアプリ内の自動更新に対応しています。ストリーミングチャット画面、ファイルのドラッグ＆ドロップ、クリップボードからの画像貼り付け、Cmd+Kパレット、アーカイブと検索に対応したセッション一覧、ステータスバーのモデル選択機能を利用できます。安全なWebSocketを介してリモートのHermes gatewayへ接続でき、OAuthまたはユーザー名とパスワードで認証します。profileごとにリモートホストを設定でき、profileをまたぐ@session参照で関連付けられた複数profileのセッションを同時に実行できます。デスクトップUIには型付きi18nレイヤー（display.language）による簡体字中国語（简体中文）の完全な翻訳も収録されています。デフォルトは引き続き英語です。²⁰
• ブラウザー管理パネル。 ローカルWebダッシュボードは、ステータス表示から完全な管理パネルへと進化しました。有効化／無効化を切り替えられるMCPカタログ、認証情報の管理、webhookとhookの作成、メモリ設定、gateway操作に加え、更新前の確認とワンクリックのDebug Shareを備えたSystemページを利用できます。新しいChannelsページでは、Telegram、Discord、Slackなど、gatewayのすべてのメッセージングプラットフォームをブラウザーから設定できます。認証もプラグイン可能になり、ユーザー名とパスワードによるログイン、セルフホスト型の汎用OIDCプロバイダー、セルフホスト型OAuthクライアント用のhermes dashboard register、リフレッシュトークンによるセッションローテーションに対応しました。²⁰
• 新しいCLI機能とスラッシュコマンド。 /undo [N]は直近N回分のユーザーターンを巻き戻し、内容を入力欄に復元してソフトデリートします。CLI、TUI、各メッセージングプラットフォームで利用できます。デフォルトのインターフェース（cliまたはtui）を設定できるようになり、--cliで上書きできます。TUIには統合された/modelコマンドとSessionsオーバーレイも追加されました。hermes portalはNous Portalのオンボーディングフローを人間が読みやすい形にしたエイリアスです。初回起動時にはQuick SetupとFull Setupの2つの経路が用意され、hermes prompt-sizeとhermes sessions optimizeという2つの診断機能も追加されました。²⁰
• 新しいモデルとプロバイダー。 モデル選択画面にdeepseek-v4-flash、MiniMax-M3（1Mコンテキスト、MiniMaxネイティブプロバイダー）、qwen3.7-plus（Nous + OpenRouter）、gemini-3.5-flash（Gemini OAuth + APIキー）が追加されました。第一級のxAI Grok OAuthプロバイダーがデスクトップランチャーに加わり、モデル選択はすべての操作画面であいまい検索に対応しました。複数のエンドポイントを持つプロバイダーは1行にまとめて表示され、カタログの更新頻度は1日ごとから1時間ごとに変更されています。²⁰（その後、v0.21.1で更新間隔が再び変更されました。モデル選択画面のリモートカタログは、model_catalog.ttl_minutesに従って20分ごとに更新されます。⁴⁶）
• より軽量なskillと段階的開示。 デフォルトのskillセットから、重複したskillや使われていないskillが削除されました（Spotifyはネイティブプラグインへ移行し、Linearはhermes mcp install linearで利用する形になり、古くなった項目も複数削除されています）。さらに多くのskillがオプション扱いとなり、environments:フロントマターによる関連性ゲート（kanban/docker/s6）も追加されました。これにより、特定のコンテキストでのみ必要なskillは、要求されるまでインデックスに表示されません。NVIDIA/skillsはOpenAI、Anthropic、HuggingFaceと並ぶSkills Hubのデフォルトの信頼済みtapになりました。MCPツールとプラグインツールでは、段階的な（スコープ限定の）ツール開示が利用できます。また、トークンを取得できていないにもかかわらずOAuthの成功を誤って報告していたMCPの不具合も修正されました。²⁰
• セキュリティ。 v0.16.0では、CVE-2026-48710（BadHost）へのパッチを含むStarlette（≥1.0.1）にバージョンを固定しました。非同期処理ではSSRFのURLチェックをイベントループ外に移し、サブプロセスの環境からBedrockの推論用Bearerトークンを除去しています。さらに、ファイル安全性の読み取りガードへbws_cache.jsonを追加し、危険なパターンの一覧にdocker restart/stop/killを加え、検証済みskillの内容に含まれる不可視Unicodeをサニタイズします。このリリースでは、P0の問題を2件、P1の問題を62件解消し、そのうち16件にはセキュリティタグが付いていました。²⁰

v0.15.xからアップグレードする場合も、CLI自体に破壊的変更はありません。同じエージェントを中心に操作画面とプロバイダーを追加するリリースです。ターミナルを使わないユーザーにもHermesを提供したい場合や、リモートgatewayをブラウザーから管理したい場合は、デスクトップアプリと管理パネルがアップグレードの決め手となります。

v0.14.0（The Foundation Release）の新機能

v0.14.0は、1つの目玉機能よりも、セットアップの手間を減らしながらHermesを実行できる環境を広げることに重点を置いています。¹⁹ 主な運用上の変更点は次のとおりです。

• インストールと起動が軽量になりました。 PyPIからpip install hermes-agentでインストールでき、負荷の大きいアダプターは初回使用時に遅延インストールされます。起動処理も必要な作業を後回しにすることで、コールドスタートを約19秒短縮しました。（その後、v0.19.0でpipによるインストールは非推奨になりました。インストールをご覧ください。）
• サブスクリプションをローカルのAPIエンドポイントとして利用できます。 hermes proxyを使うと、Claude Pro、ChatGPT Pro、SuperGrokなど、OAuthベースのプロバイダーを、Codex、Aider、Cline、Continueといったツールから利用できるOpenAI互換のローカルエンドポイントに変換できます。
• gatewayの対応範囲が広がりました。 LINEとSimpleX Chatがgatewayに加わりました（ドキュメントのプラットフォーム比較表では、タグv2026.8.31時点で28プラットフォームが掲載されています。この数に何が含まれるかは、メッセージングgatewayセクションで説明しています）。Microsoft Teamsは一連の処理全体で接続され、Discordの履歴バックフィルはデフォルトで有効になりました。また、TelegramとDiscordのclarifyプロンプトではネイティブボタンが使われるようになっています。
• 書き込み時の検証が改善されました。 編集後、次のターンへ進む前に、ターンごとのファイル変更概要とlanguage serverのセマンティック診断をHermesが提示できるようになりました。これにより、エビデンスに基づくエージェント作業へさらに近づいています。
• デスクトップとメディアツールの対応範囲が広がりました。 computer_useは、Anthropic以外のプロバイダーでもcua-driverを介して動作します。video_generateはプラグイン可能なバックエンドのもとに統合され、vision_analyzeは実際に視覚入力へ対応するモデルに未加工のピクセルデータを送信します。

インストール

公式にサポートされているインストール方法は、1行のインストーラーです。Python、uv、Node.js、ripgrep、ffmpeg、リポジトリのクローン、仮想環境、グローバルな hermes コマンドをまとめてセットアップします。⁷

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

v0.19.0以降、pipおよびHomebrewによるインストールは非推奨です。 v0.14.0で導入されたPyPIパッケージ（pip install hermes-agent）とHomebrew formulaは、現在「サポート対象外のレガシー」インストールとされています。Hermesがこれらを検出すると、すべての画面で警告が表示されます（動作はブロックされません）。また、PyPIとHomebrewでの公開は今後終了する予定です。pipまたはbrewでインストールした場合は、上記のインストーラーへ移行してください。⁵⁶

Linux、macOS、WSL2、Android/Termuxで動作します（インストーラーがTermuxを自動検出し、テスト済みのAndroidバンドルに切り替えます）。⁷ ネイティブWindowsは、v0.14.0で提供された初期ベータ版からTier 1プラットフォームへ昇格しました。iex (irm https://hermes-agent.nousresearch.com/install.ps1) でインストールできます。ただし、ドキュメントには明確な注意事項があります。macOSでサポートされるのはApple Siliconのみで、Intel Macはサポート対象外です。⁵⁵ これまでの経緯として、v0.14.0ではPowerShellインストーラーによるネイティブWindows対応が初期ベータ版として追加されました。ただし、Windows向けの導入手順が成熟するまでは、本番環境での利用には引き続きWSL2のほうが安全な選択肢です。¹⁹

完了したら、次を実行します。

source ~/.bashrc    # or ~/.zshrc
hermes              # Start chatting

唯一の前提条件は git です。インストーラーは、uv を使用してPython 3.11（sudo不要）、Node.js 26（ブラウザー自動化とWhatsAppブリッジ用）、ripgrep、ffmpegを自動で用意します。v0.20.0以降、Node 26が必須の最低バージョンです。インストーラーはそれより古いバージョンを拒否し、Hermesが管理するNodeを代わりにインストールします。⁵⁵⁷

インストールの確認

hermes --version    # Check version (global flag; there is no `version` subcommand)
hermes doctor       # Diagnose config/dependency issues
hermes status       # Show current configuration + auth state
hermes dump         # Copy-pasteable setup summary for debugging

hermes doctor を実行すると、不足しているものと、その修正方法が具体的に表示されます。⁷ サポートを求める際、GitHubのissueやDiscordスレッドに貼り付ける診断情報を生成するコマンドが hermes dump です。セットアップ全体をプレーンテキストで要約し、シークレットは伏せた状態で出力します。⁸

手動インストール

Pythonのバージョン指定、特定のextras、Nix/NixOSとの統合など、環境を細かく制御する必要がある場合は、上流のインストールガイドに手動手順が段階的に記載されています。⁷ uv pip install -e ".[<extras>]" で組み合わせられる主なオプションのextrasは次のとおりです。

Termuxではインストールコマンドが異なります。uv pip ではなく、制約ファイルを指定した pip を使用します。

python -m pip install -e ".[termux]" -c constraints-termux.txt

これは、Androidで .[all] を指定すると、voice extraを通じて faster-whisper が導入されるためです。faster-whisper が依存する ctranslate2 のwheelは、Android向けに公開されていません。⁷

認証とプロバイダー

タグ v2026.9.7 では、hermes_cli/models_catalog_static.py の311行目に39個の静的な CANONICAL_PROVIDERS エントリがあります（2026年9月の分割により、リストは hermes_cli/models.py から移動しました。エントリ自体に変更はなく、v0.21.0の tencent-tokenplan も含まれます）。さらに、plugins/model-providers/ からこのリストを自動拡張します（同梱されているディレクトリは39個です。そのうち actual、alibaba-coding-plan、commandcode、deepinfra、meta-ai、nebius-token-factory、opencode-free、router、upstage の9個には静的エントリがなく、デフォルトの api_key 認証タイプを使用するため、自動拡張によって取り込まれます）。ドキュメントのプロバイダーページには、45個のクラウドおよびサブスクリプションプロバイダーと、カスタムエンドポイントの行が表にまとめられています。さらに、ローカルおよびセルフホスト型サーバー（Ollama、vLLM、SGLang、llama.cpp、LM Studio、LiteLLM、ClawRouter、任意のOpenAI互換エンドポイント）についても個別に説明されています。²⁶ タグ v2026.9.24 でも静的リストは39エントリのままですが、plugins/model-providers/ のディレクトリは38個です。キー不要の opencode-free プロバイダーは、OpenCodeの無料枠が独自クライアント外からの匿名トラフィックを拒否するようになったため、9月18日に削除されました。⁵³ この基盤の上に、カスタムエンドポイントと3つの異なる認証パスがあります。利用可能な認証情報に合うものを見つけられるよう、認証の全体像をパス別に整理します。

3つの認証パス

Hermesのすべてのプロバイダーは、次の3つの認証パターンのいずれかに該当します。

パス1 — .env 内のAPIキー。 キーを ~/.hermes/.env に配置すると、Hermesが起動時に読み取ります。OpenRouter、AI Gateway、z.ai/GLM、Kimi/Moonshot、MiniMax（MiniMax Chinaを含む）、Alibaba Cloud/DashScope、Kilo Code、OpenCode Zen、OpenCode Go、DeepSeek、Hugging Face、Google/Gemini、および大半のサードパーティプロバイダーで使用します。² v0.19.0以降、キーを平文ファイルに置く必要はありません。プラグイン可能な SecretSource インターフェースにより、読み込み時にBitwardenまたは1Password（op:// 参照）からシークレットを取得できます。複数の保管庫を同時に有効化でき、優先順位は決定論的に処理され、競合時には警告が表示されます。また、変数ごとに取得元を追跡でき、.env はフォールバックとして残ります。（これは、1つのトークンにプロバイダーキーを集約したv0.15.0のBitwarden Secrets Managerブートストラップトークンとは異なります。SecretSource は平文ファイル自体を置き換えるもので、今後の保管庫プロバイダーもプラグインとして追加できます。）⁵⁶

パス2 — hermes model または hermes auth を介したOAuth。 デバイスコードフローを開始してブラウザを開き、認証情報を ~/.hermes/auth.json に保存します（Claude CodeやCodex CLIなどのツールから既存の認証情報をインポートすることもできます）。Nous Portal、OpenAI Codex（ChatGPTアカウント）、GitHub Copilot、Anthropic（Claude Pro/Max）で使用します。²

パス3 — config.yaml 内のカスタムエンドポイント。 Ollama、vLLM、SGLang、llama.cpp、LM Studio、LiteLLMプロキシ、Together AI、Groq、Azure OpenAI、独自のセルフホスト型サーバーなど、OpenAI互換のAPIで使用します。hermes model → Custom endpoint から一度設定すると、config.yaml に保存されます。²

プロバイダーの全マトリックス

このマトリックスでは、ドキュメントページの表に掲載されているプロバイダーと、それぞれの正確な設定手順をまとめています。このタグの選択画面には、ドキュメントよりも多くのプロバイダーが表示されます（上記の件数を参照）。また、OpenAI互換のものはすべて、カスタムエンドポイントの行から利用できます。²²⁶

Anthropic: 3つの認証方式

Hermesは Claude への接続方法を3つサポートしており、適切な方式の選択が重要なため、Anthropic について個別に解説します。アップストリームのドキュメントによると、次のとおりです。²

# Method 1: API key (pay-per-token)
export ANTHROPIC_API_KEY=***
hermes chat --provider anthropic --model claude-sonnet-4-6

# Method 2: OAuth through hermes model (preferred)
# Uses Claude Code's credential store when available
hermes model

# Method 3: Manual setup-token (fallback/legacy)
export ANTHROPIC_TOKEN=***
hermes chat --provider anthropic

# Auto-detect Claude Code credentials
hermes chat --provider anthropic   # reads Claude Code files automatically

hermes model で Anthropic OAuth を選択すると、Hermesはトークンを ~/.hermes/.env にコピーするのではなく、Claude Code 自体の認証情報ストアを優先します。これにより、更新可能な Claude の認証情報を引き続き更新できます。² 同じマシンですでに Claude Code を使用している場合は、これが最もすっきりした方法です。

config.yaml で Anthropic を常時使用するには、次のように指定します。

model:
  provider: "anthropic"
  default: "claude-sonnet-4-6"

--provider claude と --provider claude-code は、--provider anthropic の短縮形としても使用できます。²

GitHub Copilot: 2つのモード

Copilotは、直接Copilot API（推奨）とCopilot ACP（ローカルのCopilot CLI をサブプロセスとして起動）の2つのモードに対応しています。²

# Direct Copilot API
hermes chat --provider copilot --model gpt-5.4

# Copilot ACP (requires the Copilot CLI in PATH + an existing copilot login)
hermes chat --provider copilot-acp --model copilot-acp

アップストリームのドキュメントによると、認証は次の順序で確認されます。² 1. COPILOT_GITHUB_TOKEN 環境変数 2. GH_TOKEN 環境変数 3. GITHUB_TOKEN 環境変数 4. gh auth token CLI フォールバック 5. hermes model による OAuth デバイスコードログイン

トークンの種類が重要です。 Copilot API は、従来型のPersonal Access Token（ghp_*）をサポートしていません。サポートされているのは、OAuth トークン（gho_*）、きめ細かなPAT（Copilot Requests 権限を持つ github_pat_*）、GitHub Appトークン（ghu_*）です。gh auth token が ghp_* トークンを返す場合は、代わりに hermes model を使用して OAuth で認証してください。²

中国のAIプロバイダー（正式サポート）

Hermesは、z.ai/GLM、Kimi/Moonshot、MiniMax（グローバルおよび中国向けエンドポイント）、Alibaba Cloudを専用のプロバイダーIDで組み込みサポートしています。²

# z.ai / ZhipuAI GLM
hermes chat --provider zai --model glm-5                 # Requires: GLM_API_KEY

# Kimi / Moonshot AI
hermes chat --provider kimi-coding --model kimi-for-coding   # Requires: KIMI_API_KEY

# MiniMax (global)
hermes chat --provider minimax --model MiniMax-M2.7          # Requires: MINIMAX_API_KEY

# MiniMax (China)
hermes chat --provider minimax-cn --model MiniMax-M2.7       # Requires: MINIMAX_CN_API_KEY

# Alibaba Cloud / DashScope (Qwen)
hermes chat --provider alibaba --model qwen3.5-plus          # Requires: DASHSCOPE_API_KEY

ベースURLは、環境変数 GLM_BASE_URL、KIMI_BASE_URL、MINIMAX_BASE_URL、MINIMAX_CN_BASE_URL、DASHSCOPE_BASE_URL で上書きできます。²

Z.AIはエンドポイントを自動検出します。 z.ai/GLMプロバイダーを使用すると、Hermesは複数のエンドポイント（グローバル、中国、コーディング向けの各バリアント）を調査し、使用中の API キーを受け付けるものを探します。利用可能なエンドポイントは自動的にキャッシュされるため、ほとんどの場合、GLM_BASE_URL の指定は不要です。²

xAI（Grok）はプロンプトキャッシュを自動的に有効化します。 ベースURLに x.ai が含まれている場合、Hermesは会話セッション内のリクエストを同じサーバーへ転送するため、リクエストごとに x-grok-conv-id ヘッダーを送信します。これにより、キャッシュされたシステムプロンプトと履歴を再利用できます。² 自動で動作するため、設定は不要です。

hermes auth コマンド

hermes auth は、プールと OAuth の認証情報を管理するコマンドです。⁶

hermes auth                              # Interactive wizard
hermes auth list                         # Show all credential pools
hermes auth list openrouter              # Show one provider's pool
hermes auth add openrouter --api-key sk-or-v1-xxx
hermes auth add anthropic --type oauth
hermes auth remove openrouter 2          # Remove by index
hermes auth reset openrouter             # Clear cooldowns

認証情報プールを使うと、同じプロバイダーに対して複数の API キーまたは OAuth トークンをローテーションできます。コードを変更せずに、複数のキーへレート制限を分散したい場合に便利です。⁶ 従来の hermes login／hermes logout コマンドは削除されました。代わりに hermes auth を使用してください。⁶

カスタムおよびセルフホスト型エンドポイント

Hermesは、OpenAI互換のあらゆる API エンドポイントで動作します。サーバーが /v1/chat/completions を実装していれば、Hermesの接続先として指定できます。²

対話形式の設定（推奨）:

hermes model
# Select "Custom endpoint (self-hosted / VLLM / etc.)"
# Enter: API base URL, API key, Model name

手動での config.yaml 設定:

model:
  default: your-model-name
  provider: custom
  base_url: http://localhost:8000/v1
  api_key: your-key-or-leave-empty-for-local

どちらの方法でも設定は config.yaml に保存されます。これはメインモデル、プロバイダー、ベースURLに関する唯一の信頼できる情報源です。² 従来の環境変数 OPENAI_BASE_URL と LLM_MODEL は、メインモデルの設定では読み込まれなくなりました。hermes model を使用するか、config.yaml を直接編集してください。²（ただし、補助的な provider: "main" ルーティング経路のフォールバックでは、OPENAI_BASE_URL と OPENAI_API_KEY が引き続き使用されます。その用途で利用している場合は、安易に削除しないでください。）⁴

セッション途中でのカスタムエンドポイントの切り替え:

/model custom:qwen-2.5             # Custom endpoint with explicit model
/model custom                      # Auto-detect the model from the endpoint
/model custom:local:qwen-2.5       # Named custom provider "local"
/model custom:work:llama3          # Named custom provider "work"
/model openrouter:claude-sonnet-4  # Back to a cloud provider

/model custom（モデル名なし）を実行すると、エンドポイントの /v1/models API を照会し、読み込まれているモデルが1つだけの場合は自動的に選択します。単一モデルを実行するローカルサーバーで便利です。²

ローカル LLM サーバー（セットアップテンプレート）

公式ドキュメントには、Ollama、vLLM、SGLang、llama.cpp、LM Studioの詳細なセットアップガイドがあります。ここでは、実際に使用する主要なコマンドを紹介します。いずれも、Hermesから接続できる実用的なエンドポイントを構築するためのものです。²

Ollama — 最も手軽なローカル環境で、設定は不要です。

ollama pull qwen2.5-coder:32b
OLLAMA_CONTEXT_LENGTH=32768 ollama serve   # Raise from 4k default
hermes model   # Custom endpoint → http://localhost:11434/v1 → qwen2.5-coder:32b

Ollamaで特に注意すべき点： Ollamaのコンテキスト長は、デフォルトでは非常に短く設定されています（VRAMが24GB未満の場合は4,096トークン）。OLLAMA_CONTEXT_LENGTH またはModelfileで必ず引き上げてください。OpenAI互換の API はクライアントからのコンテキスト長指定を受け付けないため、Hermes側では設定できません。² Agent用途では、少なくとも16k〜32kに設定しましょう。

vLLM — 高性能な GPU サービング：

pip install vllm
vllm serve meta-llama/Llama-3.1-70B-Instruct \
  --port 8000 \
  --max-model-len 65536 \
  --tensor-parallel-size 2 \
  --enable-auto-tool-choice \
  --tool-call-parser hermes

ツール呼び出しには、--enable-auto-tool-choice と --tool-call-parser <name> が必要です。対応するパーサーは、hermes（Qwen 2.5、Hermes 2/3）、llama3_json、mistral、deepseek_v3、deepseek_v31、xlam、pythonic です。これらのフラグがない場合、ツール呼び出しはプレーンテキストとして返されます。²

SGLang — RadixAttentionによるKVキャッシュ再利用に対応した高速サービング：

pip install "sglang[all]"
python -m sglang.launch_server \
  --model meta-llama/Llama-3.1-70B-Instruct \
  --port 30000 \
  --context-length 65536 \
  --tp 2 \
  --tool-call-parser qwen

SGLangで注意すべき点： デフォルトの max_tokens は128です。レスポンスが途中で切れる場合は、サーバー側で --default-max-tokens を指定するか、config.yaml で model.max_tokens を設定してください。²

llama.cpp / llama-server — CPUおよびApple Silicon Metal：

./build/bin/llama-server \
  --jinja -fa \
  -c 32768 \
  -ngl 99 \
  -m models/qwen2.5-coder-32b-instruct-Q4_K_M.gguf \
  --port 8080 --host 0.0.0.0

ツール呼び出しには --jinja が必須です。 これがないと、llama-serverは tools パラメーターを完全に無視します。その結果、モデルはレスポンス本文に JSON を書き込んでツールを呼び出そうとしますが、Hermesはそれを実際のツール呼び出しとして解析できません。²

LM Studio — GUIを備えたデスクトップアプリ：

LM Studioアプリからサーバーを起動するか（Developerタブ → Start Server）、CLI で lms server start（ポート1234で起動）と lms load qwen2.5-coder --context-length 32768 を実行します。² その後、hermes model の接続先を http://localhost:1234/v1 に設定してください。

LM Studioで特に注意すべき点： LM Studioはモデルのメタデータからコンテキスト長を読み取りますが、多くのGGUFモデルではデフォルト値として2048または4096が設定されています。LM Studioのモデル設定で、コンテキスト長を必ず明示的に指定してください。モデル選択欄の横にある歯車アイコンをクリックし、「Context Length」を少なくとも16384（できれば32768）に設定してから、モデルを再読み込みします。²

名前付きカスタムプロバイダー

複数のカスタムエンドポイント（ローカル開発サーバーとリモートの GPU サーバーなど）を使用する場合は、config.yaml で名前付きカスタムプロバイダーとして定義します。²

custom_providers:
  - name: local
    base_url: http://localhost:8080/v1
    # api_key omitted — Hermes uses "no-key-required" for keyless local servers
  - name: work
    base_url: https://gpu-server.internal.corp/v1
    api_key: corp-api-key
    api_mode: chat_completions      # optional, auto-detected from URL
  - name: anthropic-proxy
    base_url: https://proxy.example.com/anthropic
    api_key: proxy-key
    api_mode: anthropic_messages    # for Anthropic-compatible proxies

セッション中は、3要素の構文を使ってプロバイダーを切り替えられます。

/model custom:local:qwen-2.5
/model custom:work:llama3-70b
/model custom:anthropic-proxy:claude-sonnet-4

対話形式の hermes model メニューから名前付きカスタムプロバイダーを選択することもできます。²

プラガブルなプロバイダーアーキテクチャ（v0.13.0以降）

v0.13.0では、ProviderProfile ABC と plugins/model-providers/ ディレクトリが導入され、サードパーティの推論プロバイダーをコアに手を加えず追加できるようになりました。¹⁸ プロバイダーがOpenAI、Anthropic、またはCodex互換の API モードに対応している場合は、認証方法、ベースURL、モデルカタログ、キャッシュヘッダーを宣言する ProviderProfile のサブクラスを実装できます。Hermesは、組み込みプロバイダーと同じ runtime_provider.py の経路でこれを解決します。v0.13.0でプロバイダー対応が拡張された背景には、このアーキテクチャ変更があります。プロバイダーを追加するためにコアコードを編集するのではなく、プラグインとして配布できるようになったのです。

OpenAI互換ローカルプロキシ（v0.14.0以降）

hermes proxy は、Hermesがすでにサインインしている OAuth プロバイダー（Claude Pro、ChatGPT Pro、SuperGrok、または設定済みの別の互換プロバイダー）をバックエンドとして、OpenAI互換のローカルエンドポイントを公開します。¹⁹ これにより、Codex CLI、Aider、Cline、Continue、カスタムスクリプトなど、OpenAI形式の API を必要とするツールから、別途 API キーを用意せずに、サブスクリプションに紐づくHermesの認証を再利用できます。このプロキシはローカルの開発インフラとして扱ってください。バインド先を意図的に指定し、広く公開せず、プロバイダー固有の利用規約にも留意しましょう。

コンテキスト長の検出

公式ドキュメントによると、次の2つの設定は頻繁に混同されます。²

• context_length — コンテキストウィンドウ全体（入力と出力を合わせたトークン予算。たとえば Claude Opus 4.7では1,000,000、Sonnet 4.6では200,000）です。Hermesはこの値を使って、履歴を圧縮するタイミングを判断します。
• model.max_tokens — 出力の上限（モデルが1回のレスポンスで生成できる最大トークン数）です。履歴の長さとは関係ありません。

自動検出されたウィンドウサイズが正しくない場合は、context_length を設定します。

model:
  default: "qwen3.5:9b"
  base_url: "http://localhost:8080/v1"
  context_length: 131072      # tokens

Hermesは複数の情報源を順番に参照して、コンテキストウィンドウを検出します。設定による上書き → カスタムプロバイダーのモデル別設定 → 永続キャッシュ → エンドポイントの /models → Anthropic の /v1/models → OpenRouter API → Nous Portal → models.dev（3,800以上のモデルを収録するコミュニティ管理のレジストリ）→ フォールバックのデフォルト値（128K）という順序です。² この仕組みはプロバイダーを考慮するため、同じモデルでも提供元によってコンテキスト上限が異なる場合があります（たとえば、claude-opus-4.6 は Anthropic への直接接続では1Mですが、GitHub Copilotでは128Kです）。²

スマートモデルルーティング：プロバイダーのローテーションとフォールバック

Hermesでは、単一プロバイダーの1つのモデルに固定されることはありません。スマートモデルルーティングとは、 各リクエストを実際に処理するプロバイダーとモデルを決定する一連の仕組みです。認証情報 プールは複数のキーに負荷を分散し、プライマリで障害が発生すると設定済みのフォールバックが処理を引き継ぎ、 後述の補助スロットはメインモデルとは独立して、付随タスクをより低コストなモデルへ 振り分けます。²⁶ この3つはまとめて設定してください。レート制限で停止するAgentと、 処理を継続できるAgentを分ける重要な設定です。

認証情報プール。 同じプロバイダーの API キーが複数ある場合は、hermes auth でローテーション方式を設定します。これにより、複数のキーにレート制限を分散できます。⁶

フォールバックモデル。 プライマリモデルで障害（レート制限、サーバーエラー、認証エラー）が発生した際に、Hermesが自動的に切り替える予備の provider:model を設定します。²

fallback_model:
  provider: openrouter            # required
  model: anthropic/claude-sonnet-4  # required
  # base_url: http://localhost:8000/v1    # optional, for custom endpoints
  # api_key_env: MY_CUSTOM_KEY           # optional, env var name

フォールバックでは、会話内容を失うことなく、セッションの途中でモデルとプロバイダーを切り替えます。発動するのはセッションごとに最大1回です。² フォールバックに対応するプロバイダーは、openrouter、nous、openai-codex、copilot、copilot-acp、anthropic、huggingface、zai、kimi-coding、minimax、minimax-cn、deepseek、ai-gateway、opencode-zen、opencode-go、kilocode、alibaba、custom です。²

補助モデル

Hermesは、画像分析（ビジョン）、危険なコマンドの承認判定、コンテキスト圧縮、セッションタイトルの生成、TTS音声タグの挿入、skillのマッチング、MCP ツールのディスパッチ、Kanbanの指定・分解処理といった付随タスクに「補助」モデルを使用します。⁴³⁴ デフォルト（auxiliary.*.provider: "auto"）では、すべての補助タスクがメインのチャットモデル、つまり hermes model で選択したものと同じプロバイダーとモデルで実行されます。ドキュメントでは、これが従来の低コストプロバイダー自動検出に代わる仕様であることを明記しています。「以前のビルドでは、アグリゲーター（OpenRouter、Nous Portal）のユーザーを、プロバイダー側で設定された低コストのデフォルトモデルに振り分けていました。これは予想外の挙動でした……現在、auto はすべてのユーザーに対してメインモデルを使用し、config.yaml のタスク別オーバーライドは引き続き優先されます。」³⁴ 利用を始めるにあたって設定は不要ですが、コストとのトレードオフがあります。高価な推論モデルでは補助タスクにも相応の費用がかかるため、必要に応じて各タスクを安価で高速なモデルに割り当ててください。 以前の補助タスクのうち2つは、LLM をまったく使用しなくなりました。Web 抽出（「web_extract とブラウザーのスナップショットは、長いコンテンツを決定的な方法で切り詰め、全文を read_file によるページング用として保存します。LLM は関与しません」）とセッション検索（単一形式のツールが DB の内容を直接返します）です。従来の auxiliary.web_extract.* ブロックと auxiliary.session_search.* ブロックはデフォルトから削除されています。既存の config.yaml に値が残っていても「無害な残骸として無視されます」。また、このタグのデフォルトには flush_memories スロットもありません。³⁴

各補助タスクで使用するモデルとプロバイダーを設定できます。 すべての補助スロットで共通の設定項目を使用します。provider、model、base_url（さらに api_key、timeout、extra_body、タスクごとの reasoning_effort）です。⁴³⁴

auxiliary:
  vision:                          # vision_analyze + browser screenshots
    provider: "auto"               # "auto" (= main model), "openrouter", "nous", "main", etc.
    model: ""                      # e.g. "openai/gpt-4o", "google/gemini-2.5-flash"
    base_url: ""                   # Custom OpenAI-compatible endpoint
    api_key: ""                    # Falls back to OPENAI_API_KEY
    timeout: 120
    download_timeout: 30
  approval:                        # dangerous-command approval classifier
    provider: "auto"
    model: ""
    timeout: 30
  compression:                     # summarizer -- legacy compression.summary_* keys migrate here (config v17)
    provider: "auto"
    model: ""
    base_url: ""
    timeout: 120
  title_generation:                # auto-generated session titles after the first exchange
    enabled: true                  # set false to disable auto-titles
    provider: "auto"
    model: ""
    language: ""                   # empty follows the conversation; e.g. "English" pins titles to one language
  tts_audio_tags:    { provider: "auto", model: "" }  # Gemini 3.1 TTS hidden audio-tag insertion
  skills_hub:        { provider: "auto", model: "" }  # skill matching and search
  mcp:               { provider: "auto", model: "" }  # MCP tool dispatch
  triage_specifier:  { provider: "auto", model: "" }  # hermes kanban specify: rough one-liner into a concrete spec, promoted to todo
  kanban_decomposer: { provider: "auto", model: "" }  # hermes kanban decompose: triage task into a graph of child tasks routed to specialist profiles
  profile_describer: { provider: "auto", model: "" }  # hermes profile describe --auto: 1-2 sentence profile descriptions

さらに専門的なスロットも同じ形式です。goal_judge（/goal の契約が満たされたかを判定）、curator（skill 使用状況をレビューするフォーク）、background_review（ターン後に自己改善を行うフォーク）、review（/review のレビュー担当サブエージェント）、moa_reference と moa_aggregator（Mixture-of-Agents）、memory_query_rewrite、monitor があります。YAML を手動で編集する必要はありません。hermes model を実行し、「Configure auxiliary models」を選択すると、タスクごとに対話形式で選べます。³⁴

"main" プロバイダーオプションは、「メインエージェントが使用しているプロバイダーをそのまま使用する」という意味です。これは auxiliary:、compression:、およびプライマリのフォールバック項目（fallback_providers: または従来の fallback_model:）内でのみ有効です。トップレベルの model.provider 設定には使用できません。OpenAI 互換のカスタムエンドポイントをメインモデルとして使用する場合は、model: セクションで provider: custom を設定してください。⁴

これが重要な理由： auto はすでにメインモデルを使用するため、以前の「OpenRouter を設定しないと補助タスクの性能がひそかに低下する」という落とし穴はなくなりました。代わりに、考慮すべき点はコストです。メインモデルが高価な推論モデルなら、頻繁に動作する副次的なタスクには、安価で高速なモデルを割り当てましょう。

auxiliary:
  vision:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"
  compression:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"

設定システム

Hermes には階層型の設定システムがあります。上位レイヤーが下位レイヤーを上書きするうえ、config.yaml からは確認できないグローバルなプロバイダーレジストリも存在するため、優先順位の理解が欠かせません。

設定ファイルの構成

公式ドキュメントによると、Hermes の設定は次のファイルで構成されます。⁴

~/.hermes/
├── config.yaml       # All settings (model, terminal, TTS, compression, memory, toolsets, ...)
├── .env              # Secrets (API keys, bot tokens, passwords)
├── auth.json         # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md           # Primary agent identity (slot #1 in system prompt)
├── memories/         # Persistent memory (MEMORY.md, USER.md)
├── skills/           # Bundled + agent-created + hub-installed skills
├── cron/             # Scheduled jobs
├── sessions/         # Gateway session state
└── logs/             # agent.log, gateway.log, errors.log (secrets auto-redacted)

config.yaml と .env の両方に値が設定されている場合、機密情報以外の設定では config.yaml が優先されます。⁴ ルールは次のとおりです。 - 機密情報（API キー、bot トークン、パスワード）→ .env - それ以外のすべて（モデル、ターミナルバックエンド、圧縮設定、メモリ上限、toolset）→ config.yaml

config.yaml からは、シェル形式の変数展開を使って機密情報を参照できます。⁴

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}
  delegation:
    api_key: ${DELEGATION_KEY}

設定の管理

hermes config                # View current configuration
hermes config show           # Same as above
hermes config edit           # Open config.yaml in your editor
hermes config set KEY VAL    # Set a specific value
hermes config get KEY        # Print a single value (v0.19.0+)
hermes config unset KEY      # Remove a key so the default applies again (v0.19.0+)
hermes config path           # Print the config file path
hermes config env-path       # Print the .env file path
hermes config check          # Check for missing options (after updates)
hermes config migrate        # Interactively add missing options

例：⁴

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...   # Saves to .env

hermes config check と hermes config migrate は、hermes update のたびに実行するコマンドです。まだファイルに追加されていない新しい設定項目を検出できます。⁶

設定の優先順位

Hermes は複数のソースから設定を読み込みます。複数のソースで同じ値が設定されている場合は、優先順位の高いソースが適用されます。⁴

1. CLI 引数 — hermes chat --model anthropic/claude-sonnet-4（実行ごとの上書き）
2. 環境変数 — プロセス起動時に適用
3. config.yaml — メインの設定ファイル
4. .env — 機密情報のみ
5. 組み込みのデフォルト値 — ほかに値が設定されていない場合に適用

CLI フラグは、その実行に限って常に最優先されます。長期的な信頼できる情報源は config.yaml です。

ローカライズ（v0.13.0以降）

v0.13.0 では、CLI と gateway メッセージに7つのロケール（簡体字中国語、日本語、ドイツ語、スペイン語、フランス語、ウクライナ語、トルコ語）が追加されました。¹⁸ v0.14.0 では、すべての gateway コマンドとウェブダッシュボードがローカライズされ、さらに8つのロケールが追加されて合計16になりました。¹⁹ タグ v2026.8.31 時点の locales/ ツリーには、英語と16の翻訳（af、ar、de、es、fr、ga、hu、it、ja、ko、pt、ru、tr、uk、zh-hant、zh）からなる17のメッセージカタログがあります。³³ 現在、ドキュメントがローカライズされているのは zh-Hans のみです。ロケールは LC_ALL / LANG 環境変数、または config.yaml の明示的な locale: キーによって決まります。英語が引き続きデフォルトかつ信頼できる情報源となり、翻訳がまだ対応していない文字列には英語が使われます。

Profiles — 分離された複数の Hermes インスタンス

profile を使うと、それぞれが独自の設定、セッション、skill、メモリ、gateway PID を持つ、分離された複数の Hermes インスタンスを利用できます。これにより、「仕事用 Hermes」と「個人用 Hermes」を、互いの状態を参照させずに並行して実行できます。⁶

hermes profile list
hermes profile create work --clone                  # Clone from current profile
hermes profile use work                             # Set sticky default
hermes profile alias work --name h-work             # Create wrapper script
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes -p work chat -q "Hello from work profile"    # One-off without switching

各 profile には専用の HERMES_HOME（デフォルトでは ~/.hermes-<name>/）が割り当てられるため、複数の profile で互いに干渉することなく gateway を同時に実行できます。⁶³

v0.21.2 以降、この分離境界はさらに厳格に適用されます。一連の修正により、複数の profile で gateway を多重化する構成に実在した、profile 間の情報漏洩が解消されました。たとえば、セカンダリ profile がデフォルト profile の許可リストを継承する、そのホストへ認証情報を送信する、stdio MCP サーバーへ vault の機密情報を渡す、別の profile の .env/auth.json/state.db を MEDIA: 配信に添付するといった問題です（#107609〜#107630）。profile を多重化する場合、分離に関する仕様が実際に保証されるのは v0.21.2 以降です。詳しくは、v0.21.2の新機能をご覧ください。⁴⁸

CLI コマンド

このセクションでは、トップレベルの CLI コマンドを実務者向けにまとめます。コードに基づく正式なリファレンスについては、アップストリームの CLI コマンドリファレンスをご覧ください。⁶

グローバルオプション

hermes [global-options] <command> [subcommand/options]

トップレベルコマンド

hermes chat — メインのエントリーポイント

引数なしで hermes を実行すると、対話形式のチャットが開始されます。hermes chat は、オプションを指定できる明示的な形式です。⁶

hermes chat -q "Summarize the latest PRs" --oneshot # Answer and exit (without --oneshot, a TTY seeds an interactive session)
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills          # Enable specific toolsets
hermes chat --quiet -q "Return only JSON"           # Programmatic mode
hermes chat --worktree -q "Review repo and open a PR"

主なオプション：

hermes setup — 完全セットアップウィザード

完全なセットアップウィザードを実行するか、特定のセクションへ直接移動します。⁶

hermes setup                 # Full wizard
hermes setup model           # Provider and model only
hermes setup terminal        # Terminal backend only
hermes setup gateway         # Messaging platforms only
hermes setup tools           # Tool enable/disable per platform
hermes setup agent           # Agent behavior only
hermes setup --non-interactive
hermes setup --reset         # Reset config to defaults before setup

hermes logs — 構造化ログの照会

hermes logs は、レベル、セッション ID、期間を同時に指定して絞り込めるため、ログファイルに対する tail -f よりも高機能です。⁶

hermes logs                          # Last 50 lines of agent.log
hermes logs -f                       # Follow in real time
hermes logs gateway -n 100           # Last 100 lines of gateway.log
hermes logs --level WARNING --since 1h   # Warnings from the last hour
hermes logs --session abc123         # Filter by session ID substring
hermes logs errors --since 30m -f    # Follow errors.log from 30m ago
hermes logs list                     # List all log files with sizes

ログファイルは ~/.hermes/logs/ にあります。⁶ - agent.log — エージェントのすべてのアクティビティ（API 呼び出し、ツールのディスパッチ、セッションのライフサイクル、INFO 以上） - errors.log — 警告とエラーのみ（agent.log から絞り込まれたサブセット） - gateway.log — メッセージング gateway のアクティビティ（プラットフォーム接続、ディスパッチ、webhook）

ローテーションは Python の RotatingFileHandler によって自動的に行われます。agent.log.1、agent.log.2 などを確認してください。⁶

hermes doctor — 診断

問題が発生したとき、最初に実行するコマンドは hermes doctor [--fix] です。設定の妥当性、依存関係の有無、API キーを利用できるか、サービスの状態を確認します。--fix を指定すると自動修復も試行できます。⁶

診断情報をほかの人と共有する場合は、hermes dump を使用してください。秘匿化された API キーを含む簡潔なプレーンテキストの概要が生成され、GitHub の issue や Discord のスレッドにそのまま貼り付けられます。⁶

Slash Commands

Slash Commands は、アクティブなチャットセッション（CLI またはメッセージングプラットフォーム）内で実行します。hermes_cli/commands.py の共有 COMMAND_REGISTRY から振り分けられるため、ほとんどのコマンドはどのインターフェースでも同じように機能します。⁹

セッション操作

設定とモデル

/model コマンドは、セッションの途中でプロバイダーを切り替える際の中心的な機能です。⁹

/model                              # Show current model and options
/model claude-sonnet-4              # Switch model (auto-detect provider)
/model zai:glm-5                    # Switch provider:model
/model custom:qwen-2.5              # Use model on custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Named custom provider
/model openrouter:anthropic/claude-sonnet-4   # Back to cloud

v0.19.0では /model --once が追加されました。1ターンだけモデルを上書きし、応答後に以前のモデルへ自動的に戻ります。⁵⁶ v0.20.5の期間以降、/model の選択画面はあいまい検索にも対応し、入力に合わせて候補を絞り込みます。²³³⁵

ツール、skill、情報

動的な skill の Slash Commands

インストール済みの各 skill は、自動的に Slash Command として公開されます。⁹

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/excalidraw       # Just the skill name loads it and lets the agent ask what you need

v0.19.0以降、Slash Command による skill の呼び出しは重ねて指定できます。/skill-a /skill-b do XYZ と入力すると、1ターン内で両方の skill が順番に読み込まれます。連結した名前には、オートコンプリートとゴーストテキストも利用できます。⁵⁶

config.yaml では、短い名前を長いプロンプトの別名として割り当てるクイックコマンドも定義できます。⁹

quick_commands:
  review: "Review my latest git diff and suggest improvements"
  deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
  morning: "Check my calendar, unread emails, and summarize today's priorities"

その後、CLI で /review、/deploy、または /morning と入力します。

前方一致

コマンドは前方一致に対応しています。/h は /help、/mod は /model として解決されます。複数の候補に一致する場合は、レジストリへの登録順で最初のコマンドが優先されます。コマンドの完全名と登録済みの別名は、常に前方一致より優先されます。⁹

メッセージング固有のコマンド

一部のコマンドは、メッセージングプラットフォーム（Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant）でのみ使用できます。⁹

• /status — セッション情報を表示します（メッセージング専用ではなくなりました。セッション操作をご覧ください）
• /sethome（別名 /set-home）— 現在のチャットをプラットフォームのホームとして設定します
• /approve [session|always] — 保留中の危険なコマンドを承認します
• /deny [reason] — 保留中の危険なコマンドを拒否します。v0.19.0以降、/deny <reason> は拒否理由をエージェントへ伝えるため、理由が分からないまま再試行するのではなく、方針を修正できます⁵⁶
• /update — Hermes Agent を最新版へ更新します
• /commands [page] — すべてのコマンドと skill をページ単位で閲覧します

また、/skin、/tools、/toolsets、/browser、/config、/cron、/skills、/platforms、/paste、/statusbar、/plugins は CLI でのみ使用できます。⁹

ツールと toolset

Hermes には、ウェブ検索、ブラウザ自動操作、ターミナル実行、ファイル編集、メモリ、委任、RL トレーニング、メッセージ配信、Home Assistant 連携などを網羅する、幅広い組み込みツールレジストリが用意されています。¹⁰ ツールは論理的な toolset にまとめられており、プラットフォームごとに有効・無効を切り替えられます。

主なカテゴリー

一般的な toolset 名には、web、terminal、file、browser、vision、image_gen、moa、skills、tts、todo、memory、session_search、cronjob、code_execution、delegation、clarify、homeassistant、rl があります。¹⁰

ツールの管理

hermes chat --toolsets "web,terminal"       # Use specific toolsets
hermes tools                                # Interactive per-platform tool config
hermes tools --summary                      # Print enabled-tools summary

セッションの途中でも、/tools disable <name> と /tools enable <name> を使用してツールの有効・無効を切り替えられます。切り替えるとセッションがリセットされ、新しいツール構成が反映されます。⁹

ターミナルバックエンド

ターミナルツールには7つの実行バックエンドが組み込まれています。v0.20.6以降は、プロバイダー選択機能と同様にプラグインで拡張できます（後述）。¹⁰²⁴

バックエンドは、hermes config set terminal.backend <name> または config.yaml で切り替えます。

terminal:
  backend: docker      # or: local, ssh, singularity, modal, daytona, vercel_sandbox
  cwd: "."             # Working directory
  timeout: 180         # Command timeout in seconds

プラグインバックエンド（v0.20.6以降）。 サードパーティーのサンドボックスベンダーは、コアリポジトリへ直接実装を追加する必要がなくなりました。プラグインの読み込み時に、PluginContext.register_terminal_environment_provider を介して TerminalEnvironmentProvider を登録すると、その登録名を組み込みバックエンドとまったく同じように terminal.backend から選択できます。組み込み名は予約されており、ツリー内のバックエンドと名前が競合するプロバイダーはレジストリによって拒否されます。また、コアでは名前をハードコードしたリストではなく、各分類箇所でレジストリを参照するため、登録済みバックエンドはすべてのコア機能（hermes setup のバックエンド選択、ダッシュボードのプローブ状態、hermes doctor のチェック、コンテナのパスおよび cwd の処理、シークレットの除去）へ自動的に組み込まれます。³²

SSH バックエンド（セキュリティ上推奨 — エージェントが自身のコードを変更できません）：¹⁰

terminal:
  backend: ssh

# In ~/.hermes/.env
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Docker バックエンド：

terminal:
  backend: docker
  docker_image: python:3.11-slim

コンテナリソース（docker、singularity、modal、daytonaに適用）：¹⁰

terminal:
  container_cpu: 1
  container_memory: 5120          # MB (default 5GB)
  container_disk: 51200           # MB (default 50GB)
  container_persistent: true      # Persist filesystem across sessions

container_persistent: true を指定すると、インストールしたパッケージ、ファイル、設定がセッションをまたいで保持されます。¹⁰

すべてのコンテナバックエンドには、セキュリティ強化策が適用されます。具体的には、ルートファイルシステムの読み取り専用化（Docker）、DAC_OVERRIDE、CHOWN、FOWNER を除くすべての Linux capability の削除、権限昇格の禁止、PID 制限（256プロセス）、完全な namespace 分離、volume による永続ワークスペースです。¹⁰

バックグラウンドプロセス

ターミナルツールでは、明示的なプロセス管理を伴うバックグラウンド実行に対応しています。¹⁰

terminal(command="pytest -v tests/", background=true)
# Returns: {"session_id": "proc_abc123", "pid": 12345}

process(action="list")                            # Show all running processes
process(action="poll", session_id="proc_abc123")  # Check status
process(action="wait", session_id="proc_abc123")  # Block until done
process(action="log", session_id="proc_abc123")   # Full output
process(action="kill", session_id="proc_abc123")  # Terminate
process(action="write", session_id="proc_abc123", data="y")  # Send input

PTY モード（pty=true）を使用すると、Codex や Claude Code などの対話型 CLI ツールを利用できます。¹⁰

Sudo

コマンドで sudo が必要になると、Hermes がパスワードの入力を求めます（セッション中はキャッシュされます）。または、~/.hermes/.env に SUDO_PASSWORD を設定してください。¹⁰

Multi-Agent Kanban（v0.13.0以降）

v0.13.0では、マルチエージェントの協調作業が中核的な機能へと引き上げられました。導入されたのは、エージェント間や再起動後もタスク、ステータス、ワーカーの識別情報を追跡できる永続 Kanban ボードです。¹⁸ このボードによって、Hermes のワーカー群は機能しない引き継ぎで停滞せず、実際に作業を完了できるようになります。

Kanban ボードは、目標側では /goal（目標を固定した Ralph ループ）、生成処理では既存の delegate_task ツールと自然に組み合わせられます。その結果、次に何をすべきか、誰が担当しているか、何が行き詰まっているかについて、すべてのエージェントが単一の信頼できる情報源を共有する swarm パターンが実現します。

Hermes Swarm とは？

swarm とは、1つの共有 Kanban ボードを対象に、複数の Hermes ワーカーを並列実行する構成です。 有効化する独立したサブシステムではなく、ボードによって実現する運用形態です。ボードは、 並列エージェントだけでは得られない唯一の要素を提供します。それは、次にどのタスクを取得すべきか、 そして誰かがすでに担当しているかという問いに対する、単一の信頼できる回答です。

v0.15.0では、このパターンが正式にサポートされるトポロジーへと昇格しました。追加されたのは、 並列ワーカーを協調させる swarm トポロジー、高レベルの目標をサブタスクへ分割する 自動分解、タスク単位のモデル上書き、スケジュールされたタスク、そして並列 ワーカーが同じチェックアウト内で競合しないようにするworktree 管理です。⁵⁹

実際の流れは、swarm に目標を与え、自動分解によってボード上のタスクへ分割し、 各ワーカーに取得、実行、結果の返却を任せるというものです。再試行回数はタスク単位（max_retries）で設定されるため、 不安定なサブタスクが実行全体の許容回数を使い切ることはありません。ボードは永続化されるので、 再起動しても swarm の状態は維持され、ワーカーは同じ状態へ再接続して作業を再開できます。

swarm の品質は、タスク分解の品質によって決まります。 ボードはワーカーを調整しますが、 不適切に分割された目標を適切なものへ変えるわけではありません。隠れた状態を共有するタスク同士は、 worktree を使用していても競合します。

Skillsシステム

skillは、必要なときにエージェントが読み込めるオンデマンドの知識ドキュメントです。トークン使用量を抑えるために段階的開示のパターンを採用しており、agentskills.ioのオープン標準と互換性があります。¹¹

すべてのskillは~/.hermes/skills/に配置されます。ここが主要ディレクトリであり、信頼できる唯一の情報源です。新規インストール時には、同梱のskillがリポジトリからコピーされます。Hubからインストールしたskillや、エージェントが作成したskillもここに保存されます。¹¹

段階的開示

Level 0: skills_list()           → [{name, description, category}, ...]   (~3k tokens)
Level 1: skill_view(name)        → Full content + metadata                 (varies)
Level 2: skill_view(name, path)  → Specific reference file                 (varies)

エージェントがskillの全内容を読み込むのは、実際に必要になったときだけです。¹¹

SKILL.mdの形式

---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
platforms: [macos, linux]      # Optional — restrict to OS platforms
metadata:
  hermes:
    tags: [python, automation]
    category: devops
    fallback_for_toolsets: [web]     # Conditional activation
    requires_toolsets: [terminal]    # Conditional activation
    config:                          # Config.yaml settings
      - key: my.setting
        description: "What this controls"
        default: "value"
        prompt: "Prompt for setup"
---

# Skill Title

## When to Use
Trigger conditions for this skill.

## Procedure
1. Step one
2. Step two

## Pitfalls
- Known failure modes and fixes

## Verification
How to confirm it worked.

条件付き有効化

利用可能なツールに応じて、skillの表示・非表示を切り替えられます。特に便利なのがフォールバックskillです。有料ツールを利用できない場合に限り、無料またはローカルの代替手段を表示できます。¹¹

例： 組み込みのduckduckgo-search skillでは、fallback_for_toolsets: [web]を使用します。FIRECRAWL_API_KEYが設定されている場合、web toolsetが利用可能になり、エージェントはweb_searchを使用するため、DuckDuckGo skillは非表示のままです。APIキーがない場合は、DuckDuckGo skillがフォールバックとして自動的に表示されます。¹¹

エージェントが管理するskill

エージェントはskill_manageツールを介して、自身のskillを作成、更新、削除できます。これはエージェントの手続き記憶です。簡単ではないワークフローを解明すると、その手順をskillとして保存し、後から再利用できます。¹¹

エージェントがskillを作成するタイミング：¹¹ - 複雑なタスク（ツール呼び出し5回以上）を正常に完了した後 - エラーや行き詰まりを経験し、機能する手順を見つけたとき - ユーザーがアプローチを修正したとき - 簡単ではないワークフローを発見したとき

アクション：¹¹

Skill Hub

オンラインレジストリからskillを閲覧、検索、インストール、管理できます。⁶¹¹

hermes skills browse                          # Browse all hub skills
hermes skills browse --source official        # Browse official optional skills
hermes skills search kubernetes               # Search all sources
hermes skills search react --source skills-sh # Search skills.sh directory
hermes skills inspect openai/skills/k8s       # Preview before installing
hermes skills install openai/skills/k8s       # Install with security scan
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills check                           # Check for upstream updates
hermes skills update                          # Reinstall changed hub skills
hermes skills audit                           # Re-scan installed hub skills
hermes skills uninstall k8s
hermes skills publish skills/my-skill --to github --repo owner/repo
hermes skills tap add myorg/skills-repo       # Add custom GitHub source

統合済みのHubソース：¹¹

デフォルトのGitHub tap（設定なしで閲覧可能）：openai/skills、anthropics/skills、huggingface/skills、NVIDIA/skills、garrytan/gstack。claude-marketplaceソースはv0.20.0で削除され、ソース一覧ではbrowse-shに置き換えられました。¹¹⁵⁵

セキュリティスキャン

Hubからインストールされるすべてのskillはセキュリティスキャナーを通過し、データの持ち出し、プロンプトインジェクション、破壊的なコマンド、サプライチェーンに関する兆候、その他の脅威が検査されます。¹¹

信頼レベル：¹¹

community skillでは、危険ではないポリシーブロックを--forceで無視できます。ただし、スキャンによるdangerous判定は無視できません。¹¹

外部skillディレクトリ

ローカルディレクトリと併せてスキャンする追加のskillディレクトリをHermesに指定できます。¹¹

skills:
  external_dirs:
    - ~/.agents/skills
    - /home/shared/team-skills
    - ${SKILLS_REPO}/skills

パスでは~の展開と${VAR}環境変数の置換を利用できます。外部ディレクトリは読み取り専用です。エージェントがskillを作成または編集する場合は、必ず~/.hermes/skills/に書き込みます。同名のskillが両方に存在する場合は、ローカル側が優先されます。¹¹

固定skill：skills.auto_load（v0.21.4時点）

config.yamlのskills.auto_loadに列挙したskill名は、CLI、TUI、gateway、cron、APIを含むすべての新規セッションで、全内容が読み込まれた状態に固定されます。⁵¹

skills:
  auto_load:
    - team-conventions
    - deploy-checklist

このリストが解決されるのは、エージェントのプロンプトを最初に構築するときの1回だけです。存在しない名前や無効化されている名前は警告を表示してスキップされ、セッションが失敗することはありません。また、--ignore-rulesの内部で使われる仕組みであるHERMES_IGNORE_RULESは、他の自動挿入コンテキストと同様に、このリストも抑制します。これは常設指示として機能し、1つのセッションだけでskillを事前読み込みする-s/--skillsを補完するものです。⁵¹

永続メモリ

Hermes には、セッションをまたいで保持される、容量に上限のある厳選されたメモリがあります。エージェントのメモリは2つのファイルで構成され、どちらも ~/.hermes/memories/ に保存されます。¹²

両方とも、セッション開始時に固定されたスナップショットとしてシステムプロンプトへ挿入されます。エージェントは memory ツールの add、replace、remove を使って、自身のメモリを管理します。¹²

固定スナップショットパターン： システムプロンプトへの挿入内容はセッション開始時に1度だけ取得され、セッション中には変更されません。これは意図的な仕様で、パフォーマンス向上のために LLM のプレフィックスキャッシュを維持します。セッション中に加えた変更は即座にディスクへ保存されますが、システムプロンプトに反映されるのは次のセッションからです。¹²

保存すべき内容

保存する内容（エージェントが能動的に行います）：¹² - ユーザーの好み：「JavaScript より TypeScript を好む」→ user - 環境情報：「このサーバーは Debian 12 と PostgreSQL 16 で稼働している」→ memory - 訂正事項：「Docker コマンドでは sudo を使わない。ユーザーは docker グループに所属している」→ memory - 規約：「プロジェクトではタブ、1行120文字、Googleスタイルのdocstringを使用する」→ memory - 完了した作業：「2026年1月15日にデータベースを MySQL から PostgreSQL へ移行した」→ memory

保存しない内容：¹² - 些細または自明な情報 - 簡単に再確認できる事実 - 生データのダンプ（メモリには大きすぎるもの） - そのセッションでしか必要のない一時的な情報 - すでにコンテキストファイルに含まれている情報

セッション検索

MEMORY.md と USER.md に加えて、エージェントは session_search ツールを使い、過去の会話を検索できます。すべての CLI セッションとメッセージングセッションは、FTS5全文検索に対応した SQLite（~/.hermes/state.db）に保存されます。v0.15.0での再設計以降、このツールは LLM を一切使用せず、保存済みの会話内容を直接返します（ソースでの表現は「single-shape tool returns DB content directly」）。これにより4,500倍高速になり、API コストもなくなりました。¹²⁵⁹³⁴

v0.21.4前後には2つの機能が追加され、どちらもタグ v2026.9.21 で確認されています。1つ目は期間指定です。検索時に、セッション開始時刻の下限を含む after と、上限を含まない before を指定できます。いずれもISO形式の日付または日時に対応し、日付のみの場合はその日の午前0時（UTC）を意味します。相対期間（7d、24h、2w）も指定できますが、実際に期間を示すクエリだけで使用することを想定しています。sort は引き続き順位付けの調整であり、期間の境界ではありません。2つ目は、検索結果が0件だった場合の再検索です。FTS5では語句の間に暗黙のANDが適用されるため、複数語を言い換えたクエリでは、そのうち1語でも含まれない保存済みの文を見落とすことがあります。そのため、完全一致クエリと部分文字列によるフォールバックがすべて0件だった場合は、いずれかの語に一致するようインデックスを再検索し、より多くの語を含む行を上位に並べます。結果が見つかった場合は完全一致のセマンティクスが維持されます（再検索は結果が0件の場合に限られます）。また、明示的なOR/NOT、単一語、CJK向けに処理されるクエリは対象外です。⁵¹

外部メモリprovider

MEMORY.md と USER.md を超える高度な永続メモリとして、Hermes には Honcho、OpenViking、Mem0、Holographic、RetainDB、ByteRover、Supermemory という7つの外部メモリproviderプラグインが付属しています。Hindsight など、ほかのproviderはプラグインカタログからインストールできます。¹²

Hindsight はv0.21.4までコアツリーに同梱されていましたが、v0.21.5でカタログへ移され、Vectorizeが保守しています。既存環境は自動的に移行されます。memory.provider: hindsight が設定されている場合、hermes update はその設定を持つすべてのprofileホームにカタログ版プラグインをインストールします。まだインストールされていなければ、エージェントの初回起動時にもインストールされます。security.allow_lazy_installs: false の場合、エージェント起動時にはメッセージがログへ記録されるだけなので、hermes plugins install hindsight を手動で実行してください。プラグインは ~/.hermes/plugins/hindsight/ に配置され、plugins.enabled に追加されます。memory.provider、memory.hindsight.*、HINDSIGHT_API_KEY、およびメモリデータはそのまま維持されます。hermes memory status と hermes plugins list で確認できます。hermes-agent[hindsight] のpip extraは廃止されました。⁵³

外部providerは組み込みメモリを置き換えるのではなく、組み込みメモリと併用されます。ナレッジグラフ、セマンティック検索、事実の自動抽出、セッション横断のユーザーモデリングなどの機能が追加されます。⁶¹²

hermes memory setup         # Pick a provider and configure it
hermes memory status        # Check what's active
hermes memory off           # Disable external provider (built-in only)

同時に有効にできる外部providerは1つだけです。組み込みメモリは常に有効です。⁶

セッションの自動再開（v0.13.0以降）

v0.13.0では、エージェントの処理中に中断が発生しても復旧できるようになりました。gatewayは再起動後に中断されたセッションを自動で再開します。/update による再起動でもアップグレードをまたいでセッション状態が維持され、開発中にソースファイルが再読み込みされても、新しいセッションを強制せず、アクティブなセッションが継続します。¹⁸ 実用上、長時間稼働するgatewayの処理やcronで実行されるジョブは、プロセスが再起動してもコンテキストウィンドウがリセットされなくなりました。

Checkpoints v2（v0.13.0以降）

v0.13.0では、状態の永続化が、実際に機能するプルーニング、ディスク保護、孤立したシャドウリポジトリの排除を備えた単一ストア設計へ刷新されました。¹⁸ 従来のcheckpointシステムでは、長期間稼働するprofileで状態がディスク上に蓄積していました。v2ストアではローカルのcheckpointストレージに厳格な上限を設け、その増大を招いていた重複管理を廃止しています。ユーザー側で設定を変更する必要はなく、次回のcheckpoint書き込みからv2のパスが使用されます。

パーソナリティと SOUL.md

SOUL.md は、Hermes インスタンスの中核となるアイデンティティです。システムプロンプトのスロット#1を占め、ハードコードされたデフォルトのアイデンティティに置き換わります。¹³

Hermes は、デフォルトの SOUL.md を ~/.hermes/SOUL.md（カスタムprofileでは $HERMES_HOME/SOUL.md）に自動で作成します。既存のユーザーファイルが上書きされることはありません。Hermes が SOUL.md を読み込むのは HERMES_HOME からだけであり、現在の作業ディレクトリは参照しません。そのため、プロジェクトが変わっても一貫したパーソナリティを維持できます。¹³

SOUL.md に記載する内容

長期的に維持する話し方やパーソナリティの指針に使用します。¹³ - 口調 - コミュニケーションスタイル - 率直さの度合い - デフォルトの対話スタイル - 文体上避けるべきこと - 不確実性、意見の相違、曖昧さを Hermes がどう扱うべきか

あまり適さない内容：¹³ - 単発のプロジェクト指示 - ファイルパス - リポジトリの規約 - 一時的なワークフローの詳細

これらは SOUL.md ではなく、AGENTS.md に記載します。

SOUL.md と AGENTS.md の違い

これは Hermes のアイデンティティ管理において最も重要な違いです。¹³

SOUL.md — アイデンティティ、口調、スタイル、コミュニケーションのデフォルト、パーソナリティに関わる振る舞い。

AGENTS.md — プロジェクトのアーキテクチャ、コーディング規約、ツールの好み、リポジトリ固有のワークフロー、コマンド、ポート、パス、デプロイに関する注意事項。

判断基準はシンプルです。どこへでも引き継ぎたい内容は SOUL.md に、特定のプロジェクトに属する内容は AGENTS.md に記載します。¹³

組み込みパーソナリティ

Hermes には、/personality で切り替えられる組み込みパーソナリティが用意されています。¹³³³

config.yaml でのカスタムパーソナリティ：¹³

agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.

その後、/personality codereviewer で切り替えます。

SOUL.md と /personality の違い

SOUL.md は基本となる話し方です。/personality はセッション単位で適用されるオーバーレイです。¹³ 実用的なデフォルト設定を SOUL.md に記載し、個別指導の会話では /personality teacher、ブレインストーミングでは /personality creative を使用するとよいでしょう。

Nous Tool Gateway（v0.10.0以降）

Hermes Agent v0.10.0（2026年4月16日）以降、有料の Nous Portalサブスクライバーは、既存のPortal認証情報を使って、厳選されたツールセットにマネージドアクセスできるようになりました。追加のAPIキーを管理する必要はありません。⁶¹ Hermes CLI自体は引き続きMITライセンスの完全なオープンソースです。変わったのは、Portal認証によってモデル推論以外の機能も利用できるようになった点です。

最も手早く始める方法はhermes setup --portalです。READMEでは「新規インストールから実行する1つのコマンド」として紹介されています。OAuth経由でログインし、プロバイダーをNousに設定して、Tool Gatewayを有効にします。以降はhermes portalで連携を管理します。hermes portal login（サブコマンドを省略した場合のデフォルト）は、同じ一括オンボーディングを実行します。hermes portal infoは「Portal認証とTool Gatewayのルーティング概要」を表示し、hermes portal openはデフォルトブラウザーでサブスクリプションページを開きます。hermes portal toolsではgatewayツールと、Nous経由でルーティングされるツールを確認できます。hermes portal statusはinfoの非表示の後方互換エイリアスとして残されており、このタグ時点のドキュメントにあるCLIリファレンスでもサブコマンドがstatusと記載されているため、どちらも利用できます。²⁸

gatewayに含まれるもの

仕組み

gatewayは、新しいuse_gateway設定フィールドを使ってツールごとにオプトインします。hermes authにPortal認証情報があり、かつツールでgatewayを有効にすると、そのツールの呼び出しはPortal経由でルーティングされます。それ以外の場合は、直接設定したAPIキー（存在する場合）が使用されます。

# config.yaml — per-tool gateway opt-in
tools:
  web_search:
    provider: firecrawl
    use_gateway: true          # route via Nous Portal subscription
  image_generation:
    provider: fal
    use_gateway: true

実行時の優先順位： gatewayが利用可能で、ツールにuse_gateway: trueが設定されている場合、直接使用するAPIキーも設定されていても、Hermesはgatewayを優先します。これは課金に関わる重要な点です。gateway経由の呼び出しでは、直接設定したAPIキーの残高ではなく、Portalサブスクリプションの利用枠が消費されます。

gatewayの有効化

hermes model                      # select Nous Portal (OAuth flow)
hermes tools                      # per-platform tool picker integrates gateway tools
hermes status                     # confirms gateway/subscription detection

サブスクリプションは、hermes authにすでに保存されているPortalのOAuth認証情報から自動的に検出されるため、別途ログインする必要はありません。v0.19.0以降は、セッション内からサブスクリプション自体も管理できます。/subscriptionではプランと残りの利用枠を確認でき、アップグレードの正確な費用やダウングレードの適用時期を事前に表示したうえで変更を適用できます。予定された変更を示すバナーと取り消し機能も備えています。/topupではクレジットを追加できます。デスクトップアプリにも、これに対応する課金設定タブがあります。⁵⁶

料金とアクセス

料金とティア名は、Nous Portalの料金ページ（https://portal.nousresearch.com/pricing）で公開されています。ティアはPortal製品側で管理されており、Hermes CLIとは独立して変更されるため、このガイドでは一覧を掲載していません。https://portal.nousresearch.com/で登録し、最新のティアについては料金ページをご確認ください。

Nous無料ティアとガイド付き初回起動（v0.21.2以降）

v0.21.2以降、新規インストールで動作するエージェントを立ち上げる際に、有料プランやAPIキーは不要です。無料の推論機能とコネクターが標準で提供され、1つのコマンドでサインインできます。チャット内からは/loginでサインインを開始できます。コネクターツール（Gmail、Linear、Notionなど）は、ほかのツールと同様にtool_searchから検索できます。デスクトップ版には、HERMES_GUEST_ONBOARDING=1で有効になるガイド付き初回起動も追加されています。有効化されるのはリテラル値1のみです。デスクトップ版のテストでも、'true'、'0'、空の値ではいずれも無効のままになることが検証されています。また、起動時の判定結果は生成されたバックエンドの環境に書き込まれるため、継承された値が意図せず反映されることはありません。⁴⁸

v0.21.4のリリース期間以降、これらのコネクターへの接続は、各フロントエンドに分散したロジックではなく、バックエンドが所有する単一の処理になりました。manage_connectionsツールの呼び出しによって、バックエンド上の純粋なデータとして扱われる接続ステートマシンが動作します（処理期限は固定の300秒で、意図的に設定キーにはしていません）。Desktop、TUI、CLIはいずれも、同じセットアップカードとして表示します。このカードには、不足している認証情報ごとにフィールド（名前、プロンプト、必須かどうか）が表示され、すべての必須フィールドにテキストが入力されるまで実行ボタンは有効になりません。バックエンドも、すべてのフロントエンドに対して同じ機密情報限定の分離を適用します。⁵¹

非推奨化に関するお知らせ

• HERMES_ENABLE_NOUS_MANAGED_TOOLS環境変数は、v0.10.0で削除されました。マネージドツールはツールごとのuse_gateway設定フィールドで有効化する方式となり、Portalサブスクリプションの状態に基づいて利用可否が制御されます。⁶¹

位置づけ：このリリースが意味しないこと

Hermes Agent CLIは、サブスクリプションに加入しなければ使えないものではありません。プロジェクトは引き続きMITライセンスであり、すべてのコア機能（CLI、skills、メモリ、メッセージングgateway、cron、MCP、ローカルダッシュボード、すべてのプロバイダーでのBYOK）は、誰にも料金を支払うことなくエンドツーエンドで動作します。v0.10.0で追加されたのは、すでにNous Portalを利用している有料ユーザー向けの便利な経路です。無料で利用できる経路から何かが削除されたわけではありません。

メッセージング gateway

Hermes は、単一の gateway プロセスから 28のメッセージングプラットフォームに接続する、長時間稼働型の gateway プロセスとして実行できます。対応するのは、Telegram、Discord、Slack、WhatsApp、Signal、SMS、メール、Home Assistant、Mattermost、Matrix、DingTalk、Feishu/Lark、WeCom、Weixin (WeChat)、BlueBubbles (iMessage)、QQBot、Microsoft Teams、Tencent Yuanbao、Google Chat、LINE、SimpleX Chat、Photon (iMessage)、WhatsApp Cloud API、WeCom Callback、Raft、IRC、ntfy、Buzz、および汎用 Webhook アダプターです。^360171819 この「28」という数は、タグ v2026.8.31 時点のドキュメントにあるプラットフォーム比較表に基づいています。一方、その内部では gateway/config.py が24個の組み込み Platform enum メンバー（local、api_server、webhook、msgraph_webhook、relay など、チャット以外の項目も含みます）を定義し、それ以外の名前は必要に応じて plugins/platforms/ 配下に同梱された22個のアダプターディレクトリのいずれかへ解決します。そのため、enum やディレクトリだけを数えても、ドキュメント上の数とは一致しません。²⁵ v0.9.0 では、BlueBubbles 経由の iMessage（Webhook の自動登録、セットアップウィザード、クラッシュ耐性）と、iLink Bot API 経由のネイティブ WeChat 対応、さらにエンタープライズアプリ向けの WeCom callback モードが追加されました。¹⁶ v0.11.0 では QQBot が追加されました。⁶⁰ v0.12.0 では Microsoft Teams と Tencent Yuanbao が追加されました。¹⁷ v0.13.0 では、20番目のプラットフォームとして Google Chat が追加されました。これは同じプラグイン可能なアダプターアーキテクチャを利用しています。また、IRC と Microsoft Teams も、汎用の env_enablement_fn / cron_deliver_env_var プラグインフックを備えた新しいアダプターパターンへ移行しました。¹⁸ v0.14.0 では LINE と SimpleX Chat が追加され、Graph 認証、Webhook リスナー、パイプラインランタイム、外向き配信までを含む Microsoft Teams スタックもエンドツーエンドで完成しました。¹⁹ v0.17.0（2026年6月19日）では、Photon Spectrum によるリレー不要の iMessage が追加されました（hermes photon login を使うデバイスコード OAuth で、Mac/BlueBubbles リレーは不要です）。さらに、公式の WhatsApp Business Cloud API アダプター（ブリッジプロセス要件を置き換えます）、SimpleX のグループおよびネイティブ添付ファイル対応、同梱プラットフォームプラグインとしての Raft も追加されています。²¹ リリースノートで大きく取り上げられてはいないものの、ドキュメントの表にはさらに2つ掲載されています。ntfy は軽量な HTTP pub-sub プッシュチャネルです。ntfy モバイルアプリからトピックを購読し、そのトピックへメッセージを送ってエージェントと会話すると、返信がスマートフォンへ届きます。公開 ntfy.sh サーバーとセルフホスト環境のどちらでも利用でき、SDK やデーモンは必要ありません。Buzz は、Nostr プロトコル上に構築された Block のオープンソース人間・エージェント協働プラットフォームである Buzz コミュニティに Hermes を接続します。外向きメッセージには buzz CLI をシェルから呼び出し、受信にはネイティブの Nostr WebSocket サブスクリプションを使用します。どちらも hermes gateway setup から設定できます。²⁵

セットアップ

hermes gateway setup                # Interactive platform configuration
hermes gateway install              # Install as user service (systemd/launchd)
hermes gateway start                # Start the installed service
hermes gateway stop
hermes gateway restart
hermes gateway status
hermes gateway run                  # Run in foreground (debugging)

対話形式のセットアップでは、API トークン、bot ID、チャネルマッピング、許可リストなど、各プラットフォームへの接続手順が案内されます。⁶

メッセージの流れ

上流のアーキテクチャドキュメントによると、次のように処理されます。³

Platform event → Adapter.on_message() → MessageEvent
  → GatewayRunner._handle_message()
    → authorize user
    → resolve session key
    → create AIAgent with session history
    → AIAgent.run_conversation()
    → deliver response back through adapter

すべてのメッセージングプラットフォームは、CLI と同じ AIAgent 会話ループを通ります。 そのため、スラッシュコマンドはどちらでもまったく同じように動作し、Telegram でスケジュールした cron ジョブの出力を Discord に配信できます。プラットフォームによる違いが存在するのは、処理の末端部分だけです。³

v0.19.0 では、profile ベースのメッセージルーティングと永続的な配信が追加されました。 1つの bot トークンを共有する単一の多重化 gateway で、特定の guild、チャネル、スレッドを別々の profile にルーティングできます。それぞれの profile では、設定、skills、メモリ、シークレットが完全に分離されており、GATEWAY_MULTIPLEX_PROFILES で上書きできます。また、堅牢化によって、1つの profile の設定ミスで gateway 全体が停止することもなくなりました。内部では、ルーティングインデックスが state.db へ移され（sessions.json は任意のレガシーミラーになりました）、最終応答はプラットフォームへの送信を挟む形で、永続的な配信義務台帳に記録されます。完成した回答の送信時に gateway がクラッシュしても、黙って失われることなく、次回起動時に再配信されます。⁵⁶ ルーティングされた profile 間の分離は v0.21.2 でさらに強化され、この多重化構成で発生していた一連の profile 間漏洩が解消されました。具体的には、許可リストの継承、デフォルト profile のホストへの認証情報送信、デフォルト profile の vault シークレットが stdio MCP サーバーへ渡る問題、profile をまたぐ MEDIA: 添付ファイル、兄弟 profile の Nous bearer がプロセス単位のメモに残る問題です（#107609-#107630）。⁴⁸

v0.21.1 では、会話の境界は明示的な操作によってのみ作られるようになりました。 タグ v2026.9.7 のセッションライフサイクルドキュメントでは、その仕様を4つの文で説明しています。「非アクティブな時間や経過時間によって会話が切り替わることはありません。/new と /reset は明示的な境界を作成し、長い履歴は引き続きコンテキスト圧縮によって管理されます。従来のタイマー設定は無視されます。既存の SessionResetPolicy データ型は互換性のためだけに残された不活性なデータであり、ランタイムポリシーではありません。」明示的な一時停止では、次の受信ターンで引き続き境界が作られます。復旧時には確定済みの境界が尊重され、再び開かれることはありません。また、リソースのみの退避後も会話は再開可能です。gateway のセッションが「いつまでも期限切れにならない」ように見える場合、それが現在の仕様です。切り替えるには /new を実行してください。⁴³

v0.21.4 の期間以降、2つ目の hermes gateway run は二重にバインドせず、既存プロセスへ接続するか起動を拒否します。 ルールとして、OS ユーザーごと、ホストごとに hermes serve と hermes gateway run をそれぞれ1つだけ実行し、各プロセスがすべての profile を多重化します。実行中の multiplexer がすでに提供している profile に対して gateway を起動すると、そのプロセスへ接続して終了コード 0 で終了します。まだその profile を提供していない場合は、Hermes が profiles/ の再スキャンを要求し、提供が始まると接続します。その profile を提供できない場合は、2つ目の gateway を黙って起動せず、コマンドを拒否します。--replace は、どの profile が起動したかにかかわらず、そのホストプロセスを対象とするようになりました。所有プロセスが応答しない場合、--force を指定すると確認を完全に省略できます。スタンドアロン gateway は引き続き共存できます。実行中の gateway が別 profile のスタンドアロン（非多重化）gateway であれば、これまでどおり自分の profile 用 gateway がその隣で起動します。この動作は移行が強制されるまで続きます（#109417）。2つの gateway が同時に起動した場合、ホストロックを獲得できなかった方は終了コード 75 で終了し、Hermes が生成するすべての supervisor が再試行します。その時点では勝者のレコードがすでに存在するため、再試行は前述のルールに従って接続するか拒否されます。ロックとランデブーレコードは $HERMES_GATEWAY_LOCK_DIR に保存されます。未設定の場合は $XDG_STATE_HOME/hermes/gateway-locks（デフォルトは ~/.local/state/hermes/gateway-locks）が使われ、OS ユーザー単位で分離されます。PID のプロセスが終了している、または別のプロセスに再利用されているレコードは古いものとして無視されるため、gateway がクラッシュしても次回の起動は妨げられません。Desktop アプリも同じルールに従い、2つ目のホストバックエンドを起動せず、実行中のものへ接続します。⁵¹

v0.21.5 以降、多重化は任意ではなくなりました。 gateway.multiplex_profiles に指定できる有効な値は true だけです。キーが未設定なら有効として解決され、デフォルト profile の config.yaml に書き込まれます。明示的な false はその場で true に書き換えられ、その gateway の起動時に1回限りの枠付き通知が表示されるほか、次回の hermes update の概要にも再度表示されます。従来のオプトアウトに代わって、2つの制御方法が用意されています。他のユーザーの bot を停止せず、1つの profile だけをオフラインにするには、hermes -p <name> gateway stop を実行します。ホストはその profile を待機状態にし（profiles/<name>/gateway.parked マーカーを作成します）、hermes -p <name> gateway start で待機状態を解除できます。ダッシュボードと Desktop の Stop/Start ボタンも同じ操作を行います。名前付き profile で引き続き専用 gateway が必要な場合は、自身の config.yaml に gateway.standalone: true を設定します。ホストはその profile を一切提供せず、stop/start は専用プロセスに対して機能します。ドキュメントでは、このキーをサポート対象のトポロジーではなく「一時的な互換性 shim」と説明しており、デフォルト profile に設定すると警告とともに無視されます。OS ユーザーをまたいで分割する場合や、デフォルトホームの profiles/ 外に HERMES_HOME を置く場合は、引き続き --force が必要です。⁵³

ユーザー認証とペアリング

hermes pairing list                    # Show pending and approved users
hermes pairing approve <platform> <code>
hermes pairing revoke <platform> <user-id>
hermes pairing clear-pending

ペアリングコードによって、不特定の第三者が gateway と会話するのを防げます。ユーザーがメッセージングプラットフォームからペアリングコードを送信し、hermes pairing approve で承認すると、それ以降は認証済みとなります。⁶

unauthorized_dm_behavior は、ペアリング前に第三者から届いた DM をどう扱うか決定します。pair はペアリングコードを DM で送信し、ignore はメッセージを無言で破棄します。v0.21.4 の期間に追加された decline は、丁寧な拒否メッセージを1回だけ送り、その後24時間は同じ送信者に何も返信しません（#88028）。拒否メッセージは、別名をまたいでプラットフォームおよび送信者ごとに重複排除されます。文面は unauthorized_dm_decline_message（グローバルキー）から取得され、空の場合は組み込みの返信「こんにちは！私は個人用アシスタントのため、所有者とのみチャットできます。直接お手伝いすることはできません。申し訳ありません！」が使われます。この動作はグローバルに設定するか、セットアップウィザードが書き込むプラットフォーム単位で設定します。

# ~/.hermes/config.yaml
unauthorized_dm_behavior: decline      # global; gateway.unauthorized_dm_behavior also works
unauthorized_dm_decline_message: ""    # empty = built-in reply
platforms:
  telegram:
    unauthorized_dm_behavior: pair     # per-platform value always wins

何も設定されていない場合、実際のデフォルト値は許可リストによって変わります。許可リストが1つも設定されていなければ pair です。いずれかの許可リスト（GATEWAY_ALLOWED_USERS、またはプラットフォームの許可ユーザー、グループ許可ユーザー、グループ許可チャット変数）が設定されると ignore になります。許可リストは gateway が意図的に制限されていることを示すため、不明な連絡先へコードを送るのは煩わしく、情報漏洩につながる可能性もあるためです（#9337）。グローバルな ignore または decline はこのルールを上書きしますが、グローバルな pair はデフォルト値と区別できないため上書きできません。許可リストとペアリングを併用するには、プラットフォーム単位で pair を設定してください。（プラットフォームアダプター独自の dm_policy が設定されている場合は、許可リストのルールより先に参照されます。）メールは受信トレイを前提としているため、プラットフォーム固有のキーで明示的に有効化しない限り、デフォルトは ignore です。グローバル値はメールには適用されません。hermes gateway setup では、許可リストなしでプラットフォームを設定する際の選択肢として decline が提示されます。⁵¹

スケジュール済みタスク（Cron）

Hermes には、シェルコマンドではなくエージェントタスクをジョブとして扱う本格的な cron システムがあります。各スケジュール済みジョブは、設定されたプロンプトと任意で添付された skill を使って新しい AIAgent で実行され、任意のプラットフォームに結果を配信します。³⁶

hermes cron list
hermes cron create --prompt "Check HN for AI news and summarize" --schedule "0 9 * * *" --deliver telegram
hermes cron edit <id>
hermes cron pause <id>
hermes cron resume <id>
hermes cron run <id>         # Trigger now on the next tick
hermes cron remove <id>
hermes cron status           # Check if scheduler is running
hermes cron tick             # Run due jobs once and exit

メッセージングチャット内で会話形式により作成することもできます。

Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

エージェントがツールを使って cron ジョブを設定します。ジョブは JSON に永続化され、再起動後も保持されます。³

v0.21.0 では、スケジュール済みジョブに記憶と判断力が加わりました。 以下の4つの仕組みは、すべてタグ v2026.8.31 で検証済みです。³⁵³⁷

• 継続性。 continuity=true を設定すると、ジョブが直前に出力した自身の結果が実行のたびに注入されます。これにより、調査や監視を行うジョブは「前回の報告内容を確認してから起動し、重複を避けつつ続きから作業」できます。注入される指示は「すでに報告した内容を繰り返さない」ことであり、初回実行には影響しません。内部では、このフラグは context_from の予約済み self エントリとして保存されます。hermes cron create ... --continuity で有効にし、hermes cron edit <job_id> --continuity / --no-continuity で切り替えられます。³⁷
• 永続的なメモ帳。 各ジョブには、カーソル、ウォーターマーク、ウォッチリスト用の小さな KV スクラッチパッドが割り当てられます（値ごとに16 KB、ジョブごとに64 KBです。実行のたびにプロンプトへ注入されるため、上限は意図的に設けられています）。hermes cron notepad <job_id> set <key> <value> で書き込み、実行中のエージェントがターミナルツールを通じて呼び出します。³⁷
• 監視モード。 ジョブには、低コストの monitor_script/monitor_url ソースを追加でき、各ティックの最初に実行されます。出力が変化していない場合（完全なバイト列として比較）、エージェントの実行は全面的に抑止されます。つまり、LLM 呼び出しも配信も行わず、no_change として静かに終了します。変化がある場合は diff ブロックを注入し、通常どおりエージェントを実行します。監視スクリプトの出力は安定させてください。そうしないと、ティックのたびに変化したと判定されます。³⁷
• ジョブ単位の推論強度と Bot Chat への配信。 --reasoning-effort では、ジョブの思考レベル（none から ultra まで）を固定でき、そのジョブの実行についてグローバル設定とモデル単位の設定を上書きします。また、deliver=bot-chat を指定すると、出力が実際の受信メッセージとして profile の標準 Bot Chat セッションに届きます。人間がチャンネルを読むだけではなく、ボットが「必要な対応を実行し、チャット内で応答」します。³⁷

MCP 連携

Hermes は、Model Context Protocol のクライアントとサーバーの両方に対応しています。⁶

クライアントとして — Hermes を外部の MCP サーバーに接続し、利用できるツールを拡張します。

hermes mcp add <name> --url https://example.com/mcp
hermes mcp add <name> --command npx --args "-y,@modelcontextprotocol/server-github"
hermes mcp list
hermes mcp test <name>
hermes mcp remove <name>
hermes mcp configure <name>   # Toggle individual tool selection
hermes mcp login <name>       # Force re-auth for an OAuth server (--flow browser|device)
hermes mcp reauth [--all]     # Re-authenticate one OAuth server, or every one

または、config.yaml で手動設定します。¹⁴

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

v0.19.0 以降、MCP ツールは mcp__server__tool という命名規則でモデルに公開されます。すべてのツール名にサーバー名が含まれるため、同じツールを公開するサーバーが複数あっても衝突しません。また、MCP サーバーのログ通知が agent.log に記録されるようになりました。⁵⁶

v0.21.1 では、MCP OAuth にデバイスコード方式が追加されました。hermes mcp login <name> では --flow {browser,device} を指定できます。browser は従来の PKCE フロー、device はヘッドレス環境やリモートマシン向けの RFC 8628 デバイスコードログインです。このフラグは、サーバーの oauth.flow 設定を上書きします。同じリリースでは、OAuth セッション全体で profile の所有権が適用され、不正な形式の OAuth メタデータキャッシュがあってもサーバーを停止させずに無視するようになりました。さらに、デスクトップの MCP OAuth はクライアントローカルのコールバックを介して中継されます。-t/--toolsets では、起動する設定済み MCP サーバーも絞り込めるようになったため、対象を限定した呼び出しでは不要なサーバーのコールドスタートを省略できます。⁴⁴

v0.21.0 では、デスクトップの MCP 機能がコマンドセンターへと進化しました。サーバーとカタログが1つのページに統合され、ドラッグ操作による「何でも貼り付け」インポート、ツール呼び出しが失敗する前に期限切れ間近の認証を知らせるバックグラウンド健全性チェック、スキーマのトークン推定値とサーバーごとの30日間の使用量を表示するフリート全体のコスト／使用量オーバーレイ、明示的な確認を経て MCP サーバーをインストールする hermes:// ディープリンクが追加されました。³⁵

v0.21.4 の期間には、mcp.discovery_concurrency（デフォルトは4、0 は無制限、#117373）が追加されました。これは、検出処理で同時に接続する設定済み MCP サーバー数の上限です。すべてのサーバーには引き続き接続しますが、この上限によって接続が一斉に集中するのを防ぎます。整数以外または負の値を指定すると警告がログに記録され、デフォルト値にフォールバックします。⁵¹

サーバーとして — Hermes の会話をほかのエージェントに公開します。

hermes mcp serve
hermes mcp serve -v    # Verbose

コンテキスト圧縮

Hermes は、モデルのコンテキストウィンドウ内に収まるよう、長い会話を自動的に圧縮します。圧縮用の要約処理は独立した LLM 呼び出しであり、任意のプロバイダーやエンドポイントを指定できます。⁴ v0.20.6 以降、保持する末尾部分のポリシーはデフォルトで lean（compression.tail_mode: lean）です。また、このタグでは要約モデル、プロバイダー、エンドポイントの設定項目が、以前の compression.summary_* ではなく auxiliary.compression.* に配置されています。従来のキーは初回読み込み時に自動移行されます（設定バージョン17）。³⁰³¹

compression:
  enabled: true
  threshold: 0.50          # Compress at this % of context limit
  threshold_tokens: null   # Optional absolute token cap -- trigger fires at the lower of ratio vs cap
  target_ratio: 0.20       # Fraction of threshold to preserve as recent tail (legacy tail mode)
  tail_mode: lean          # Tail retention: "lean" (default) or "legacy"
  protect_last_n: 20       # Min recent messages to keep uncompressed
  protect_first_n: 3       # Non-system head messages pinned across compactions

auxiliary:
  compression:
    model: ""              # Empty = main chat model; e.g. "google/gemini-3-flash-preview"
    provider: "auto"       # "auto", "openrouter", "nous", "codex", "main", etc.
    base_url: null         # Custom OpenAI-compatible endpoint (overrides provider)

tail_mode で決まること。 legacy は、target_ratio に応じたサイズの末尾部分をそのまま保持します。コンテキストウィンドウが大きい場合やしきい値を引き上げた環境では、圧縮のたびに100～240Kトークンを抱え込むことになります。lean がそのまま保持する末尾部分は、コンテキストウィンドウの2.5%に制限されます（下限10K、上限25K）。代わりに、圧縮対象領域について識別子を維持した詳細なセッションログ（試行ごとに補助要約処理を1回呼び出します）、機械的に抽出されたアンカーインデックス（PR 番号、SHA、パス、エラー文字列などを正規表現で抽出し、決して言い換えません）、実際のユーザーメッセージすべての逐語的な引用、要約によって省かれた内容へエージェントが再アクセスするための session_search 復元ポインターを要約に含め、継続性を保ちます。ドキュメントに記載された500Kトークンの実際のセッションでの測定結果では、保持されるトークン数が約162Kから約49Kに減少しました。lean の末尾部分に含まれる古いツール結果は、復元ポインター付きの1行スタブに簡略化されます。不明な tail_mode 値は lean にフォールバックします。³¹

プロバイダーの選択肢：⁴³¹

要約モデルは会話の中間部分全体を1回の呼び出しで受け取るため、メインモデルと同等以上のコンテキスト長に対応している必要があります。ウィンドウが小さい場合は呼び出しが失敗し、中間部分のターンが要約されないまま破棄されます。⁴³¹

バジェット逼迫の警告

エージェントが多数のツール呼び出しを伴う複雑なタスクに取り組むと、気づかないうちに反復バジェットを使い切ることがあります（v0.20.0 以降のデフォルトは、従来の90ターンから増えた500ターンです）。バジェットが逼迫すると、モデルへ自動的に警告します。⁴

ストリームのタイムアウト

LLM のストリーミング接続には2段階のタイムアウトがあり、ローカルプロバイダー（localhost、LAN IP）では自動調整されます。⁴

ローカルの LLM では、大きなコンテキストのプリフィルに数分かかり、最初のトークンが生成されるまで時間を要することがあります。そのため、ローカルエンドポイントではソケット読み取りタイムアウトが30分に延長されます。⁴

ローカル Web ダッシュボード（v0.9.0以降）

Hermes Agent をローカルで管理するためのブラウザベースのダッシュボードです。設定の変更、セッションの監視、skill の閲覧、gateway の管理を、設定ファイルやターミナルに触れずに行えます。¹⁶ hermes dashboard で起動します。GUI を好む新規ユーザーにとって、最も簡単に使い始められる方法です。

バックグラウンドプロセスの監視（v0.9.0以降）

watch_patternsでは、バックグラウンドプロセスの出力を監視するパターンを設定し、一致した際にリアルタイムで通知を受け取れます。¹⁶ エラーの検出、特定のイベント（「ポートで待機中」など）の待機、ビルドログの監視を、ポーリングなしで行えます。v0.8.0で導入されたnotify_on_complete（バックグラウンドタスクの完了時に通知する機能）と組み合わせることで、Hermesはバックグラウンドプロセスを包括的に可観測化できるようになりました。¹⁵

プラガブルなcontext engine（v0.9.0以降）

hermes pluginsにより、コンテキスト管理が交換可能なスロットになりました。各ターンでエージェントに提示する内容を制御する独自のcontext engineへ差し替え、フィルタリング、要約、ドメイン固有のコンテキスト注入を行えます。¹⁶ これにより、コンテキスト戦略がエージェントのコアループから切り離され、プロジェクトやドメインごとにカスタマイズできます。

バックアップと復元（v0.9.0以降）

hermes backupは、設定、セッション、skills、メモリを含む完全なアーカイブを作成します。hermes importを使うと、バックアップアーカイブから復元できます。¹⁶ マシン間の移行、大規模な変更前のスナップショット作成、動作確認済みの設定をチームメンバーと共有する場合に便利です。

Termux / Android対応（v0.9.0以降）

HermesはTermuxを通じてAndroid上でネイティブに動作します。インストール先の調整、モバイル画面向けのTUI最適化、音声バックエンドのサポート、/imageコマンドにより、端末上で利用できます。¹⁶

セキュリティ強化（v0.13.0以降）

v0.13.0では8件のP0セキュリティ問題を解消し、1つのデフォルト設定をユーザーにとって安全な方向へ変更しました。¹⁸ 続くv0.14.0では、さらに12件のP0と50件のP1を解消しています。これには、sudoのブルートフォース攻撃およびsudo-stdinへの対策、危険なコマンドの制限を回避する手法の修正、モデルへ再注入する前のツールエラーのサニタイズ、ダッシュボードプラグインのAPI認証、skills-hubのSSRF対策範囲の拡大、インストール時のサプライチェーン脆弱性情報スキャンが含まれます。¹⁹

Hermes環境を運用している場合、v0.13.0とv0.14.0は単なる機能追加ではなく、セキュリティ上重要なアップグレードとして扱ってください。v0.13.0ではDiscordのギルド横断バイパスと2つのTOCTOUウィンドウが解消されています。v0.14.0では、sudoの処理、ツールエラーの再注入、プラグインのAPI、skills-hubのSSRF、依存関係の脆弱性情報に対し、さらにセキュリティ強化が施されています。

v0.21.0では、第4弾のセキュリティ強化が加わりました。 保護対象のエージェント指示ファイル（AGENTS.md、CLAUDE.md、SOUL.md、.cursorrules、skills、メモリストア）への書き込みには常に承認が必要となり、プロンプトインジェクションを受けたエージェントが自らの恒常的な指示をひそかに書き換えることはできなくなりました。このゲートはデフォルトで有効です（security.protected_instruction_files: true。protected_instruction_extra_patternsにはfnmatch形式でベース名の追加パターンを指定できます）。ソースでは、これによって防ぐ攻撃経路を「AGENTS.md / CLAUDE.md / SOUL.mdを編集する、注入された指示」と明記しています。さらに、指示ファイルはcwdのディレクトリツリーから読み込まれるため、「後からエージェントが実行される可能性のある場所に存在するAGENTS.mdは、どれも攻撃対象になり得る」と説明しています。³⁵³⁹ 同じリリースでは、ターミナルエラー、.envファイルの読み取り、checkpoints、ACPログからシークレットが漏れる問題も解消されました。また、承認システムがWindowsの破壊的なコマンドとパスを認識するようになり、安定したTCC署名IDによってmacOSの権限付与がアップデート後も維持されるようになっています（1回限りの設定：hermes desktop --setup-tcc-identity。macOS限定で、openssl/security/codesignが必要です）。さらに、上流での侵害を受けてBlenderのMCPカタログ項目とskillが削除され、プラグインのインストールにTier-1セキュリティスキャンが追加されました。³⁵³⁹

実践者向けアーキテクチャ

このセクションは、内部で何が起きているのかを理解し、デバッグ、拡張、パフォーマンスの分析に役立てたい方を対象としています。上流のアーキテクチャドキュメントを総合した内容です。³

エントリーポイント → AIAgent

Hermesのすべてのエントリーポイントは、最終的にAIAgent.run_conversation()を呼び出します。

┌──────────────────────────────────────────────────────────────────┐
│                        Entry Points                              │
│                                                                  │
│  CLI (cli.py)    Gateway (gateway/run.py)    ACP (acp_adapter/)  │
│  Batch Runner    API Server                  Python Library     │
└──────────┬──────────────┬───────────────────────┬────────────────┘
           │              │                       │
           ▼              ▼                       ▼
┌──────────────────────────────────────────────────────────────────┐
│                     AIAgent (run_agent.py)                       │
│                                                                  │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────┐             │
│  │ Prompt      │  │ Provider     │  │ Tool         │             │
│  │ Builder     │  │ Resolution   │  │ Dispatch     │             │
│  └──────┬──────┘  └──────┬───────┘  └──────┬───────┘             │
│         │                │                 │                    │
│  ┌──────┴───────┐ ┌──────┴───────┐  ┌──────┴───────┐             │
│  │ Compression  │ │ 3 API Modes  │  │ Tool Registry│             │
│  │ & Caching    │ │ chat_compl   │  │ 47 tools     │             │
│  │              │ │ codex_resp   │  │ 20 toolsets  │             │
│  │              │ │ anthropic    │  │              │             │
│  └──────────────┘ └──────────────┘  └──────────────┘             │
└──────────────────────────────────────────────────────────────────┘

上流のアーキテクチャドキュメントをもとにした図です。³

バナーに表示される「28 tools」に対して「47 tools / 20 toolsets」となる理由。 「47 tools」は、上流リポジトリに登録されたツールの総数です。つまり、Hermesがソースコードを提供している、全toolsetの全ツールを指します。実際に稼働しているCLIでは、起動時のバナーにこれより少ない数が表示されます（このガイドの検証に使用した環境では28 tools / 89 skillsと表示されます）。これはバグではありません。多くのtoolsetはオプトイン方式であり、config.yamlのtoolsets:で明示的に有効化する必要があります。たとえば、メッセージングプラットフォームのアダプター、ブラウザ自動化、高負荷なスクレイピングツールなどです。レジストリの総数は「利用可能なもの」、バナーの数は「現在のprofileで有効なもの」を表します。有効なtoolsetはhermes tools --listで確認でき、~/.hermes/config.yamlのtoolsets:ブロックで個別に有効化または無効化できます（実行中のセッション内では/tools list、/tools enable <name>、/tools disable <name>も使用できます。ツールを削除すると、エージェントがツールマニフェストを再構築するため、セッションがリセットされます）。

3つのAPIモード

Hermesはプロバイダー間の違いを3つのAPIモードに抽象化し、実行時に自動で選択します。³

runtime_provider.pyのリゾルバーは、18以上のプロバイダーについて、(provider, model)タプルを(api_mode, api_key, base_url)へマッピングします。OAuthフロー、認証情報プール、エイリアス解決もここで処理されます。³

CLIセッション内のデータフロー

User input → HermesCLI.process_input()
  → AIAgent.run_conversation()
    → agent.prompt_builder.build_system_prompt()
    → runtime_provider.resolve_runtime_provider()
    → API call (chat_completions / codex_responses / anthropic_messages)
    → tool_calls? → model_tools.handle_function_call() → loop
    → final response → display → save to SessionDB

上流のアーキテクチャページより。³

プロンプトの組み立て順序

プロンプトスタックには、次の要素が含まれます。¹³

1. SOUL.md（エージェントのアイデンティティ。利用できない場合は組み込みのフォールバック）
2. ツールを考慮した動作ガイダンス
3. メモリ／ユーザーコンテキスト（MEMORY.md、USER.md）
4. skillsのガイダンス
5. コンテキストファイル（AGENTS.md、.cursorrules）
6. タイムスタンプ
7. プラットフォーム固有の書式設定ヒント
8. /personalityなど、任意のシステムプロンプトオーバーレイ

SOUL.mdが基盤となり、ほかのすべての要素はその上に構築されます。¹³

セッションストレージ

SQLiteベースのセッションストレージで、FTS5全文検索に対応しています。セッションには系統追跡（圧縮をまたぐ親子関係）、プラットフォームごとの分離、競合処理を伴うアトミック書き込みが備わっています。³

v0.21.x環境でストレージに問題が発生する場合は、v0.21.2以降を使用してください。このバージョンでは、v0.21.0当時のstate.dbに関する一連の脆弱性（2つ目の書き込み処理が互いのロックを解除する、正常なデータベースが破損と報告される、1件の不正な行によってsessions list全体が失敗する）が解消されました。また、ホストされたルームの連携処理がルートストレージから専用のshared-state.dbへ移され、profile gatewayがマスターセッションストレージを編集可能な状態で開くこともなくなりました。現在のhermes doctorは構造的な破損とFTSインデックスの破損を個別に示します。FTSが破損してもターン全体は失敗せず、検索機能のみが縮退します。さらに、hermes sessions recover --inspect-only（オフライン、非破壊、profile固定）は、出力データベースを作成せずに正規テーブルを読み取れるか報告します。このサブコマンド自体は以前から存在していましたが、ここではまだ説明していませんでした。v0.21.2の新機能をご覧ください。⁴⁸ SQLiteのジャーナルモードが誤った状態で固定されたストレージに対しては、v0.21.4の期間にオフライン変換ツールhermes sessions set-journal-mode delete|walが追加されました（トップレベルコマンドのhermes sessionsの行をご覧ください）。⁵¹

プラグインシステム

検出元は、~/.hermes/plugins/（ユーザー）、.hermes/plugins/（プロジェクト）、pipエントリーポイントの3つです。プラグインは、コンテキストAPIを通じてツール、フック、CLIコマンドを登録します。メモリプロバイダーは、plugins/memory/以下に配置される特殊なプラグインタイプです。³ v0.21.2以降では、厳選され、SHAで固定されたプラグインカタログも用意されており、名前で参照してインストールできます。また、「宣言的で共有可能なプラグインセット」を作成するhermes plugins packも追加されました。1つのhermes-pack.yamlでプラグインセットを正確なコミットSHAに固定し、packのインストール時には通常の固定インストールへ展開されます。機能への同意はプラグインごとに維持されます。⁴⁸

v0.21.4の期間には、そのカタログがCLIの画面から、配布される成果物へと発展しました。リポジトリのplugin-catalog/ディレクトリは、v2026.9.14時点の9エントリからv2026.9.21時点の228エントリへ増加しました。プラグインごとにレビュー済みのYAML（名前、リポジトリ、メンテナー、階層、カテゴリー、機能）が1つ用意され、正確な40文字のコミットSHAに固定されています。このディレクトリに存在すること自体が登録を意味します。データはCLI向けのplugin-catalog.jsonとして公開され、ライブで取得された後、~/.hermes/cache/以下にキャッシュされます。ドキュメントサイトでは、同じデータからプラグインごとのページ（/docs/plugins/<name>）と作者ごとのページ（/docs/plugins/by/<slug>）が生成されるようになりました。各ページには、ブランチの先端ではなく、固定されたコミットから取得したプラグインのREADMEが表示されます。表示には、生のHTMLを除外するビルド時の許可リストが使用され、追加日／更新日による並べ替えにはコミッターの日付が付与されます。v0.21.4リリースで挙げられた10個のコミュニティプラグインは、いずれもリリースタグ時点でカタログに登録されています。実際のカタログslugは、hermes-tailscale、hermes-ssh、shodan、hermes-terminal、hermes-rss（これとは別にrss-readerもあります）、hermes-resetwatch、done-bell、kiwi、cognee、web-octenです。デスクトップのPluginsハブでは、確認ダイアログを経てプラグインをアンインストールできるようになりました。カタログのプラグインはplugins.manage remove、スタンドアロンのデスクトッププラグインはElectronローダーを通じて処理されます。⁵¹

hermes plugins                       # Interactive enable/disable UI
hermes plugins browse                # List every curated plugin catalog entry (v0.21.2+)
hermes plugins search <query>        # Search the curated plugin catalog (v0.21.2+)
hermes plugins install <name|repo>   # Install from the curated catalog, a Git URL, or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list
hermes plugins pack install <src>    # Shareable SHA-pinned plugin sets; also: pack export, pack show (v0.21.2+)

互換期間（v0.21.1）は終了しました。外部プラグインは、2026年9月14日までに分割前のインポートパスから移行する必要がありました。 2026年9月の分割（PR #102117）では、プラグインが頻繁にインポートしていた内部要素が移動しました。一時的なCOMPAT_MANIFEST.mdレイヤーにより、移動した1,148個の公開名が旧モジュールから再エクスポートされ、プロセスごと、名前ごとに1回だけ警告（HermesPluginCompatWarning）が表示されていました。削除は予定どおり2026年9月14日に実施されました。配布コード内の日付ゲート（hermes_cli/plugin_compat.pyのCOMPAT_REMOVAL_DATE）によるもので、コードのrevertは不要でした。この日以降、該当するプラグインは読み込まれず、無効化されます。CLIバナー、hermes doctor、hermes updateには赤い通知が表示され、デスクトップでは1回限りのモーダルが表示されます。無効化の理由はhermes plugins listでも確認できます。作者向けには、hermes plugins compat <path>を実行すると、古いパスが残っている間、旧パス -> 新パスを含むすべてのfile:lineが引き続き出力され、終了コード1で終了します（機械可読形式で出力するには--jsonを追加します）。メンテナンスされていないプラグインを使い続けざるを得ない場合は、config.yamlでplugins.allow_deprecated_imports: trueを設定できます。値は引用符付きの文字列ではなく、リテラルのYAMLブール値でなければなりません。旧パスを削除するrevertがまだ適用されていないため、この回避策は現在も機能します。マニフェストとshimは、v2026.9.14、v2026.9.21、v2026.9.24、および9月24日時点のmainに存在します（v0.21.4の期間に互換モジュールへ加えられた変更は、プラグインスキャンのキャッシュとWindowsパスの正規化だけです。v0.21.5の期間にはhermes_cli/plugin_compat.pyは変更されず、削除されたHindsightモジュールのマニフェストエントリだけが除去されました）。そのrevertが適用されて旧パス自体が消えた時点で、この回避策は機能しなくなります。対象となったのは公開されたトップレベル名だけです。非公開名とテスト用のmonkeypatch接合部は、もともと公開インターフェースではなく、復元もされません。⁴²⁵³

デザイン原則

上流のアーキテクチャページより。³

OpenClaw からの移行

Hermes Agent は OpenClaw の後継です。既存の OpenClaw 環境から移行する場合は、次を実行します。⁶⁵

hermes claw migrate --dry-run                    # Preview what would be migrated
hermes claw migrate --preset full                # Full migration including API keys
hermes claw migrate --preset user-data --overwrite   # User data only, no secrets
hermes claw migrate --source /custom/path        # Non-default OpenClaw location

hermes claw migrate はデフォルトで ~/.openclaw から読み込み（従来の ~/.clawdbot と ~/.moldbot ディレクトリも自動検出します）、~/.hermes に書き込みます。⁶

直接インポートされる項目（30以上のカテゴリ）：SOUL.md、MEMORY.md、USER.md、AGENTS.md、4つのソースディレクトリにある skills、デフォルトモデル、カスタムプロバイダー、MCP サーバー、メッセージングプラットフォームのトークンと許可リスト（Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost）、agent のデフォルト設定（推論の労力、圧縮、人間らしい応答遅延、タイムゾーン、サンドボックス）、セッションのリセットポリシー（現在は無効：v0.21.1以降、タイマーによって会話がローテーションされることはありません⁴³）、承認ルール、TTS 設定、ブラウザ設定、ツール設定、実行タイムアウト、コマンド許可リスト、gateway 設定、および3つのソースから取得される API キー。⁶

手動確認用にアーカイブされる項目： cron ジョブ、プラグイン、フック／webhook、メモリバックエンド（QMD）、skills レジストリ設定、UI／アイデンティティ、ログ、マルチ agent 設定、チャンネルのバインド、IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.md。⁶

API キーの解決では、設定値 → ~/.openclaw/.env → auth-profiles.json の優先順位で3つのソースを確認します。⁶

トラブルシューティング

「No inference provider configured. Run ‘hermes model’ to choose a provider and model」

新規インストールで最初に遭遇するエラーです。Hermes では、使用するプロバイダーがまだ決定されていません。メッセージのとおり、3つの認証経路のいずれからも利用可能なプロバイダーを取得できていない状態です。次を実行してください。

hermes model

対話形式の選択画面では、対応するすべてのプロバイダーを順に設定できます。Nous Portal、GitHub Copilot、Anthropic、OpenAI Codex の OAuth デバイスコードフローや、セルフホスト型サーバー用のカスタムエンドポイントも含まれます。すでにプロバイダーを設定したはずの場合は、hermes doctor を実行すると、Hermes が実際に認識できている認証情報を確認できます。よくある原因は、API キーを誤った場所に設定していること（シェルの profile ではなく、.env または hermes config set で設定する必要があります）、~/.hermes/auth.json 内の OAuth 認証情報の期限切れ、あるいは config.yaml のカスタムエンドポイントから base_url が失われていることです。認証経路については、認証とプロバイダーで詳しく説明しています。²⁷

「API key not set」

hermes model を実行して対話形式でプロバイダーを設定するか、hermes config set OPENROUTER_API_KEY your_key を実行してください。hermes doctor コマンドを使えば、不足しているキーを正確に確認できます。⁷

起動時に「Context limit: 2048 tokens」と表示される（ローカルモデル）

Hermes はサーバーの /v1/models エンドポイントからコンテキスト長を自動検出しますが、多くのローカルサーバーは小さなデフォルト値を返します。config.yaml で明示的に設定してください。²

model:
  default: your-model
  provider: custom
  base_url: http://localhost:11434/v1
  context_length: 32768

ツール呼び出しが実行されず、テキストとして表示される

サーバーでツール呼び出しが有効になっていないか、サーバー側の実装を通じたツール呼び出しをモデルがサポートしていません。²

応答が文の途中で途切れる

考えられる原因は2つあります。²

1. サーバー側の出力上限が低い（max_tokens）— SGLang のデフォルトは応答ごとに128トークンです。サーバーで --default-max-tokens を設定するか、config.yaml の model.max_tokens を設定してください。
2. コンテキストの枯渇 — モデルがコンテキストウィンドウを使い切っています。model.context_length を増やすか、Hermes でコンテキスト圧縮を有効にしてください。

WSL2 から Windows 上のモデルサーバーに接続すると「Connection refused」になる

WSL2 は独自のサブネットを持つ仮想ネットワークアダプターを使用します。そのため、WSL2 内の localhost は Windows ホストではなく Linux VM を指します。対処方法は2つあります。²

ミラーリングモードのネットワーク（Windows 11 22H2以降）：%USERPROFILE%\.wslconfig を編集します。

[wsl2]
networkingMode=mirrored

その後、wsl --shutdown を実行して再起動してください。これで localhost を双方向に利用できます。

ホスト IP を使う代替方法（古い Windows）：WSL2 内から Windows ホストの IP を取得し、localhost の代わりに使用します。

ip route show | grep -i default | awk '{ print $3 }'
# Use that IP as the base_url host

さらに、モデルサーバーを 127.0.0.1 ではなく 0.0.0.0 にバインドする必要があります。Ollama では OLLAMA_HOST=0.0.0.0 を設定し、llama-server／SGLang では --host 0.0.0.0 を追加します。LM Studio では「Serve on Network」を有効にしてください。²

反復回数の上限に agent.max_turns が反映されない

config.yaml に agent.max_turns: 500 と記載されているのに、アクティビティ行に N/90（または別の古い上限値）と表示される場合は、~/.hermes/.env に古い HERMES_MAX_ITERATIONS 行が残っている可能性があります。以前のセットアップウィザードは上限値を両方の保存先に書き込んでいました。起動時のブリッジ処理が先行する設定解析エラーによって中断されると、.env に残った値が気付かれないまま優先されます。v0.21.1以降では、hermes doctor がこの重複設定を検出し、hermes doctor --fix を実行すると .env の行を削除して、config.yaml を唯一の正式な設定元にします。⁴¹

各種ファイルはどこにある？

この場合は hermes status と hermes dump が役立ちます。hermes logs list を実行すると、すべてのログファイルとそのサイズが表示されます。hermes config path は設定ファイルの場所を、hermes config env-path は .env の場所を表示します。⁶

FAQ

Hermes AgentとClaude Codeの違いは何ですか？

Claude CodeはAnthropic公式のCLIで、利用できるのはAnthropicモデルに限定されています。Hermes AgentはNous Researchによるオープンソースのエージェントフレームワークで、OpenAI互換のプロバイダーであれば、Nous Portal、OpenRouter、Anthropic、GitHub Copilot、z.ai、Kimi、MiniMax、DeepSeek、Hugging Face、Google、独自にホストするエンドポイントのいずれでも動作します。¹² また、HermesにはTelegram/Discord/Slack/WhatsApp/Signal向けのメッセージングgatewayが付属していますが、Claude Codeにはありません。

AnthropicのAPIキーでHermesを利用できますか？

はい。方法は3つあります。²

1. ~/.hermes/.envにANTHROPIC_API_KEYを設定し、hermes chat --provider anthropic --model claude-sonnet-4-6を実行します
2. hermes modelを実行してAnthropicを選択します。利用可能な場合、HermesはClaude Codeの認証情報ストアを使用します
3. フォールバックとして、ANTHROPIC_TOKEN（setup-tokenまたはOAuth token）を手動で設定します

同じマシンですでにClaude Codeを利用している場合は、方法2がおすすめです。更新可能なClaude認証情報を、そのまま更新可能な状態に保てます。

会話を失わずにプロバイダーを切り替えるにはどうすればよいですか？

セッション内で/model provider:modelを使用します。会話履歴、メモリ、skillsはすべてそのまま引き継がれます。⁹

/model zai:glm-5
/model openrouter:anthropic/claude-sonnet-4
/model custom:local:qwen-2.5

Anthropicを設定しましたが、ビジョン／Web／圧縮が動作しません

現在のビルドでは、従来の原因でこの問題が起こることはほとんどありません。デフォルト（auxiliary.*.provider: "auto"）では、ビジョン、承認分類、圧縮、セッションタイトルなど、すべての補助タスクがメインのチャットモデルで実行されます。そのため、Anthropicのみを設定している場合でも、すでに用意されているOAuthでこれらを処理できます。従来のデフォルト（OpenRouter経由のGemini Flash → Nous → Codexの順に自動検出し、いずれも設定されていなければ通知なしで機能を縮退させる方式）は廃止されました。「現在、autoはすべてのユーザーに対してメインモデルを使用し、config.yamlのタスク別オーバーライドは引き続き優先されます」。³⁴

それでも補助タスクが失敗する場合は、設定していないプロバイダーを指すタスク別の明示的なオーバーライド（config.yaml内のauxiliary.<task>.provider / .model）や、古いレガシーキーが残っていないか確認してください。タグv2026.8.31以降、圧縮サマライザーはほかの補助スロットと同様にauxiliary.compression.providerで設定します。従来のcompression.summary_*キーは、そこへ自動的に移行されます（設定バージョン17）。³¹ Web抽出は、もはやLLMタスクではありません（「LLMは関与しません」）。そのため、現在のビルドでWeb要約に失敗しても、補助モデルの問題ではありません。³⁴ タスクでメインプロバイダーを明示的に使用するには、次のように固定します。

auxiliary:
  vision:      { provider: "main" }
  compression: { provider: "main" }

SOUL.mdとAGENTS.mdの違いは何ですか？

SOUL.mdはエージェントのアイデンティティを定義するファイルで、口調、スタイル、コミュニケーションのデフォルト設定を記述します。~/.hermes/SOUL.mdに配置され、どこでも適用されます。AGENTS.mdはプロジェクト固有のファイルで、アーキテクチャ、規約、コマンド、パスなどを記述し、プロジェクトディレクトリに配置します。¹³ どこでも適用したい内容はSOUL.mdに、特定のプロジェクトに属する内容はAGENTS.mdに記述してください。

複数のHermesインスタンスを並行して実行するにはどうすればよいですか？

profileを使用します。profileごとに個別のHERMES_HOME、設定、メモリ、セッション、gateway PIDが割り当てられます。⁶

hermes profile create work --clone
hermes profile use work                 # Sticky default
hermes -p work chat -q "..."            # One-off without switching
hermes profile alias work --name h-work # Wrapper script

HermesはローカルのLLMをサポートしていますか？

はい。カスタムエンドポイントを通じて利用できます。Hermesは、Ollama、vLLM、SGLang、llama.cpp/llama-server、LM Studio、LocalAI、Jan、独自のサーバーなど、OpenAI互換のサーバーであれば動作します。² サーバーごとの設定については、カスタムおよびセルフホスト型エンドポイントをご覧ください。

起動バナーに表示されるツール数が、このガイドに記載されたHermesのツール数より少ないのはなぜですか？

このガイドに記載した47ツール／20 toolsetsという数字は、アップストリームのアーキテクチャレジストリに基づくもので、Hermesが全toolsetを通じてソースコードを提供しているツールの総数です。実行中の環境では、起動時にデフォルトのtoolsetセットだけが有効になるため、バナーに表示される数はこれより少なくなります（このガイドで使用した参照環境では28ツールと表示されます）。多くのtoolsetはオプトインです。メッセージングgatewayアダプター、ブラウザ自動化、高機能なスクレイピングスタック、いくつかの専門的な統合機能は、読み込む前に~/.hermes/config.yamlのtoolsets:へ明示的に追加する必要があります。レジストリの合計は「有効にすれば利用できるもの」、バナーの合計は「現在のprofileで実際に読み込まれているもの」を表します。hermes tools --listを実行すると、有効なtoolsetと、利用可能だが無効になっているtoolsetを確認できます。実行中に個別のtoolsetを切り替えるには、/tools enable <name>と/tools disable <name>を使用します（無効化するとセッションがリセットされ、エージェントが変更後の構成でツールマニフェストを再構築します）。

プライマリプロバイダーに障害が発生した場合、Hermesはどのようにモデルをフォールバックしますか？

config.yamlでfallback_modelブロックを設定します。²

fallback_model:
  provider: openrouter
  model: anthropic/claude-sonnet-4

プライマリ側で障害（レート制限、サーバーエラー、認証エラー）が発生すると、Hermesは会話履歴を失うことなく、セッションの途中でフォールバックへ切り替えます。切り替えは1セッションにつき最大1回です。

エージェントは時間とともに自身のskillsを改善できますか？

はい。これがHermes Agentの「自己改善」にあたる部分です。エージェントはskill_manageツールを使ってskillsを作成、更新、削除できます。複雑なワークフローを解明すると、今後再利用できるよう、その手順をskillとして保存します。¹¹ エージェントがskillsを作成するのは、複雑なタスク（ツール呼び出しが5回以上）の完了後、エラーに遭遇して有効な手順を見つけたとき、進め方を修正されたとき、複雑なワークフローを発見したときです。

IDEとの統合機能はありますか？

はい。Hermesは、VS Code、Zed、JetBrains向けのACP（Agent Client Protocol）サーバーとして実行できます。⁶

pip install -e '.[acp]'
hermes acp

変更履歴