Hermes AI アシスタント - インストール、設定、ワークフロー、およびトラブルシューティング

Hermes Agent（ヘルメス エージェント）は、ローカルマシンまたは低コストのVPSで動作する、モデル非依存の自己ホスト型AIアシスタントです。ターミナルおよびメッセージングインターフェースを通じて動作し、繰り返し行うタスクを再利用可能なスキルに変換することで、時間とともに性能を向上させていきます。

その機能性は、ローカルLLM、検索、メモリ、ルーティング、そして可観測性を統合した堅牢なローカルインフラストラクチャを構築する別の自己ホスト型アシスタントスタックであるOpenClawと非常に似ています。多くの開発者は、2026年4月にAnthropicがOpenClawのClaudeサブスクリプションアクセスをブロックした後にHermesを見つけました。OpenClawの台頭と衰退のタイムラインは、プロバイダーへの依存なしで永続的な自己ホスト型自動化を求めるユーザーにとって、Hermesが自然な移行先となった理由を説明しています。

Hermesを取り巻く自己ホスト型アシスタント、検索、ローカルインフラストラクチャのより広範な概要を知りたい場合は、AIシステムの概要で、Hermesが解決しようとしている問題と関連するトピックを紐解くことができます。

デプロイのトレードオフやランタイムの選択について、LLMホスティング in 2026: ローカル、自己ホスト型、クラウドインフラストラクチャの比較がホスティングのマップを提供し、LLMパフォーマンス in 2026: ベンチマーク、ボトルネック、および最適化がHermes稼働後のスループットとレイテンシ側面をカバーしています。

私なりの偏った見解ですが、Hermesは「たまに開くタブ」としてではなく、「インフラストラクチャ」として扱う場合に最も興味深いです。サービスとして動作し、安定したホームディレクトリを持てば、あなたのプロンプトは「チャット」から「運用（ops）」へと変化していくでしょう。

Hermes Agentとは、そしてそれがなぜ重要なのか

Hermes AgentはNous Researchによって開発されたオープンソースのAIエージェントです。永続的に動作し、ツール（ターミナル、ファイル、Webなど）を使用し、スキルとメモリシステムによって自身の行動を時間とともに改善するように設計されています。

このガイドの残りの部分を形作る2つの設計上の選択について、詳しく説明する価値があります。

第一に、Hermesは単一のモデルプロバイダーにロックインされません。公式のセットアップフローは複数のプロバイダーおよびOpenAI互換のエンドポイントをすべてサポートしており、コードの編集ではなく hermes model コマンドを通じて切り替えが可能です。

第二に、Hermesは「会話」と「実行」の間で明確な線を引きいます。エージェントは1日中話をすることはできますが、行動が必要な場合は、明示的なツールと構成可能な実行バックエンドを通じてそれを行います。安全性、再現性、トラブルシューティングはここで扱われます。

コストとライセンスは新鮮なほど退屈なものです。Hermes Agent自体はMITライセンスに基づくフリーソフトウェアです。ホスト型モデルを使用する場合、継続的なコストはプロバイダーが請求する金額になります。ローカルモデルを実行する場合、API料金を完全に回避することができます。

Hermesのセットアップが外部ツール層を通じてClaudeを使用している場合、このAnthropicのサブスクリプション変更は、APIベースの課金が行の標準的なパスとなった理由についての有用な参考文献です。

Hermes Agentのインストール

Hermesには、Linux、macOS、WSL2向けの高速なインストールパスがあります。公式ドキュメントは意図的にシンプルさを保っています。

LinuxでのHermesのインストール

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

インストール後、シェルをリロードし、CLIを起動します。

source ~/.bashrc   # または source ~/.zshrc
hermes

インストーラーは単なる薄いラッパーではありません。インストールガイドによると、依存関係、リポジトリ、仮想環境、および hermes コマンドを設定し、最初のチャット準備状態に導きます。

WindowsとAndroidに関する注意点

ネイティブWindowsはサポートされていません。ドキュメントではWSL2の使用を推奨し、その中でHermesを実行することを示しています。

Androidの場合、HermesはTermuxでのインストールパスをサポートしています。Termuxを検出し、それに合わせて依存関係と環境設定を適応させるように設計されています。

クイックスタート

最も早い初回実行は単に hermes と入力するだけですが、意味のあるクイックスタートには、使用するモデルプロバイダーと有効にするツールの2つの追加の決定が必要です。

プロバイダーとモデルの選択

Hermesは3つの補完的なエントリーポイントを公開しています：

• hermes model でプロバイダーとデフォルトモデルを選択
• hermes tools でツールセットの有効化または無効化
• hermes setup で主要な設定領域にわたるインタラクティブなウィザードを実行

