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、あるいは自前でホストしたendpointなど、OpenAI互換のあらゆるLLM providerで利用できます。¹²¹⁹ v0.14.0（2026年5月16日）では、Hermesにgrok-4.3の1Mコンテキストを備えたSuperGrok OAuth、OAuth provider向けのOpenAI互換ローカルproxy（hermes proxy）、ファーストクラスのx_search、PyPIインストール対応（v0.19.0で廃止済み。現在は1行インストーラーがサポートされています）、遅延依存関係インストール、LINEとSimpleX Chatを含む28のメッセージングプラットフォーム、/handoff、書き込み後のLSPセマンティック診断、統合されたvideo_generate、非Anthropic provider向けのcua-driver経由computer_use、ネイティブWindowsベータ、そして12件のP0／50件のP1クローズが追加されました。¹⁹ 多くの新規ユーザーにとって最も難しいのはprovider認証です。Hermesは約20のファーストクラスproviderに加え、カスタムendpointをサポートし、3種類の認証経路（.envのAPI key、hermes modelによるOAuth、またはconfig.yamlのカスタムendpoint）を備えています。まず学ぶべきなのは認証モデルです。以降のすべては、どのproviderが解決されるかに左右されます。

Hermes Agentは、チャットラッパーではなく完全なagent runtimeとして動作します。 ファイルシステムの読み取り、サンドボックス化されたbackendでのコマンド実行、ウェブのスクレイピング、subagentの起動、定期cron jobの実行を行い、単一のgateway processからTelegram/Discord/Slack/WhatsApp/Signal/Emailとやり取りし、経験に基づいて独自のskillを作成します。¹ CLI はrun_agent.pyの会話ループ上に構築されたterminal UIであり、gatewayはメッセージングプラットフォームからのメッセージを同じ会話ループへルーティングする長時間稼働processです。³

カジュアルなHermes利用と熟練したHermes利用の差は、5つのシステムを理解しているかにあります。 これらを習得すれば、Hermesは強力な力の増幅器になります。

1. Provider解決：認証フローがAPI呼び出しへどのように対応するか
2. 設定階層：config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. Tool + toolsetシステム：agentが実行できることと、プラットフォームごとの制限
4. Skillsシステム：agentが作成・進化させる手続き的メモリ
5. Gateway + cron + profiles：今いる場所だけでなく、普段利用する場所でHermesを動かすこと

重要なポイント

• Provider認証は1つではなく、3つの経路があります。 .envのAPI key、hermes model/hermes authによるOAuth、またはconfig.yamlのカスタムendpointです。馴染みのある経路ではなく、利用するproviderに合った経路を選んでください。
• Providerの切り替えは1コマンドで行えます。 hermes modelは、OAuth loginを含む対応providerを対話形式ですべて案内します。/model provider:modelを使えば、履歴を失わずにセッション中でも切り替えられます。²
• ユーザーが編集できる設定領域は2ファイルです。 ~/.hermes/config.yamlには設定、~/.hermes/.envにはsecretを保存します。auth.json、SOUL.md、MEMORY.md、skills/はHermes自身が管理します。SOUL.mdは手動で編集できますが、それ以外はagent自身が変更します。⁴
• HermesはOpenClawの後継です。 移行する場合、hermes claw migrateは30以上のstateカテゴリを自動的にインポートします。⁵
• サービス品質は補助modelに依存します。 Vision、ウェブ要約、圧縮、メモリflushはすべて別の補助LLMを利用します。デフォルトではGemini Flashが自動検出（OpenRouter → Nous → Codex）されます。いずれも設定されていない場合、補助slotをメインproviderに向けるまで、これらの機能は目立たない形で劣化します。⁴

v0.14での変更点

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

• インストールと起動が軽量になりました。 pip install hermes-agentはPyPIから利用でき、重いadapterは初回利用時に遅延インストールされ、起動パスでは十分な処理が後回しになるため、コールドスタートを約19秒短縮できます。（v0.19.0ではpipインストールは廃止されました。詳細はInstallationをご覧ください。）
• SubscriptionをローカルAPI endpointにできます。 hermes proxyは、Claude Pro、ChatGPT Pro、SuperGrokなどのOAuthベースproviderを、Codex、Aider、Cline、Continueといったツール向けのOpenAI互換ローカルendpointへ変換します。
• Gatewayの対応範囲が広がります。 LINEとSimpleX Chatによりプラットフォーム数は22に増え、Microsoft Teamsはエンドツーエンドで接続され、Discordの履歴バックフィルはデフォルトで有効になり、Telegram/Discordのclarify promptではネイティブbuttonを利用できるようになりました。
• 書き込み時の検証が向上します。 編集後、Hermesはターンごとのファイル変更要約とlanguage serverのセマンティック診断を次のターン前に表示できます。これにより、evidence-drivenなagent作業により近づきます。
• デスクトップおよびメディアツールが拡張されます。 computer_useは非Anthropic providerでもcua-driver経由で利用でき、video_generateはプラグ可能なbackendの背後で統合され、vision_analyzeは実際に視認できるmodelへ生のpixelを送信します。

