Hermes AIアシスタント - インストール、セットアップ、ワークフロー、トラブルシューティング

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

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

機能面では、ツール、メモリ、およびローカル制御を軸として構築されたもう一つのセルフホスト型アシスタントスタックであるOpenClawと非常に似ています。多くの開発者は、Anthropicが2026年4月にOpenClawのClaudeサブスクリプションへのアクセスをブロックしたことでHermesへと流れてきました。Hermesがなぜプロバイダーへの依存関係なしに、永続的なセルフホスト型の自動化を求めるユーザーにとって自然な行き先となったのかは、OpenClawの栄光と没落のタイムラインで説明されています。

Hermesを取り巻くセルフホスト型アシスタント、検索（Retrieval）、およびローカルインフラ全体像を把握したい場合は、AIシステム概要が、Hermesが解決しようとしている問題とそれらのトピックを結びつけています。5層のアシスタントモデル（LLM、メモリ、ツール、ルーティング、オブザーバビリティ）およびその参照実装としてのHermesとOpenClawについては、AIアシスタントアーキテクチャを参照してください。具体的な導入データ（GitHubスター数、OpenRouterの1日あたりトークン量、PyPIのダウンロード数、CVE履歴、Redditコミュニティの感情分析）については、OpenClaw vs Hermes Agent: スター数、ダウンロード数と利用状況 2026が、測定可能なすべてのシグナルにおいてHermesが19の代替案と比較してどのように位置づけられるかを追跡しています。

デプロイメントのトレードオフやランタイムの選択については、2026年のLLMホスティング：ローカル、セルフホスト型、クラウドインフラの比較がホスティングのマップを提供し、2026年のLLMパフォーマンス：ベンチマーク、ボトルネックと最適化がHermes稼働後のスループットとレイテンシの側面をカバーしています。ローカルランタイム（Ollamaなど）上でQwenやGemmaをHermesに頻繁に使用する場合、マルチステップのツール使用における温度やペナルティの設定をまとめ、QwenとGemma向けエージェント型LLM推論パラメータを使用してください。シェルコマンド（hermes gateway、hermes memory、hermes doctor、スラッシュショートカットなど）のコンパクトなマップが必要な場合は、Hermes Agent CLIチートシートを使用してください。メインのエントリポイントがモバイルでのメッセージングである場合は、音声スタックとプラットフォーム固有の設定には、スマホからのHermes音声コントロールを使用してください。

ノートパソコン上の個人用AIアシスタント

私的な見解を述べると：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コマンドを設定し、最初のチャット可能な状態までユーザーを導きます。

ゼロから始めるのではなく、既存のOpenClawデプロイメントから移行する場合は、まず空のHermesをインストールして検証し、その後OpenClawからHermes Agentへの安全な移行方法に従って段階的な切り替えを実行してください。hermes claw migrateはペルソナ、メモリ、スキル、プロバイダー、MCPサーバーをマッピングしますが、cronジョブ、プラグイン、マルチエージェントルーティングは手動で再構築する必要があります。

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（シークレット）、auth.json（OAuth認証情報）、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はより深い想起のために外部メモリプロバイダーも使用できます。メモリドキュメントは複数のプロバイダープラグインを列挙し、メモリプロバイダーガイドはインタラクティブなセットアップフローを文書化しています。メモリアーキテクチャがどのように機能するかの完全な技術的な分析（凍結スナップショット、文字制限、外部プロバイダー、限定メモリ背后的哲学）については、Hermes Agentメモリシステム：永続的なAIメモリが実際に機能する仕組みを参照してください。自動で何を書き込むかを非常に細粒に制御できるローカル、セルフホスト型プロバイダーを求めている場合は、Hermes Agent用Mnemosyne：ローカルメモリクイックスタートを参照し、なぜ保守的な書き込みデフォルトが重要なのかについては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/7アクセスのためのメッセージングゲートウェイ

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

セットアップはhermes gateway setupで呼び出され、ゲートウェイはフォアグラウンドまたはユーザーサービスとして実行できます。CLIリファレンスには、run、install、start、stop、status、restartなどのゲートウェイサブコマンドが文書化されています。専用のサーバーでこのゲートウェイモデルを実行しつつ、別のデスクトップクライアントから接続したい場合は、Hermes Agentヘッドレスサーバーとリモートデスクトップセットアップを使用してください。

マルチエージェントのバックログと制御されたスケジューリングについては、セルフホスト型LLMワークフロー向けHermes Agent Kanbanを参照してください。これは、ディスパッチャー制限、依存関係チェーン、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に保存されたファイルをテールします。

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

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