最小限のフローは以下のようになります：

hermes model
hermes tools
hermes

実際にサポートされているものに関して、公式クイックスタートは幅広いプロバイダーを一覧表示し、HermesがOpenAI互換APIで動作することにも言及しています。これは、ホスト型サービスと自己ホスト型エンドポイントの両方を含むため、重要です。

早期のツール実行の検証

Hermes回りの習慣を築く前に、環境でツール使用が機能するかを確認する価値があります。クイックスタートでは、最初の試す機能としてターミナルの使用を明確に提案しています。

実際には、小さな「スモークテスト」プロンプトは2つの役割を果たします：ターミナルツールをチェックし、権限プロンプトを検証します。

例のプロンプト：

ディスクの使用状況と、最も大きな5つのディレクトリを表示してください。

Hermesがターミナルツールを実行できない場合、トラブルシューティングに進んでください。ターミナルバックエンドの誤設定は最も一般的な原因の一つであり、設定を見ると修正方法が通常明らかになります。

拡張性に優れた設定

Hermesは、状態の保存場所と設定の解決方法を理解する人を報います。これもまた、多くの「昨日は動いていた」問題が発生する場所です。

設定と状態の保存場所

Hermesは設定と状態を ~/.hermes 以下に保存します。公式設定ガイドは、設定用の config.yaml、シークレット用の .env、OAuth認証情報用の auth.json、アイデンティティ用の SOUL.md、およびメモリ、スキル、cron、セッション、ログ用のフォルダを含むレイアウトを文書化しています。

これが重要な理由は2つあります。

• 正確にどこを調べるべきか知っているため、デバッグは機械的になります。
• 1つのディレクトリがケアしているエージェント状態の大部分をキャプチャするため、バックアップが straightforward（簡単）になります。

設定の優先順位と config.yaml からのシークレットの分離

Hermesは優先順位順序で設定を解決します。最上部はCLIオーバーライド、次に config.yaml、次に .env、そして最下部はビルトインデフォルトです。

良い詳細は、hermes config set が値を正しいファイルにルーティングすることです：APIキーは .env へ、非シークレット設定は config.yaml へ。

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermesは、${VAR_NAME} 構文を使用して config.yaml 内の環境変数置換もサポートしています。これは、構造化された設定でそれらに参照しながら、特定の値を環境内に保持したい場合に便利です。

サンドボックスと実行バックエンド

Hermesは、シェルコマンドが実際に実行される場所を定義する複数のターミナルバックエンドをサポートしています。設定ガイドは、local、docker、ssh、modal、daytona、singularityを一覧表示しています。

意見がありますが、伝道的ではない考え方は以下の通りです：

• local は最も速くシンプルですが、分離されていません
• docker は実用的な安全性と再現性のレイヤーです
• ssh はチャットデバイスと計算ボックスを分離するクリーンな方法です
• modal と daytona は「サーバーレスだが十分に永続的な」ワークフローに適合します
• singularity はHPC（高性能計算）フレンドリーなオプションです

最小限のDockerバックエンド例：

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

ドキュメントはまた、Dockerバックエンドのセキュリティ強化（機能のドロップや特権エスカレーションの無効化など）についても説明しています。

スキル、メモリ、プロファイル

Hermesには、価値を複利で増やすための2つの関連メカニズムがあります。

スキルは手続き型メモリです。Hermesは自身のスキルを作成、更新、削除でき、複雑なタスクを完了した後、アプローチをスキルとして保存するよう提案できます。

ビルトインメモリは ~/.hermes 以下の MEMORY.md や USER.md などのファイルとして保存され、Hermesはより深い想起のために外部メモリプロバイダーも使用できます。メモリドキュメントは複数のプロバイダープラグインを一覧表示し、メモリプロバイダーガイドはインタラクティブなセットアップフローを文書化しています。メモリアーキテクチャがどのように機能するか（凍結スナップショット、文字数制限、8つの外部プロバイダー、および境界付きメモリ背後の哲学）についての完全な技術的解説は、Hermes Agentメモリシステム：永続的なAIメモリが実際にどのように機能するかをご覧ください。

同じマシン上で複数の独立したエージェントが必要な場合、Hermesプロファイルは分離を提供します。各プロファイルは、独自の設定、シークレット、メモリ、セッション、スキル、cronジョブ、およびゲートウェイ状態を持つ独自のディレクトリを取得します。

役割（エンジニア、研究者、オペレーター、およびエグゼクティブワークフロー）によって本番環境でよく機能するスキルについてのより深い見解は、Hermes AIアシスタントスキル：実際の本番設定用をご覧ください。

典型的なワークフロー

Hermesを維持するエージェントとして扱う場合、ワークフローはサービスエンジニアリングのように見えてきます。