以下の各セクションは、hermes-agent.nousresearch.com/docsのupstream documentationと、github.com/NousResearch/hermes-agentのsource treeに基づいています。すべての事実に関する主張には、出典となる具体的なupstream pageへのfootnoteが付いています。

目的別の案内

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

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

1. prompt_builder.py を介して、SOUL.md、MEMORY.md、USER.md、skill、コンテキストファイル、ツールのガイダンスからシステムプロンプトを構築します³
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 に永続化します³

このループを理解することが重要なのは、パーソナリティ、メモリ、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.20.0（The Herald Release）の新機能

Hermes Agent v0.20.0（タグ v2026.8.3、2026年8月3日）は現在の機能リリースです。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.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つのコマンドで移行できます。²⁴
• シークレット管理機能の追加。 あらゆる保管庫と組み合わせられるコマンドヘルパー型のシークレットソース、起動時に具体的なエラーを提示するワンコマンドのトークンローテーション、Bitwarden 用のオプトイン式暗号化緊急キャッシュ、profile home ごとに適用範囲を限定した保管庫注入キー、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 のロールアップ（8月17〜18日）

v0.20.0 以降、プロジェクトは高頻度でタグ付きロールアップをリリースしており、最新の2つは単なる安定化リリースではありません。どちらにも「full curated release notes for this window will ship with v0.21.0」と記載されています。そのため、以下の概要は整理された機能一覧ではなく、各リリースに記載された対象期間の説明に基づいています。²³

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 の事前選択を備えた、マットガラスと半透明表現が追加されました。²³
• Bot ごとの表示／非表示切り替えに対応したタブ式の SESSIONS|BOTS サイドバーに加え、Bot Mode のグループチャットに関する修正（長時間実行されるメンバーターン、Markdown レンダリング、マシン間ルーティング）が追加されました。²³
• skill のインストール時に NVIDIA SkillEvaluator Tier 1 の勧告スキャンが実行され、ライセンスとセキュリティが検査されるようになりました。²³
• cron のメディア送信強化（設定可能なタイムアウト、手動実行時の添付ファイル、実行漏れの表示）、SessionDB のイベントループスレッドと競合に関する修正、hermes update の保留中ブランチに関する正確な表示、kanban のネイティブ OS 通知が含まれます。²³

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

