Hermes Agentとは何か：インストールと設定の方法

Claude Code、Codex、Cursor、OpenClaw――それぞれのAIエージェントには独自の役割があります。サーバー上で稼働し、セッションをまたいであなたを記憶し、タクシーに乗っているときにもTelegramで応答してくれるエージェントが必要なら、Hermes Agentがその役割に合います。

Hermes AgentはNous Researchによるオープンなプロジェクトで、多くの人が思うよりずっと簡単にインストールできます。この記事では、Hermes Agentとは何か、費用はいくらか、Windows、macOS、Linuxへのインストール方法、モデルとTelegramボットの接続方法を紹介します。内容はすべて公式ドキュメントに基づいています。

Hermes Agentとは何か、わかりやすく説明#

HermesはClaude CodeやCodexと同じカテゴリに属します。返答を書くだけではなく、ファイルを開き、ターミナルコマンドを実行し、ブラウザーを使うAIエージェントです。構築方法に違いがあります。Claude CodeはAnthropicのモデルに結び付いていますが、HermesはClaudeやGPTから、ハードウェア上で動作するローカルモデルまで、あらゆるモデルプロバイダーと連携できます。

このプロジェクトは新しく、GitHubリポジトリが作成されたのは2025年7月22日です。それでも、2026年8月22日時点で、スター数は234,000を超え、フォーク数は47,000に達しており、このカテゴリで最も急成長しているオープンプロジェクトの一つです。コードはMITライセンスのもとで完全に公開されています。ロイヤリティを支払わずに、読んだり、変更したり、自分の製品で使ったりできます。

この「自己改善」を支える仕組みは、スキルとメモリの2つです。スキルとは、複雑なタスクの後にエージェントが書き留め、次回に適用する手順です。メモリは、あなたや環境に関する事実を記録したファイルで、新しい会話のたびに読み込まれます。どちらの仕組みも、以下の専用セクションで説明します。

Hermes AgentはClaude CodeやCodexとどう違うのか？#

主な違いを次の表にまとめました。

この表から主なポイントがわかります。最も強力なモデルを必要とし、リポジトリ内で作業するなら、Claude Codeが適しています。この用途では、Anthropicが今もモデルとツールの最良の組み合わせを提供しています。Hermesは、エージェントを「常時稼働」させたい場合に向いています。サーバー上で動かし、毎朝決まった時間に作業を行わせ、Telegramで応答させ、昨日の会話を覚えさせることができます。

基本的なツールを比較している方は、Claude Codeのインストール方法、OpenAIのCodexとは何か、2026年のAIコーディングツールの状況について、それぞれ別のガイドをご覧ください。

2026年、Hermes Agentの費用はいくら？#

最も手軽な選択肢は、Hermesの開発元が提供する公式サブスクリプション、Nous Portalです。300を超えるモデルに加え、ウェブ検索、画像生成、音声合成、クラウドブラウザーなど、すぐに使えるサービスも含まれます。2026年8月22日時点のプランは次のとおりです。

多くの人が見落としがちな2つ目の選択肢は、新しいサブスクリプションに登録する必要がないことです。HermesはOAuth、つまりすでに持っているアカウントを通じてサインインできます。ChatGPTとCodexのサブスクリプション、Claude Max、xAIのSuperGrok、Qwen、MiniMax、GitHub Copilotに対応しています。セットアップでプロバイダーを選び、ブラウザーでサインインを確認すれば、これまでとまったく同じ料金を支払うだけです。

3つ目の選択肢は、自分のAPIキーを使う方法です。Anthropic、OpenAI、Google、DeepSeek、Z.AI、Kimi、Alibabaなど、さらに約12のプロバイダーに対応しています。キーを入力すれば、利用分は各プロバイダーのアカウントに直接請求されます。

4つ目は金銭的な費用はかかりませんが、ハードウェアが必要です。OllamaまたはLM Studioを通じてローカルモデルを使います。高性能なコンピューターがあり、データを外部に送信したくない場合に適しています。条件が1つあります。モデルのコンテキストウィンドウは最低64,000トークン必要です。そうでないとHermesは起動を拒否します。長いタスクを進めるのに十分な作業メモリが必要だからです。