安定したベースライン

腐りにくいベースラインは以下の通りです：

1. CLIでインストールし、最初のチャットを実行。
2. hermes model でプロバイダーとモデルを選択し、コストを確認。
3. ツールセットを構成し、ターミナル実行がローカルかサンドボックス化されているかを決定。
4. デフォルトをしばらく使用してから、SOUL.md のみを軽く変更。アイデンティティの変更は、システムプロンプトの「スロット1」であるため、人が予想する以上に重要です。

複利で増加する日常使用

HermesにはWeb UIではなくターミナルUIがあり、スラッシュコマンド、再開可能なセッション、ストリーミングツール出力を備えた長時間セッションのために設計されています。

実際には、有用なリズムは以下の通りです：

• プロジェクト用に命名されたセッションで作業を実行
• コンテキストが大きくなりすぎたときに圧縮
• Hermesに繰り返しのルーチンをスキルに変換させる
• 「聞く」と「行動する」の間に精神的な境界を維持し、ツール実行が監査可能であることを保つ

24/7アクセスのためのメッセージングゲートウェイ

メッセージングゲートウェイは、Hermesをターミナルアプリではなくアシスタントのように感じさせる部分です。ドキュメントでは、複数のプラットフォームに接続し、セッションを処理し、cronジョブを実行し、メッセージを配信する単一のプロセスと説明しています。

セットアップは hermes gateway setup を通じて呼び出され、ゲートウェイはフォアグラウンドまたはユーザーサービスとして実行できます。CLIリファレンスは、run、install、start、stop、status、restart などのゲートウェイサブコマンドを文書化しています。

ツールを使用するボットのセキュリティは重要です。ゲートウェイドキュメントは、特定のプラットフォーム用のホワイトリストと、一度きりのペアリングコードを発行し、hermes pairing approve による承認を必要とするDMペアリングフローを説明しています。

劇的な更新なし

Hermesの更新はファーストクラスのコマンドです。更新ガイドは hermes update、設定マイグレーションチェック、および hermes doctor と hermes gateway status を含む小さな更新後の検証ルーチンを文書化しています。

hermes update
hermes doctor
hermes gateway status

トラブルシューティングと診断

ほとんどのHermesの失敗は神秘ではありません。神秘に見えますのは、人々がモデルレイヤーのみをチェックし、ランタイムレイヤーを無視するためです。

迅速なトライアージコマンド

CLIリファレンスは、3つのコマンドをコアループとして明確に位置づけています：

• インタラクティブな診断用の hermes doctor
• 迅速な概要用の hermes status
• 共有可能で情報を隠去したセットアップサマリー用の hermes dump

ログについては、hermes logs は ~/.hermes/logs 以下に保存されているファイルをテールします。

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

一般的なインストール失敗

FAQとトラブルシューティングガイドは、Pythonのバージョン問題、uvが見つからない、sudoインストールとユーザーインストールを混合することによる権限問題など、いくつかの再発する問題とその修正を一覧表示しています。

これらのエラーが発生した場合、ドキュメントはPythonのアップグレード、uvのインストール、sudoなしでのHermesの再インストールなどの具体的な修復手順を提供しています。

プロバイダーとモデルの問題

APIキーが機能しない場合、FAQは設定の確認、hermes model の再実行、または hermes config set を通じたキーの直接設定を推奨しています。また、キーはプロバイダー固有であるという一般的な落とし穴にも言及しています。

「モデルが見つかりません」の問題について、FAQは hermes model を使用して有効な識別子を選択するよう指摘し、設定とセッションごとのオーバーライドの両方を示しています。

レート制限とコンテキスト長の問題もカバーされています。FAQは429エラーが発生した場合の待機、プロバイダーまたはモデルへの切り替え、および圧縮または新しいセッションによるコンテキストプレッシャーの低減を提案しています。

ターミナルバックエンドとゲートウェイの問題

ターミナルコマンドが直ちに失敗する場合、設定ガイドには「一般的なターミナルバックエンドの問題」セクションが含まれ、Dockerが実行されていないことやSSH変数の欠落など、バックエンドごとの典型的な原因を指摘しています。また、サンドボックス設定に疑問がある場合、ローカルへのフォールバックは有効なデバッグ手順であると注記しています。

ゲートウェイの問題について、メッセージングガイドはホワイトリストとペアリングを安全なデフォルトとして強調しており、これは多くの「ボットが沈黙している」事件は実際には認可が機能していることによるものであることを意味します。

参考文献

• Hermes Agent ホームページ
• Hermes Agentメモリシステム：永続的なAIメモリが実際にどのように機能するか
• Hermes AIアシスタントスキル：実際の本番設定用