v0.19.0 の新機能（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つのボットトークンを共有する単一の多重化 gateway で、特定のguild、channel、threadを異なる profile にルーティングできます。各 profile は完全に分離された設定、skill、メモリ、シークレットを持ち、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 trace 形式でエクスポートでき、オプトインの --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 の新機能（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 に変換できます。生成された skill は、リポジトリの CONTRIBUTING.md 規約に自動で準拠します。²²
• /journey タイムライン。 時間経過に伴うメモリと skill の視覚的な履歴です。編集機能に加え、デスクトップではメモリグラフも利用できます。²²
• バックグラウンドサブエージェントのファンアウト。 会話をブロックせず、複数のタスクを並行して委任できます。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 は Photon Spectrum（デバイスコード OAuth、hermes photon login）により、Mac リレーなしで動作するようになりました。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 の適応モデルは現在の思考コントラクトに従うようになりました（reasoning フィールドを送信しません）。²¹
• デスクトップとダッシュボード。 Desktop には、委譲されたアクティビティをライブの「watch-windows」でストリーミング表示する バックグラウンドサブエージェント（delegate_task(background=true)）、Composer のモデル選択、再割り当て可能なキーボードショートカット、ネイティブ OS 通知、スレッドごとの Composer 下書き、VS Code Marketplace テーマ、日本語および繁体字中国語 UI が追加されました。ダッシュボードには、config.yaml を編集せずにモデル・skill・MCP を設定できる完全な profile ビルダー、グローバル profile スイッチャー、セキュリティスキャン付きに刷新された Skills Hub、フォーム・スラッシュコマンド・会話・ドキュメントをまたぐパラメーター化テンプレートである Automation Blueprints、さらに OAuth ゲートの背後で 401 を返す安全なログインが追加されました。²¹
• Skills とツール。 image_generate は、対応するすべての画像プロバイダーで、ゼロから画像を作るだけでなく、元画像の編集・変換もできるようになりました。memory ツールには、単一呼び出しで原子的な一括追加・置換・削除を行う operations 配列が追加されました。新しい simplify-code skill は、Chesterton’s-Fence のリスクティアで制御される並列 3 エージェントのレビュー・クリーンアップ処理を実行します。また、3 値の write_mode は boolean の write_approval に置き換えられました。²¹
• アーキテクチャ。 バックグラウンドサブエージェントは即座にハンドルを返し、その結果を新しいターンとして再投入します。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 では、シェルエスケープの denylist 回避を修正し、承認モジュールや独自ポリシー gateway アダプターが存在しない場合はフェイルクローズします。cron ジョブスクリプトのサブプロセス用に環境をサニタイズし、リクエストのデバッグダンプではシークレットを伏せ字にし、MCP stdio 設定をデータ流出パターンについて検査します。さらに urllib3 と PyJWT を更新して CVE を解消しました。²¹

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 セッションを同時に利用できます。Desktop UI には型付き i18n レイヤー（display.language、デフォルトは英語）を通じた完全な簡体字中国語（简体中文）翻訳も含まれます。²⁰
• ブラウザー管理パネル。 ローカル Web ダッシュボードは、ステータス表示から完全な管理パネルへと発展しました。MCP カタログの有効化・無効化トグル、認証情報の管理、webhook と hook の作成、memory の設定、gateway コントロール、更新前チェックとワンクリック Debug Share を備えた System ページが利用できます。新しい Channels ページでは、Telegram、Discord、Slack など、すべての gateway メッセージングプラットフォームをブラウザーから設定できます。認証もプラガブルになり、ユーザー名・パスワードログイン、汎用セルフホスト OIDC プロバイダー、セルフホスト OAuth クライアント向けの hermes dashboard register、refresh-token セッションローテーションに対応します。²⁰
• 新しい CLI とスラッシュコマンド。 /undo [N] は直近 N 個のユーザーターンを prefill とソフト削除付きでバックアップし、CLI、TUI、メッセージングプラットフォーム間で利用できます。設定可能なデフォルトインターフェース（cli と tui）が --cli オーバーライドとともに追加され、TUI には統合された /model コマンドと Sessions オーバーレイが加わりました。hermes portal は Nous Portal オンボーディングフローの人間に分かりやすい別名であり、初回実行時には Quick Setup と Full Setup の新しい選択肢が提供されます。さらに、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 プロバイダーが Desktop ランチャーに加わり、モデル選択はすべての操作面でファジー検索に対応しました。複数エンドポイントのプロバイダーは 1 行にグループ化され、カタログの更新頻度は毎日から毎時へ変更されています。²⁰
• より軽量な skills と段階的開示。 デフォルト skill セットでは重複・廃止 skill が削除されました（Spotify はネイティブプラグインへ移行、Linear は hermes mcp install linear へ移行し、古いエントリーも複数削除されています）。さらに多くの機能がオプションに移され、environments: フロントマターの関連性ゲート（kanban/docker/s6）が追加されました。これにより、コンテキスト固有の skills は要求されるまでインデックスから除外されます。NVIDIA/skills は、OpenAI、Anthropic、HuggingFace と並ぶデフォルトの信頼済み Skills Hub ソースになりました。MCP とプラグインツールには段階的（スコープ付き）のツール開示が追加され、トークンを取得していないにもかかわらず OAuth 成功を誤って報告する MCP のバグも修正されました。²⁰
• セキュリティ。 v0.16.0 は CVE-2026-48710（BadHost）に対して修正済み Starlette（≥1.0.1）を固定し、非同期パスの SSRF URL チェックをイベントループ外へ移動しました。Bedrock 推論 bearer token をサブプロセス環境から除去し、ファイル安全性の読み取りガードに bws_cache.json を追加し、危険なパターン一覧に docker restart/stop/kill を追加しています。また、検証済み skill コンテンツ内の不可視 Unicode をサニタイズします。このリリースでは P0 の問題を 2 件、P1 の問題を 62 件修正し、そのうち 16 件にはセキュリティタグが付いています。²⁰

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

インストール

1行のインストーラーがサポートされているインストール方法です。Python、uv、Node.js、ripgrep、ffmpeg、リポジトリのクローン、仮想環境、グローバルな hermes コマンドを処理します。⁷

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

pip と Homebrew によるインストールは v0.19.0 で非推奨になりました。 v0.14.0 で導入された PyPI パッケージ（pip install hermes-agent）と Homebrew formula は、現在「unsupported legacy」インストールとして扱われています。Hermes が検出すると、ブロックはせずにすべての画面で警告が表示され、PyPI/Homebrew への公開停止も予定されています。pip または brew でインストールした場合は、上記のインストーラーへ移行してください。²⁵

