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

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

Hermes Agentは、セルフホスティングでモデル非依存型のAIアシスタントであり、ローカルマシンや低コストのVPS上で動作します。ターミナルとメッセージングインターフェースを通じて利用可能で、反復されるタスクを再利用可能なスキルに変換することで、時間が経つにつれてパフォーマンスが向上します。

機能としては、OpenClawと非常に似通っており、ツール、メモリ、ローカル制御を中心に構築されたもう一つのセルフホスティング・アシスタントスタックです。多くの開発者が、Anthropicが2026年4月にOpenClawのClaudeサブスクリプションへのアクセスをブロックしたことでHermesに至りました。なぜHermesが、プロバイダーへの依存なしに永続的なセルフホスティング自動化を望んでいたユーザーにとって自然な移行先となったのかは、OpenClawの興亡のタイムラインで説明されています。

Hermes周辺のセルフホスティングアシスタント、検索、ローカルインフラストラクチャの全体像を把握したい場合は、AIシステムの概要をご覧ください。これらのトピックは、Hermesが解決しようとしている問題と同じものに関連しています。5層構造のアシスタントモデル（LLM、メモリ、ツール、ルーティング、観測可能性）について、HermesとOpenClawを参照実装として詳しく知りたい場合は、AIアシスタントアーキテクチャを参照してください。具体的な採用データ（GitHubスター数、OpenRouterの毎日トークン量、PyPIのダウンロード数、CVE履歴、Redditコミュニティのセンチメント）については、OpenClaw vs Hermes Agent: 2026年のスター数、ダウンロード数、利用率で、Hermesが19の代替品とどのように比較されるかを追跡しています。

デプロイメントのトレードオフやランタイムの選択については、2026年のLLMホスティング: ローカル、セルフホスティング、クラウドインフラの比較がホスティングマップを提供し、Hermesが動作し始めたら、スループットとレイテンシの側面については、2026年のLLMパフォーマンス: ベンチマーク、ボトルネック、最適化を参照してください。OllamaなどのローカルランタイムでQwenやGemmaをHermesに割り当てるのが一般的な場合は、マルチステップツール使用のための温度とペナルティのプリセットを統合するために、QwenとGemma用のエージェント型LLM推論パラメータを使用してください。シェルコマンド（hermes gateway、hermes memory、hermes doctor、スラッシュショートカットなど）のコンパクトなマップには、Hermes Agent CLIチートシートを使用してください。主なエントリポイントがモバイルでのメッセージングである場合は、スマートフォンからのHermes音声コントロールで音声スタックとプラットフォーム固有の設定を行ってください。

peronal-ai-assistant on laptop

私の偏った意見：Hermesが最も興味深いのは、それらをインフラストラクチャとして扱うときであり、ときどき開くタブとして扱うときではありません。サービスとして動作し、安定したホームディレクトリを持つようになった時点で、プロンプトは「チャット」らしくなくなり、「運用」らしくなってきます。

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、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はより深い想起のために外部メモリプロバイダーも使用できます。メモリドキュメントには複数のプロバイダープラグインがリストされ、メモリプロバイダーガイドはインタラクティブなセットアップフローを文書化しています。メモリアーキテクチャがどのように機能するか（凍結スナップショット、文字制限、外部プロバイダー、有界メモリを支える哲学）について完全な技術分解を見るためには、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 Agent CLIチートシートにあります。

実際には、有用な頻度は次のとおりです：

プロジェクトのために名前付きセッションで作業を実行する
コンテキストが大きくなりすぎたときに圧縮する
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変数が欠けているなど）を指しています。また、サンドボックス設定が問題である場合、ローカルへのフォールバックは有効なデバッグ方法であることも述べられています。

ゲートウェイの問題については、メッセージングガイドはホワイトリストとペアリングを安全なデフォルトとして強調しています。つまり、多くの「ボットが沈黙している」インシデントは、実際には認証化がその仕事を果たしているということです。