海外サービスの支払い方法はここでは扱いません。別のルールがある別テーマであり、Claude Codeを例にしたこちらのガイドで説明しています。

WindowsにHermes Agentをインストールする方法#

ターミナルに慣れていない場合は、インストーラーから始めましょう。hermes-agent.nousresearch.comのウェブサイトには、macOS 12以降、Windows 10/11、Linux用のダウンロードボタンがあります。ダウンロードしたファイルは2つのアプリを一度にインストールします。hermesコマンドラインと、チャット、ファイル、設定を備えた通常のウィンドウ形式のHermes Desktopです。

コマンドに慣れている場合は、PowerShellからインストールします。

1. PowerShellを開く

   Winキーを押し、「PowerShell」と入力して開きます。管理者権限は必要ありません。

2. インストーラーを実行する

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

   スクリプトは必要なものをすべてダウンロードします。Python 3.11、Node.js 22、uvパッケージマネージャー、ripgrep、ffmpegです。Gitがない場合は、独立して保存され、システムプログラムに影響しない専用のMinGitビルドをインストールします。

3. ターミナルを再起動して確認する

   hermes doctor
   

   このコマンドは、インストール済みのもの、不足しているもの、修正方法を表示します。緑のチェックマークが表示されれば、すべてインストールされています。

この方法でインストールすると、ファイルは%LOCALAPPDATA%\hermesに保存されます。WSL2を使っている場合、次のセクションにあるLinux向けコマンドもWSL2内で使えます。都合のよい方法を選んでください。

macOSとLinuxにHermes Agentをインストールする方法#

Hermesは、ノートパソコンでもサーバーでも、1つのコマンドでインストールできます。全手順は次のとおりです。

1. Gitがインストールされていることを確認する

   git --version
   

   コマンドがバージョン番号を返したら、次に進みます。Linuxでは、curlとxz-utilsも確認してください。DebianとUbuntuでは、sudo apt install curl xz-utilsでインストールします。

2. インストーラーを実行する

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

   スクリプトはリポジトリを~/.hermes/hermes-agentにクローンし、仮想環境を作成して、hermesコマンドを~/.local/binにインストールします。GUIやブラウザー自動化を使わないサーバー向けには、軽量な方法があります。末尾にbash -s -- --skip-browserを追加します。

3. シェルを再読み込みして起動する

   source ~/.zshrc   # macOSの場合。Linuxでは通常、source ~/.bashrc
   hermes
   

rootとしてインストールした場合、ファイルはシステムパスの/usr/local/lib/hermes-agentと/usr/local/bin/hermesに置かれます。複数のアカウントで使うサーバーに便利です。設定、キー、メモリは引き続き各ユーザーの個人用~/.hermesフォルダーに保存されます。

Linux版Hermes Desktopについての注意点が1つあります。DebianとUbuntuでアプリをビルドするには、build-essentialパッケージに含まれるコンパイラーが必要です（sudo apt install build-essential）。また、コマンドでHermesをインストールした場合、別のインストーラーは必要ありません。hermes desktopを実行すると、既存の設定、セッション、スキルを使ってアプリが起動します。

Hermes Agentにモデルを接続する方法#

モデルはHermesのエンジンです。エージェントが自分で考えるのではなく、選んだモデルに接続します。そこで、インストール後の最初の手順は、接続先を選ぶことです。

hermes model

セットアップウィザードでは、プロバイダー、サインイン方法、モデルを尋ねられます。選択肢は多数あります。主なものは次のとおりです。

Nous Portalを選ぶと、1つのコマンドですべて完了します。

hermes setup --portal

ブラウザーでサインインページが開きます。確認すると、プロバイダーにNousが設定され、Tool Gatewayが有効になります。ウェブ検索、画像生成、音声合成を、それぞれのサービスで別途キーを用意せずに利用できます。

Hermesはキーと設定を別々に保存します。最初にこの点を理解しておくことが重要です。APIキーやトークンなどのシークレットは~/.hermes/.envに、通常の設定は~/.hermes/config.yamlに保存されます。これらのファイルを手動で編集する必要はありません。hermes config setが各値を適切なファイルに書き込みます。

Ailootのドキュメントでツールのガイドを探す