Linux、macOS、WSL2、Android/Termux で動作します（インストーラーは Termux を自動検出し、テスト済みの Android bundle に切り替えます）。⁷ Native Windows は、初期ベータ版 v0.14.0 で提供された段階から進み、現在は Tier 1 プラットフォームです。iex (irm https://hermes-agent.nousresearch.com/install.ps1) でインストールできます。ドキュメントで明示されている注意点として、macOS のサポートは Apple Silicon のみであり、Intel Mac はサポートされていません。²⁴ 歴史的には、v0.14.0 で PowerShell インストーラーを通じた Native Windows サポートが初期ベータとして追加されました。ただし、Windows 向けの経路が成熟するまでは、本番利用には WSL2 のほうが安全な推奨事項です。¹⁹

完了後は、次を実行します。

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

必要な前提条件は git だけです。インストーラーは、uv を使って Python 3.11 を自動で準備し（sudo は不要です）、Node.js 26（ブラウザー自動化と WhatsApp bridge 用）、ripgrep、ffmpeg も導入します。Node 26 は v0.20.0 以降の必須最低バージョンです。インストーラーはそれより古いバージョンを拒否し、Hermes 管理の Node をインストールします。²⁴⁷

インストールを確認する

hermes version      # Check version
hermes doctor       # Diagnose config/dependency issues
hermes status       # Show current configuration + auth state
hermes dump         # Copy-pasteable setup summary for debugging

hermes doctor は、不足しているものと修正方法を正確に示します。⁷ hermes dump は、支援を求める際に GitHub の issue や Discord スレッドへ貼り付ける診断コマンドです。シークレットを伏せた状態で、セットアップ全体をプレーンテキストで要約します。⁸

手動インストール

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

Termux のインストールコマンドは異なります。uv pip ではなく、constraints file を指定した pip を使用します。

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

これは、Android 上の .[all] が voice extra 経由で faster-whisper を取得し、Android 向けに公開されていない ctranslate2 wheels に依存するためです。⁷

認証とプロバイダー

Hermes は約22のファーストクラスプロバイダーに加え、カスタムエンドポイント（v0.19.0 では Fireworks AI、DeepInfra、Upstage Solar を追加）と、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 に保存されます。²

完全なプロバイダーマトリクス

以下はすべてのファーストクラスプロバイダーと、それぞれの正確な設定フローです。²

v0.19.0 以降、使用しないプロバイダーを除外することもできます。プロバイダーごとの enabled: false フラグと excluded_providers 設定キーにより、/model ピッカーと組み込みプロバイダー解決から除外されます。²⁵

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 を使用している場合、これが最もクリーンな方法です。

Anthropic を config.yaml に恒久的に固定するには、次のようにします。

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_*）、Copilot Requests 権限を持つきめ細かな PAT（github_pat_*）、GitHub App トークン（ghu_*）です。gh auth token が ghp_* トークンを返す場合は、代わりに hermes model を使用して OAuth 経由で認証してください。²

中国の AI プロバイダー（ファーストクラスサポート）

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

# 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 を直接編集してください。²（OPENAI_BASE_URL + OPENAI_API_KEY は、補助的な provider: "main" ルーティングパスのフォールバックとしては引き続き尊重されるため、そこで使用している場合は不用意に削除しないでください。）⁴

セッション途中でカスタムエンドポイントを切り替える場合：

/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 のデフォルトのコンテキスト長は非常に短く（24GB 未満の VRAM では4,096トークン）、OLLAMA_CONTEXT_LENGTH または Modelfile で増やす必要があります。OpenAI 互換の API はクライアントからのコンテキスト長を受け付けないため、Hermes 側では設定できません。² エージェント用途では、少なくとも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 — KV キャッシュ再利用のための RadixAttention を備えた高速サービング：

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

続いて、トリプル構文を使ってセッション途中で切り替えます。

/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つのプロバイダー上の1つのモデルに固定しません。スマートモデルルーティングは、 特定のリクエストを実際に処理するプロバイダーとモデルを決定する一連の仕組みです。認証情報 プールは複数キーに負荷を分散し、設定済みのフォールバックはプライマリーの失敗時に引き継ぎ、 下記の補助スロットはメインモデルとは独立してサイドタスクを低コストモデルへルーティング します。²⁶ これら3つをまとめて設定してください。レート制限で停止するエージェントと、 作業を継続できるエージェントの違いになります。

認証情報プール。 同じプロバイダーに複数の 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セッションあたり最大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 は、画像解析、Web ページ要約、ブラウザーのスクリーンショット解析、危険なコマンドの承認分類、コンテキスト圧縮、セッション検索要約、skill マッチング、MCP ツールディスパッチ、メモリフラッシュといったサイドタスクに、軽量な「補助」モデルを使用します。⁴ デフォルトでは、これらは自動検出（OpenRouter → Nous → Codex）を通じて Gemini Flash を使用します。

補助タスクごとに使用するモデルとプロバイダーを設定できます。 すべての補助スロットには、共通する3つの設定項目があります：provider、model、base_url。⁴

auxiliary:
  vision:
    provider: "auto"                # "auto", "openrouter", "nous", "codex", "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: 30
    download_timeout: 30
  web_extract:
    provider: "auto"
    model: ""
    timeout: 360
  approval:
    provider: "auto"
    model: ""
    timeout: 30
  compression:
    timeout: 120
  session_search: { provider: "auto", model: "", timeout: 30 }
  skills_hub:    { provider: "auto", model: "", timeout: 30 }
  mcp:           { provider: "auto", model: "", timeout: 30 }
  flush_memories:{ provider: "auto", model: "", timeout: 30 }

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

重要な理由： Anthropic OAuth だけを設定し（OpenRouter キーがない場合）、デフォルトの補助フォールバックチェーンは最初に OpenRouter を試すため、ビジョン、Web 要約、圧縮が劣化または失敗します。補助タスク用に OPENROUTER_API_KEY を追加するか、各補助スロットをメインプロバイダー使用へ再設定してください。

auxiliary:
  vision:
    provider: "main"
  web_extract:
    provider: "main"

これは、新しい Hermes ユーザーにとって最もよくある「機能が静かに動かない」落とし穴です。

設定システム

Hermes には階層型の設定システムがあります。上位レイヤーは下位レイヤーを上書きし、config.yaml には見えないグローバルなプロバイダーレジストリもその一部であるため、優先順位を理解することが重要です。

設定ファイルの構成

upstream のドキュメントによると、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

シークレットは、shell 形式の補間を使用して 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 フラグは、その1回の呼び出しでは常に優先されます。長期的な正とすべき設定源は config.yaml です。

ローカライゼーション（v0.13.0+）

v0.13.0 では、CLI と gateway メッセージ向けに 7 ロケールが追加されました。中国語（簡体字）、日本語、ドイツ語、スペイン語、フランス語、ウクライナ語、トルコ語です。¹⁸ v0.14.0 ではすべての gateway コマンドと web dashboard がローカライズされ、さらに8つのロケールが追加されて、合計16になりました。¹⁹ 現在、ドキュメントは 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 を同時に実行しても、互いに干渉しません。⁶³

CLI コマンド

このセクションでは、トップレベルの CLI コマンドを実践者向けに参照します。コードから導出された正確な参照については、上流の CLI Commands Reference をご覧ください。⁶

グローバルオプション

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

トップレベルコマンド

hermes chat — 主なエントリーポイント

引数なしで hermes を実行すると、対話型チャットに入ります。hermes chat はオプションを指定する明示的な形式です。⁶

hermes chat -q "Summarize the latest PRs"           # One-shot, non-interactive
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] です。config の有効性、依存関係の有無、API キーの可用性、サービスのステータスを確認し、--fix で自動修復を試行できます。⁶

