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

Hermes Agentのインストールと開発者向けクイックスタート

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

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

Hermesを取り巻くセルフホスト型アシスタント、検索、およびローカルインフラストラクチャのより広範な概要については、AIシステムの包括的な概要をご覧ください。ここでは、Hermesが解決しようとしている問題と関連するトピックが紐付けられています。

デプロイメントのトレードオフやランタイムの選択については、2026年のLLMホスティング：ローカル、セルフホスト、およびクラウドインフラストラクチャの比較でホスティングの地図を提供し、2026年のLLMパフォーマンス：ベンチマーク、ボトルネック、および最適化では、Hermesが稼働した後のスループットとレイテンシの側面をカバーしています。シェルコマンド（hermes gateway、hermes memory、hermes doctor、スラッシュショートカットなど）のコンパクトなマップが必要な場合は、Hermes Agent CLIチートシートをご利用ください。

peronal-ai-assistant on laptop

個人的な見解として：Hermesは、たまに開くタブではなく、インフラストラクチャとして扱う際に最も興味深いものです。サービスとして実行され、安定したホームディレクトリを持つようになると、プロンプトは「チャット」のように見えなくなり、「運用（ops）」のように見えるようになります。

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

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

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

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

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

コストとライセンスは、ほっとするようなほどシンプルです。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 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つのディレクトリが、関心のあるエージェントステートの大部分をキャプチャするため、バックアップが容易になります。

設定の優先順位と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は、config.yaml内での環境変数置換も${VAR_NAME}構文を通じてサポートしています。これは、構造化された設定で参照しながら、特定の値を環境内で保持したい場合に便利です。

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

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アシスタントスキル：本番環境セットアップ向けをご覧ください。SKILL.mdファイル自体の作成やデバッグ（YAMLメタデータ、段階的開示レベル、条件付き可視性、およびハブインストール）に準備が整ったら、Hermes Agentスキルオーサリング — SKILL.md構造とベストプラクティスを使用してください。

典型的なワークフロー

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

安定したベースライン

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

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

複利のように積み重なる日常の使用

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

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

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

24時間365日のアクセスのためのメッセージングゲートウェイ

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

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

マルチエージェントのバックログや制御されたスケジューリングについては、Hermes AgentにおけるKanban：セルフホスト型LLMワークフロー向けをご覧ください。ここでは、ディスパッチャーの制限、依存チェーン、およびcronベースのバッチングをカバーしています。

ツールを使用するボットのセキュリティは重要です。ゲートウェイドキュメントでは、特定のプラットフォーム向けの許可リストと、ワンタイムペアリングコードを発行し、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下にあるファイルをTAILします。

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変数の欠落など、バックエンドごとの典型的な原因を指し示しています。また、サンドボックス設定に疑問がある場合、ローカルへのフォールバックは有効なデバッグ手段であることを注記しています。

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