セットアップウィザード全体を起動するコマンドはhermes setupです。3つのモードがあります。Nous Portalを使ったクイックセットアップ、プロバイダーとツールを1つずつ設定するフルセットアップ、そして必須項目以外をすべて無効にしたクリーンインストールのBlank Slateです。必要な機能だけを有効にできます。

Hermes Agentが動作しているか確認する方法#

モデルを選んだら、会話を始めましょう。

hermes          # 従来のインターフェース
hermes --tui    # マウス対応とポップアップウィンドウを備えた最新のインターフェース

ウェルカムバナーには、選択したモデル、有効なツール、スキルが表示されます。次に、「こんにちは、あなたは誰ですか？」とは尋ねず、目に見える結果を得られるタスクを指示しましょう。「ディスク上の最も大きなフォルダーを5つ表示して」や「現在のフォルダーを見て、メインのプロジェクトファイルがどれか教えて」などです。エージェントがターミナルコマンドを実行し、意味のある答えを返せば、基本設定は機能しています。

最後の確認はセッションです。会話を終了してから、もう一度戻ります。

hermes --continue   # または短縮形：hermes -c

同じ会話が表示されるはずです。これでセッションメモリがディスクに書き込まれていることを確認できます。後でボットやスケジュールタスクがこれに依存します。

動作しない場合は、この順序で確認します。hermes doctor（一般的な診断）、hermes model（モデルとサインインの再確認）、hermes setup（設定の再構築）、hermes sessions listとhermes --continue（セッションの確認）、hermes gateway status（ゲートウェイの状態確認）。この手順で、「すべて壊れている」状態から、数分で状況が明確な状態に戻せます。

Hermes Agentのスキルとメモリとは？#

Hermesのスキルは、名前、説明、段階的な手順を記したSKILL.mdファイルです。文書の組み立て、プルリクエストの作成、メーリングリストの準備などの方法を書きます。エージェントはまずすべてのスキルの短い説明を読み、タスクが一致したときだけ全文を読み込みます。そのため、スキルを100個インストールしても、すべてのリクエストが膨らむことはありません。標準はオープンなagentskills.ioで、同じファイルをほかのエージェントでも使えます。

スキルは~/.hermes/skills/フォルダーにあります。そこに追加される方法は3つです。アプリと一緒に基本セットがインストールされる方法、hermes skills installでカタログから既成のスキルを追加する方法、複雑なタスクの後にエージェントが自分用のスキルを作成する方法です。各スキルは自動的にスラッシュコマンドになります。gif-searchスキルをインストールすると、どのチャットでも/gif-searchが使えます。カタログからのインストールにはセキュリティチェックがあり、他人の手順に悪意あるコマンドが含まれていても取り込まれないようにします。

メモリはもっとシンプルです。~/.hermes/memories/に2つのファイルがあります。MEMORY.mdは、環境や結論についてのエージェント自身のメモで、最大2,200文字です。USER.mdは、あなたへの応答方法、好みや嫌いなことを記録するプロフィールで、最大1,375文字です。会話を始めるたびに、両方のファイルがシステムプロンプトに追加されるため、エージェントは最初からあなたについて知っています。制限は意図的に厳しく設定されています。メモリが際限なく膨らまず、何を残して何を捨てるかはエージェントが判断します。

スキルとメモリの2つがSecond Brainです。コンテキストを覚え、手順を蓄積するエージェントは、インストールした日よりも毎週目に見えて優れた働きをするようになります。スキルを選び、エージェントが情報のゴミ捨て場になるのを防ぐ方法については、Claude Codeを例にしたこちらのガイドをご覧ください。原則は同じです。

Hermes AgentをTelegramに接続する方法#

TelegramはHermesで最も人気のあるチャンネルで、連携機能も充実しています。テキスト、文字起こし付きの音声メッセージ、画像やファイル、グループでの返信に対応します。手順は次のとおりです。

1. BotFatherでボットを作成する

   Telegramで@BotFatherを開き、/newbotを送信して名前を選びます。次に、末尾がbotの一意なユーザー名を選んでください。123456789:ABCdef...のようなトークンが届きます。これはボットの鍵なので、パスワードと同じように保管してください。トークンが漏れたら、同じBotFatherに/revokeを送信して無効にします。

2. ユーザーIDを調べる

   あなたの数字のTelegram IDを確認します。たとえば123456789のような形式です。これはアカウント番号です。ユーザー名と混同しないでください。アクセスリストに必要です。