他の人と診断結果を共有するには、hermes dump を使用します。API キーをマスクした簡潔なプレーンテキストの概要が生成され、GitHub の issue や Discord スレッドにそのまま貼り付けられます。⁶

スラッシュコマンド

スラッシュコマンドは、アクティブなチャットセッション（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ターン限定のモデルオーバーライドで、応答後に以前のモデルへ自動的に戻ります。²⁵

ツール、skill、情報

動的 skill スラッシュコマンド

インストールされたすべての skill は、自動的にスラッシュコマンドとして公開されます。⁹

/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 以降、スラッシュ 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 を閲覧します（ページ分割）

また、CLI 専用のコマンドもあります：/skin、/tools、/toolsets、/browser、/config、/cron、/skills、/platforms、/paste、/statusbar、/plugins。⁹

ツールとToolsets

Hermesには、Web検索、ブラウザー自動化、ターミナル実行、ファイル編集、メモリー、委任、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>でセッション中に切り替えることもできます。この操作ではセッションがリセットされ、新しいツールセットが反映されます。⁹

ターミナルバックエンド

ターミナルツールは、6種類の環境でコマンドを実行できます。¹⁰

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

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

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

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ケーパビリティの削除、権限昇格の禁止、PID制限（256プロセス）、完全な名前空間分離、ボリュームによる永続ワークスペースが含まれます。¹⁰

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

ターミナルツールは、明示的なプロセス管理によるバックグラウンド実行をサポートしています。¹⁰

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では、マルチAgentコラボレーションが第一級のプリミティブになります。すなわち、Agent間および再起動後もタスク、ステータス、ワーカーIDを追跡する永続的なKanbanボードです。¹⁸ このボードにより、Hermesワーカーのスウォームは、行き詰まった引き継ぎで停止することなく実際に作業を完了できます。

Kanbanボードは、対象側の/goal（ロックされたターゲットのRalphループ）や、既存のdelegate_taskツールによる起動セマンティクスと自然に組み合わせられます。結果として、次に何を行うか、誰が実行しているか、何が停止しているかについて、すべてのAgentが1つの信頼できる情報源を共有するスウォームパターンになります。

Hermesスウォームとは？

スウォームとは、共有Kanbanボードに対して並行実行される複数のHermesワーカーです。 有効化する独立したサブシステムではありません。ボードによって可能になる仕組みです。ボードは、 並列Agentだけでは提供できない1つの要素、すなわち次に何を取得すべきか、すでに誰かが取り組んでいるかという問いへの 単一の権威ある答えを提供します。

v0.15.0では、これがパターンからサポート対象のトポロジーへと昇格しました。並列ワーカー調整のためのスウォームトポロジー、 高レベルの目標をサブタスクへ分解する自動分解、タスクごとのモデル上書き、 スケジュール済みタスク、さらに並列ワーカーが同じチェックアウトで競合しないためのworktree管理が追加されています。²⁸

実運用では、スウォームに目標を与え、自動分解でそれをボードタスクに分割し、 ワーカーに取得、実行、結果の返却を任せます。再試行予算はタスク単位（max_retries）なので、 壊れやすい1つのサブタスクが実行全体の許容範囲を消費することはありません。ボードは 永続的であるため、スウォームは再起動後も存続します。ワーカーは同じ状態に再接続して再開します。

スウォームの質は、分解の質によって決まります。 ボードはワーカーを調整しますが、 不適切に分割された目標を適切なものにはできません。隠れた状態を共有するタスクは、依然として競合します。 worktreeがあっても同様です。

スキルシステム

スキルは、必要なときにエージェントが読み込めるオンデマンドのナレッジドキュメントです。トークン使用量を抑えるために段階的開示のパターンに従っており、agentskills.io のオープンスタンダードと互換性があります。¹¹

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

段階的開示

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.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.

