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

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

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

機能面では、OpenClawに非常によく似ています。OpenClawもまた、ツール、メモリ、ローカルコントロールを核とした自己ホスト型アシスタントスタックです。2026年4月にAnthropicがOpenClawのClaudeサブスクリプションへのアクセスをブロックしたため、多くの開発者がHermesに流れ込みました。なぜHermesが、プロバイダーへの依存なしに持続的で自己ホストされた自動化を求めるユーザーにとって自然な受け皿となったのかは、OpenClawの台頭と没落のタイムラインで解説しています。

Hermesを取り巻く自己ホスト型アシスタント、検索、ローカルインフラストラクチャ全体像を知りたい場合は、AIシステムの概要が、Hermesが解決しようとしているのと同じ問題群に関連するトピックを整理しています。HermesとOpenClawを参照実装として、LLM、メモリ、ツール、ルーティング、観測可能性から成る5層のアシスタントモデルについては、AIアシスタントのアーキテクチャをご覧ください。具体的な採用データ（GitHubスター数、OpenRouterの1日あたりのトークン量、PyPIのダウンロード数、CVE履歴、Redditコミュニティの反応）については、OpenClaw vs Hermes Agent: スター数、ダウンロード数と2026年の利用状況で、Hermesが計測可能なすべての指標において19の代替案と比較してどのように位置づけられているかを追跡できます。

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

ノートPC上の個人用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つの仕事を担います：ターミナルツールの確認と、権限プロンプトの検証です。

プロンプトの例：

Show my disk usage and the five largest directories.

もし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はまた、${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はより深い記憶のための外部メモリプロバイダーも使用できます。メモリドキュメントは複数のプロバイダープラグインをリストし、メモリプロバイダーガイドは対話型セットアップフローを文書化しています。メモリアーキテクチャがどのように機能するかについての完全な技術的分解（凍結スナップショット、文字数制限、外部プロバイダー、および限界付きメモリの哲学）については、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時間365日アクセスのためのメッセージングゲートウェイ

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

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

マルチエージェントのバックログと制御されたスケジューリングについては、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の下に保存されたファイルをテールします。

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

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