3. ゲートウェイのセットアップウィザードを実行する

   hermes gateway setup
   

   Telegramを選び、トークンとIDを貼り付けます。設定はウィザードが保存します。同じ設定は、~/.hermes/.envにTELEGRAM_BOT_TOKEN=...とTELEGRAM_ALLOWED_USERS=123456789の2行を手動で追加してもできます。

4. ゲートウェイを起動する

   hermes gateway
   

   数秒でボットがオンラインになります。メッセージを送って、応答を確認してください。

アクセスはデフォルトで制限されています。ボットが応答するのはリストに載っているIDだけです。新しいユーザーにはペアリングコードを発行できます。コードは1時間有効で、その後期限切れになります。保留中および承認済みユーザーの一覧はhermes pairing listで確認できます。

よく忘れられるグループチャットの注意点が1つあります。Telegramボットでは、デフォルトでプライバシーモードが有効です。グループ内では、ボットはコマンドと自分のメッセージへの返信だけを確認します。すべてのメッセージを読ませるには、@BotFatherでモードを無効にします（Bot Settings - Group Privacy）。または、もっと簡単に、ボットをグループ管理者にします。

デフォルトでは、ゲートウェイ自身がTelegramのサーバーをポーリングします。常時稼働する家庭用コンピューターやサーバーなら問題ありません。受信トラフィックがないとマシンをスリープさせるクラウドプラットフォーム向けには、Telegramがあなたのアドレスにメッセージを送るWebhookモードがあります。

Hermes Agentはインストール後に何ができる？#

次の順序で有効にしましょう。

1. スケジュールタスク。 ゲートウェイにはスケジューラーが組み込まれています。「毎朝8時に、私の関心分野のニュースをまとめてTelegramで送って」といった指示ができます。通常のフレーズでスケジュールを設定すると、同じチャットに結果が届きます。
2. Hermes Desktop。 hermes desktopコマンドを実行すると、macOS、Windows、Linux向けのアプリが開き、同じエージェントを使えます。応答のストリーミング、チャット横のファイルプレビュー、文書のドラッグ＆ドロップ、コンテキストカウンターに対応します。セッションは共有されるため、ターミナルで始めた作業をウィンドウで続けられます。
3. ウェブパネル。 hermes dashboardを実行すると、チャンネル、メモリ、Webhook、プロフィールを管理するブラウザーパネルが開きます。Hermesをサーバー上で動かす場合に便利です。
4. サブエージェント。 大きなタスクを、隔離されたヘルパーエージェントに委任できます。それぞれに独自の会話とターミナルがあり、あなたのコンテキストを消費しません。
5. 音声。 音声モードはターミナル、Telegram、Discordで使えます。タスクを口述すると、音声で応答を受け取れます。
6. コードエディター。 ACPプロトコルを通じてHermesをVS Code、Zed、JetBrainsに接続すると、エディター内のエージェントとして利用できます。

hermes toolsでツールを1つずつ有効または無効にできるため、エージェントに不要な機能を持たせずに済みます。別のマシンに移すときは、hermes backupでインストール全体をアーカイブにまとめ、hermes importで新しい場所に展開します。

Hermes Agentはどんな人に向いている？ まだ待ったほうがよいのは？#

文書の整理、プロトタイプの作成、連絡の管理、朝のニュースまとめなど、エージェントに何をさせたいかがわかっていれば、Hermesをインストールする意味があります。大切なのはツールそのものではなく、ツールに任せるタスクです。このテーマについてはAIエージェントに任せるタスクのガイドをご覧ください。

2つのケースでは、合わない可能性があります。1つ目は、「登録するだけで使える」と期待する場合です。Hermesはインストールしてモデルに接続する必要があります。コマンド1つで済みますが、ターミナルを開く必要はあります。2つ目は、適切なモデルを持っておらず、サブスクリプションやAPIキーを調べたくもない場合です。

それ以外の方は、小さく始めましょう。インストールしてモデルを選び、問題なく会話を1回行い、それからTelegramボットを追加します。スケジュールやサブエージェントを追加するのは、その後です。

Hermes Agentについて、ほかによくある質問#

詳しい情報はAilootをご覧ください。