条件付き有効化

スキルは、利用可能なツールに応じて自身を表示または非表示にできます。これは、フォールバックスキル、つまりプレミアムツールを利用できない場合にのみ表示される無料またはローカルの代替手段で特に役立ちます。¹¹

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

エージェント管理スキル

エージェントは skill_manage ツールを介して、自身のスキルを作成、更新、削除できます。これはエージェントの手続き的記憶です。些細ではないワークフローを見つけたとき、そのアプローチを将来再利用できるスキルとして保存します。¹¹

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

アクション：¹¹

Skill Hub

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

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 タップ（設定なしで閲覧可能）：openai/skills、anthropics/skills、huggingface/skills、NVIDIA/skills、garrytan/gstack。claude-marketplace ソースはv0.20.0で削除され、ソースリストでは browse-sh に置き換えられました。¹¹²⁴

セキュリティスキャン

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

信頼レベル：¹¹

--force は、communityスキルに対する危険ではないポリシーブロックを上書きできます。dangerous のスキャン判定は上書きできません。¹¹

外部スキルディレクトリ

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

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

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

永続メモリ

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

どちらも、セッション開始時の固定スナップショットとしてシステムプロンプトに注入されます。エージェントはmemoryツールを通じて、add、replace、removeで自身のメモリを管理します。¹²

固定スナップショットのパターン： システムプロンプトへの注入内容はセッション開始時に1度だけ取得され、セッション途中で変化することはありません。これは意図的な設計であり、パフォーマンスのためにLLMのプレフィックスキャッシュを維持します。セッション中に行った変更は直ちにディスクへ永続化されますが、次のセッションまでシステムプロンプトには反映されません。¹²

保存する内容

次の内容は保存します（エージェントが自発的に行います）：¹² - ユーザー設定： 「TypeScriptよりJavaScriptの方が好みです」→ user - 環境の事実： 「このサーバーはPostgreSQL 16を搭載したDebian 12で動作しています」→ memory - 修正事項： 「Dockerコマンドにはsudoを使わないでください。ユーザーはdockerグループに所属しています」→ memory - 規約： 「プロジェクトではタブ、120文字の行幅、Googleスタイルのdocstringを使用します」→ memory - 完了した作業： 「2026-01-15にデータベースをMySQLからPostgreSQLへ移行しました」→ memory

次の内容は保存しません：¹² - 些細な情報や明白な情報 - 容易に再発見できる事実 - 生データのダンプ（メモリには大きすぎます） - セッション固有の一時的な情報 - すでにコンテキストファイルにある情報

セッション検索

MEMORY.mdとUSER.mdに加えて、エージェントはsession_searchツールを使って過去の会話を検索できます。すべてのCLIおよびメッセージングセッションは、FTS5全文検索を備えたSQLite（~/.hermes/state.db）に保存されます。クエリでは、Gemini Flashによる要約付きで関連する過去の会話が返されます。¹²

外部メモリプロバイダー

MEMORY.mdとUSER.mdを超える深い永続メモリのために、Hermesには8つの外部メモリプロバイダープラグインが付属しています。Honcho、OpenViking、Mem0、Hindsight、Holographic、RetainDB、ByteRover、Supermemoryです。¹²

外部プロバイダーは組み込みメモリを置き換えるのではなく、並行して動作し、ナレッジグラフ、セマンティック検索、自動的な事実抽出、セッションをまたぐユーザーモデリングなどの機能を追加します。⁶¹²

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)

有効にできる外部プロバイダーは同時に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は、~/.hermes/SOUL.md（カスタムprofileでは$HERMES_HOME/SOUL.md）にデフォルトの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-04-16）以降、有料のNous Portal subscribersは、既存のPortal認証情報を通じて、厳選されたツール群に管理された形でアクセスできるようになりました。管理する追加のAPIキーは不要です。³⁰ Hermes CLI自体は、引き続きMITライセンスの完全なオープンソースです。変更されたのは、Portal認証によってモデル推論以外にもアクセスできるようになった点です。

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）で公開されています。このガイドではティアを列挙しません。これはHermes CLIではなくPortal製品の責務であり、Hermesのリリースとは独立して変更されるためです。https://portal.nousresearch.com/で登録し、現在のティアは料金ページで確認してください。

非推奨化のお知らせ

• HERMES_ENABLE_NOUS_MANAGED_TOOLS環境変数はv0.10.0で削除されました。管理ツールは現在、ツールごとのuse_gateway設定フィールドで有効化され、Portalサブスクリプションの状態に基づいて制御されます。³⁰

このリリースが提供しないもの

Hermes Agent CLIは、サブスクリプション必須ではありません。プロジェクトは引き続きMITライセンスであり、すべてのコア機能（CLI、skill、メモリ、messaging gateway、cron、MCP、ローカルダッシュボード、すべてのプロバイダー向けBYOK）は、誰にも料金を支払わずにエンドツーエンドで利用できます。v0.10.0は、すでにNous Portalに料金を支払っているユーザー向けの便利な経路を追加するものであり、無料の経路から何かを取り除くものではありません。

Messaging Gateway

Hermesは、単一のgatewayプロセスから28のメッセージングプラットフォームに接続する、長時間稼働するgatewayプロセスとして実行できます。対応プラットフォームは、Telegram、Discord、Slack、WhatsApp、Signal、SMS、Email、Home Assistant、Mattermost、Matrix、DingTalk、Feishu/Lark、WeCom、Weixin（WeChat）、BlueBubbles（iMessage）、QQBot、Microsoft Teams、Tencent Yuanbao、Google Chat、LINE、SimpleX Chat、および汎用Webhookアダプターです。^329171819 v0.9.0ではBlueBubbles経由のiMessage（自動Webhook登録、セットアップウィザード、クラッシュ耐性）と、エンタープライズアプリ向けWeComコールバックモードを備えたiLink Bot API経由のネイティブWeChatサポートが追加されました。¹⁶ 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が追加されました。²¹

セットアップ

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トークン、ボット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つのボットトークンを共有する単一の多重化gatewayは、特定のguild、チャンネル、またはスレッドを、それぞれ設定、skill、メモリ、シークレットが完全に分離された別々のprofileへルーティングできます。GATEWAY_MULTIPLEX_PROFILESによるオーバーライドも可能で、堅牢化により、設定ミスのある1つのprofileがgateway全体を停止させることはなくなりました。内部では、ルーティングインデックスがstate.dbへ移されました（sessions.jsonは現在、任意のレガシーミラーです）。また、最終応答はプラットフォーム送信時の永続的な配信義務台帳に記録されるため、完了した回答がgatewayクラッシュに遭遇しても、次回起動時に再配信され、無言で失われることはありません。²⁵

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

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で承認します。それ以降、そのユーザーは認可されます。⁶

スケジュール済みタスク（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に永続化され、再起動後も保持されます。³

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

または、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の命名規則でモデルに公開されます。すべてのツール名にサーバー名が含まれるため、同じツールを公開する2つのサーバーがあっても衝突しなくなります。また、MCPサーバーのログ通知はagent.logに表示されます。²⁵

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

hermes mcp serve
hermes mcp serve -v    # Verbose

コンテキスト圧縮

Hermesは、モデルのコンテキストウィンドウ内に収まるよう、長い会話を自動的に圧縮します。圧縮用サマライザーは個別のLLM呼び出しです。任意のプロバイダーまたはエンドポイントを指定できます。⁴

compression:
  enabled: true
  threshold: 0.50                           # Compress at this % of context limit
  target_ratio: 0.20                        # Fraction to preserve as recent tail
  protect_last_n: 20                        # Min recent messages to keep uncompressed
  summary_model: "google/gemini-3-flash-preview"
  summary_provider: "auto"                  # "auto", "openrouter", "nous", "codex", "main", etc.
  summary_base_url: null                    # Custom OpenAI-compatible endpoint

プロバイダーのオプション：⁴

summary_modelは、メインモデルと少なくとも同じコンテキスト長をサポートしている必要があります。圧縮時に会話の中間セクション全体を受け取るためです。⁴

予算逼迫の警告

多数のツール呼び出しを伴う複雑なタスクに取り組む際、エージェントは気付かないうちに反復予算を使い切ることがあります（v0.20.0時点のデフォルトは500ターンで、90から増加）。予算が逼迫すると、モデルに自動で警告されます。⁴

ストリームタイムアウト

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

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

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

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

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

watch_patternsを使うと、バックグラウンドプロセスの出力を監視するパターンを設定でき、一致したときにリアルタイムで通知を受け取れます。¹⁶ エラーの監視、特定イベント（「ポートでリッスン中」など）の待機、ビルドログの監視を、ポーリングなしで実行できます。v0.8.0で追加されたnotify_on_complete（バックグラウンドタスクの完了を通知）と組み合わせることで、Hermesには完全なバックグラウンドプロセス可観測性レイヤーが備わりました。¹⁵

プラガブルなコンテキストエンジン（v0.9.0+）

コンテキスト管理は、hermes pluginsを通じてプラガブルなスロットになりました。フィルタリング、要約、ドメイン固有のコンテキスト注入など、各ターンでエージェントが見る内容を制御するカスタムコンテキストエンジンに差し替えられます。¹⁶ これにより、コンテキスト戦略がコアエージェントループから分離され、プロジェクトやドメインごとのコンテキストカスタマイズが可能になります。

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

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

Termux / Androidのサポート（v0.9.0+）

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

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

v0.13.0では、P0のセキュリティ問題8件を修正し、1つのデフォルト設定をユーザーに有利なものへ変更しました。¹⁸ v0.14.0ではさらにP0を12件、P1を50件修正しています。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、依存関係アドバイザリーにわたる追加の強化を行っています。

実務者のためのアーキテクチャ

このセクションは、内部で何が起きているのかを理解し、デバッグ、拡張、パフォーマンスの検討に役立てたい方のためのものです。upstream のアーキテクチャドキュメントを統合した内容です。³

エントリーポイント → 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    │  │              │             │
│  └──────────────┘ └──────────────┘  └──────────────┘             │
└──────────────────────────────────────────────────────────────────┘

図は upstream のアーキテクチャドキュメントをもとにしています。³

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

3つの API モード

Hermes は provider ごとの差異を3つの API モードに抽象化しており、実行時に自動で選択されます。³

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

CLI セッションにおけるデータフロー

User input → HermesCLI.process_input()
  → AIAgent.run_conversation()
    → 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

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

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

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

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

SOUL.md が土台であり、ほかのすべてはその上に積み重ねられます。¹³

セッションストレージ

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

プラグインシステム

検出元は3つです。~/.hermes/plugins/（ユーザー）、.hermes/plugins/（プロジェクト）、pip エントリーポイントです。プラグインはコンテキスト API を通じて、ツール、hooks、CLI コマンドを登録します。メモリ provider は plugins/memory/ 配下にある特殊なプラグイン種別です。³

hermes plugins                       # Interactive enable/disable UI
hermes plugins install <repo>        # Install from Git URL or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list

デザイン原則

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

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、デフォルトモデル、カスタム provider、MCP servers、メッセージングプラットフォームのトークンと許可リスト（Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost）、agent のデフォルト設定（reasoning effort、compression、human delay、timezone、sandbox）、セッションリセットポリシー、承認ルール、TTS config、ブラウザー設定、ツール設定、exec timeout、コマンド許可リスト、gateway config、3つのソースにある API keys。⁶

手動レビュー用にアーカイブされるもの： cron jobs、plugins、hooks/webhooks、memory backend（QMD）、skills registry config、UI/identity、logging、multi-agent setup、channel bindings、IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.md。⁶

API key の解決では、優先順位に従って3つのソースを確認します。config values → ~/.openclaw/.env → auth-profiles.json。⁶

トラブルシューティング

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

新規インストールで最初に遭遇しがちなエラーです。Hermes に解決済みの provider がまだないことを示しており、3つの認証経路のいずれからも利用可能な provider が得られていません。次を実行してください。

hermes model

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

「API key not set」

hermes model を実行して対話形式で provider を設定するか、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

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

サーバーで tool calling が有効になっていないか、サーバー実装を通じてモデルが対応していません。²

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

考えられる原因は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」を有効にしてください。²

各種ファイルや情報はどこにありますか？

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

よくある質問

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

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

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

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

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

同じマシンで既に Claude Code を使用している場合は、選択肢2が推奨されます。更新可能な Claude 認証情報を更新可能な状態に保てます。

会話を失わずに provider を切り替えるにはどうすればよいですか？

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

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

Anthropic を設定したのに、vision/web/compression が機能しません

補助モデルのフォールバックが使用されています。vision、web 要約、compression、そのほかのサイドタスクでは、別の補助 LLM を使用します。デフォルトでは自動検出により Gemini Flash が使用されます（OpenRouter → Nous → Codex）。これらのいずれも設定されず、Anthropic のみを設定している場合、これらの機能は通知なく劣化します。⁴

対処方法は、補助タスク用に OPENROUTER_API_KEY を追加するか、補助スロットをメイン provider を使用するよう再設定することです。コンテキスト圧縮は独自のトップレベル compression: ブロックにあり、auxiliary.compression.provider ではなく summary_provider を受け取る点に注意してください。auxiliary.compression スロットで設定できるのは timeout のみです。完全な修正は次のとおりです。

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

compression:
  summary_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 tools / 20 toolsets は、upstream architecture registry に基づく数値です。これは、すべての toolset にわたって Hermes がソースコードとして提供するツールの総数です。実行中のインストールでは、バナーにより少ない数が表示されます（本ガイドの参照インストールでは28 tools と表示されます）。これは、Hermes が起動時にデフォルトの toolset セットのみを有効にするためです。多くの toolset はオプトインです。メッセージング gateway アダプター、ブラウザー自動化、負荷の大きいスクレイピングスタック、複数の専門的な統合は、読み込まれる前に ~/.hermes/config.yaml の toolsets: に明示的に列挙する必要があります。Registry の合計は「有効にした場合に利用可能なもの」です。バナーの合計は「現在の profile が実際に読み込んだもの」です。hermes tools --list を使用すると、有効な toolset と利用可能だが無効な toolset を確認できます。個々の toolset は、実行中に /tools enable <name> と /tools disable <name> で切り替えられます（無効化するとセッションがリセットされ、エージェントは新しい構成でツールマニフェストを再構築します）。

primary provider が失敗した場合、Hermes はモデルフォールバックをどのように処理しますか？

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

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

primary が失敗した場合（レート制限、サーバーエラー、認証失敗）、Hermes は会話履歴を失うことなく、セッション途中で fallback に切り替えます。セッションごとに発生するのは最大1回です。

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

はい。これが Hermes Agent の「self-improving」の部分です。エージェントは skill_manage ツールを介して skill を作成、更新、削除できます。複雑なワークフローを解明した場合、そのアプローチを将来再利用するための skill として保存します。¹¹ エージェントは、複雑なタスク（5回以上のツール呼び出し）の後、エラーに遭遇して有効な手順を見つけたとき、アプローチを修正されたとき、または自明ではないワークフローを発見したときに skill を作成します。

IDE 統合はありますか？

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

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

変更履歴

参照