チャットだけでなく実際のワークフロー自動化のためにHermes Agentをセットアップする方法

エージェントはどこに住めばよいですか?

コマンドを実行する前に、構築する Herme エージェントの種類を決定してください。トップラップパーソナル上のインデックスアシスタントは、VPS 上で実行されるチーム Telegram ボットとは大きく異なります。

「Hermes Agent をインストールするにはどうすればよいですか?」という質問が寄せられます。 「このエージェントにはどのような権限が必要ですか?」という質問のほうが正しいです。

シンプルなメンタルモデルは次のことに役立ちます。

flowchart TD
    A[User request] --> B[Hermes Agent]
    B --> C[Model provider]
    B --> D[Tools and skills]
    B --> E[Terminal backend]
    B --> F[Messaging gateway]
    E --> G[Local machine, Docker, SSH, or cloud sandbox]
    F --> H[Telegram, Slack, Discord, Email, etc.]

モデルの理由。ツールが機能します。ゲートウェイは指示を受け取ります。端末のバックエンドが爆発範囲を決定します。これらの要素を間違った順序で構成すると、境界が不明瞭な強力なエージェントが作成されます。

ヘルメスエージェントがうまく機能するために実際に必要なこと

便利なエルメスのセットアップには5つのものが必要です。マルチステップのワークフローに十分なコンテキストを備えたモデルが必要です。すべてのリクエストが認証エラーで失敗しないように、クリーンなセットアップー構成が必要です。理解させたいファイルまたはプロジェクトを含む作業ディレクトリが必要です。タスクのリスクレベルに一致するツールの権限が必要です。また、CLI、デスクトップインターフェイス、メッセージングプラットフォームのいずれであっても、配信チャネルが必要です。

Telegram、cron、MCP サーバー、またはカスタム スキルから始めるのではありません。単純な端末の会話から始めます。それが機能したら、一度に 1 つのレイヤーを追加します。

これは私が推奨するセットアップ手順です。まず、Hermes をインストールし、コマンドが機能することを確認します。次に、モデルプロバイダーを構成します。次に、基本的なチャットを実行します。その後、テストセッションが再開されます。次に、必要なツールのみを有効にします。次に、エージェントがコマンドを実行する場合は、Docker または SSH 分離を追加します。次に、メッセージング ゲートウェイに接続します。最後に、スキル、cron ジョブ、または MCPサーバーを追加します。この順序は遅く感じられますが、時間を節約できます。何かが確保された場合、どの層が原因かを知ることができます。

ステップ1:Hermesエージェントをインストールする

Linux、macOS、WSL2、またはTermux経由のAndroidの場合、コマンドラインのインストールパスは簡単です。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

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

source ~/.bashrc   # or source ~/.zshrc
hermes

ネイティブ Windows では、PowerShell を使用します。

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

macOS または Windows でのデスクトップ体験を希望する場合は、CLI のみを使用する代わりに、Hermes デスクトップ インストーラーを使用してください。 CLI は、特にデバッグには便利ですが、デスクトップのエントリポイントは、ターミナルを使用していないユーザーにとっての負担を軽減できます。

シンプルで検証可能なプロンプトを試してください。

Check the current directory and tell me what files look important.
Do not modify anything.

これは、Hermes が応答し、コンテキストを検査し、保守的に動作できるかどうかをテストします。

ステップ 2: ツールを追加する前にモデルプロバイダーを選択してください

プロバイダーのステップでは、多くのセットアップが静かに失敗します。エルメスはさまざまなプロバイダーやカスタム エンドポイントをサポートできますが、最初の目標は保留な信頼性である必要があります。

hermes model これは、アクティブなエルメス チャット セッション以外で使用してください。これはプロバイダーのセットアップ ウィザードと考えてください。ここで、API キーの追加、OAuth フローの実行、当面モデルの選択、またはカスタム エンドポイントの構成を行います。

一般的な失敗パターンは、技術的には応答するものの、複数ステップのエージェントの作業に十分なコンテキストまたはツール呼び出しの信頼性がない、ローカルまたはセルフホストのエンドポイントを使用していることです。結果は明らかなクラッシュではありません。エージェントはただ奇妙な動作をしたり、コンテキストをすぐに忘れたり、不十分なツール プランを作成したりします。最初のセットアップでは、安定したプロバイダーを 1 つ選択し、ルーティングをシンプルに保ちます。 1 つのプロバイダーが正常に動作するまで、マルチプロバイダー フォールバックを追加しないでください。

hermes model
hermes

Summarize your current configuration at a high level.
Tell me which model provider is active and which tools are available.

まだ知能をテストしていません。構成をテストしています。

ステップ 3: 最初のチャットをスモークテストのように実行する

最初のチャットは、野心的な自動化リクエストであってはなりません。煙の検査をする必要があります。適切な最初のプロンプトは、具体的でリスクが低く、検証が簡単なものです。

Summarize this repository in five bullets.
Identify the likely main entrypoint.
Do not edit any files.

または：

Look at the current project structure.
Tell me how you would run the tests, but do not run them yet.

これにより、Hermes にはそのコンテキストを使用するための十分な意見が与えられますが、何かを損傷するのに十分な権限はありません。それがどのように動作するかを見てください。 hermes --continue以前の会話が正しく再開された場合は、使用可能な基本セットアップが完了しています。そうでない場合は、ゲートウェイ、cron、スキル、または統合を追加する前にそれを解決してください。

ステップ 4: ツールへのアクセスを意図的に構成する

ヘルメスは行動できると便利になります。そういう時もリスクが伴います。 hermes tools ワークフローに基づいたツールを有効にします。挿入アシスタントの場合、ファイルの読み取り、ファイルの編集、検索、および端末へのアクセスがあれば十分な場合があります。研究助手の場合、Web 検索、ファイル作成、概要の方が重要な場合があります。チームボットの場合、配信と制限されたコマンドの実行が優先される場合があります。

実際的なルール: ジョブを完了できる最小のツール面をエージェントに提供します。エージェントにターミナルアクセスが必要な場合は、エージェントをローカルで実行するか、Docker で実行するか、SSH 経由で実行するか、または別のサンドボックスで実行する議論を決定します。 最も本格的なワークフローの場合は、Docker の分離 (hermes config set terminal.backend docker) から始めることを好みます。これにより、すべてのアクションが魔法のように安全になるわけではありませんが、コマンドの実行が生のホスト環境から遠ざけられます。これは、エージェントが依存関係を調査したり、スクリプトを実行したり、不明なリポジトリを操作したりするときに重要です。より厳密なプロジェクト設定の場合は、作業ディレクトリを定義し、機密フォルダを手の届かない場所に保管します。エージェントにホーム ディレクトリを指定しないでください。プロンプトによって保護されることを期待してください。

ステップ 5: CLI が動作した後にのみメッセージング ゲートウェイを追加する

hermes はメッセージング プラットフォームをお子様に使用できますが、ゲートウェイは最初のデバッグ サーフェスではなく 2 番目のインターフェイスである必要があります。 CLI が機能したら、hermes gateway setup そこから、必要なプラットフォームを選択します: Telegram、Discord、Slack、WhatsApp、Signal、Email、またはその他のサポートされているチャネル。

適切なメッセージング設定には明確な役割があります。同様に、個人創業者の Telegram ボットは、「今日のリードの概要」や「スクレイパーが実行されたかどうかの確認」を処理する可能性があります。

避けてはいけません、ゲートウェイを無制限のコマンド ポータルにしてしまうことです。 複数の人が同じ反対にメッセージを送信できる場合、アクセス制御はオプションではありません。 ホワイトリストを使用します。 広範な「すべてのユーザーを許可する動作」は避けてください。 ゲートウェイ プロセスを root 以外のユーザーとして実行し続けます。

hermes gateway setup
hermes gateway

永続的なセットアップの場合は、フォアグラウンド モードが機能した後にのみサービスとしてインストールします。そうすることで、エラーがバックグラウンドでサイレントエラーになる前に、エラーを確認できます。

ステップ6: 繰り返しのワークフローにスキルを使う

ヘルメスが一般的なアシスタント以上の存在となるのは、スキルです。スキルは、エージェントに定期的なタスクの再利用可能な手順を提供します。たとえば、次のような長いプロンプトを繰り返し記述する代わりに、次のようにします。

When reviewing a pull request, first inspect the diff, then identify risky files,
then run relevant tests, then summarize security, performance, and regression risks.

ワークフローを一度エンコードするスキルを使用または作成できます。スキルを参照: hermes skills browse。トピック: hermes skills search kubernetes を検索します。スキルをインストールします: hermes skills install openai/skills/k8s。インストールすると、スキルはスラッシュ コマンド: /k8s deploy the staging manifest になります。

より深い価値は一貫性です。一般的なプロンプトは、毎回の表現に大きく依存します。スキルにより、Hermes に安定した手順が提供されます。レビュー、展開チェック、リード調査、レポート生成、インシデントのトリアージなどのタスクに特に役立ちます。チームにとって、ここでエージェントのセットアップが運用上の知識になります。このスキルは完全自動化のトリックではありません。これは、チームがどのように仕事を進めたいかを文書化したものです。

ステップ 7: AGENTS.md を使用してプロジェクト コンテキストを追加する

Hermeの出力を改善する最も簡単な方法の1 つは、プロジェクトルールの手動での繰り返しをやめる事です。 AGENTS.md ファイルを作成します。

# Project Instructions
Use Python 3.11.
Run tests with: pytest tests/
Do not edit files under migrations/ unless explicitly asked.
When changing API handlers, update related tests.
Prefer small, reviewable diffs.

次に、そのプロジェクトディレクトリからHermesを起動します。エージェントの品質はモデルではなくコンテキストの問題であることが多いため、これは便利です。Hermesがテストコマンド、一定規則、スタイルルール、および禁止領域を知っていれば、推測する無駄なターンが少なくなります。ファイルは短くしてください。会社のハンドブックにはしないでください。最適なコンテキストファイルは、実用的で最新かつ具体的なものです。

ステップ 8: MCP は、ロックを解除するのかわかっている場合にのみ使用してください

MCP サーバーは、Hermes を外部システムに拡張できますが、最初のインストールの一部として考えるべきではありません。 GitHub 操作、データベース検査、チケット ワークフロー、内部ツール、または特殊な API など、実際に必要な場合に MCP を追加します。

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

操作上は、「Hermesにこれに接続できますか?」ということではありません。それは「接続したらエルメスはできるのか?」です。問題を考えることができる GitHub MCP サーバーはリスクが低いです。リクエストをマージしたり、シークレットを変更したり、デプロイメントをトリガーしたりできるサーバーは、別のカテゴリです。可能な場合は、読み取り専用ツールを書き込みツールから分離します。スコープ付きのパスワードを使用します。行動の前に観察から始めましょう。

常時オンにする前にセットアップを強化する

常時実行のエージェントは便利ですが、便利さリスクがかかります。エルメスを置いて実行する前に、5 つの領域を確認してください。まず、ターミナルの実行: コマンドを実行するワークフローには Docker または SSH 分離を優先します。 2 番目に、シークレット: API キーを目的の環境ファイルに保持し、通常のチャットにシークレットを付けることを避けます。デモをスムーズに行うため承認を無効にしないでください。高速で破壊的なワークフローよりも、少し遅いワークフローの方が優れています。 4 番目に、作業ディレクトリ: マシン全体ではなく、Hermes に制限されたワークスペースを与えます。 5 番目、ゲートウェイ アクセス: 常識的に許可されたユーザーを使用し、一般公開は避けます。

terminal:
  backend: docker
  cwd: /workspace
approvals:
  mode: manual

チーム アシスタントの場合は、専用の非特権ユーザーの下でゲートウェイを実行し、実際の使用の最初の数日間はログを表示し続けます。

毎日の研究報告ボット — 現実的な最初のワークフロー

ここでは、便利ですが無謀ではない、現実的な最初のワークフローを示します。小規模な製品チームが、競合他社のリリース、GitHub のアクティビティ、および関連する技術的な議論について毎日説明を受けたいと考えていると想像してください。ヘルメスは情報を収集し、要約し、その結果をテレグラムに送信する必要があります。コードを変更したり、電子メールを送信したり、デプロイメントをトリガーしたりしてはなりません。

# 1. Configure provider
hermes model
# 2. Verify CLI
hermes
# 3. Restrict terminal execution
hermes config set terminal.backend docker
# 4. Configure Telegram or another gateway
hermes gateway setup
# 5. Start gateway in foreground for testing
hermes gateway

Create a short daily briefing about our market.
Use only public information.
Group the summary into product updates, engineering signals, and risks.
Do not contact anyone or modify any files.

それが機能すると、チームはワークフローをスケジュールされたタスクまたはスキルに変えることができます。重要なのは、ヘルメスがリサーチアナリストに取って代わることではない。重要なのは、分散した小切手を、明確な配信チャネルを備えた反復可能なプロセスに変えることができるということです。

Hermes Agent は、技術ユーザーに強力なセットアップ パスが提供されます。ただし、すべてのユーザーがプロバイダー、ターミナル バックエンド、シェルのリロード、サービス プロセス、ゲートウェイ構成の管理を行っているわけではありません。 EasyClaw 最初のセットアップに 1 時間もかかりません、ローカルアプリ、ファイル、ブラウザー、UI ベースのツール全体デスクトップがワークフローを自動化する目標の場合、EasyClaw は手動の Herme構成と並行して評価する価値があります。私はこれが二者選択の一の決定であるとは考えていません。の方が速いかもしれません。最適な選択はワークフローによって異なります。透過的な構成、カスタム スキル、プロバイダーの柔軟性、サーバー スタイルの展開が必要な場合は、Hermes を正しく学習してください。日常の作業に実用的なデスクトップ オートメーション レイヤーが必要な場合は、セットアップのオーバーヘッドを軽減するツールから始めてください。

一般的なセットアップの問題とその診断方法

エルメスの動作がおかしい場合は、すぐに再インストールしたいという衝動を抑えてください。

エルメスが起動しても応答が弱いか壊れている場合は、hermes model を再実行します。プロバイダー、モデル名、認証、エンドポイントを確認します。

コマンドが見つからない場合は、シェルをリロードするか、パス source ~/.bashrc; which hermes を確認してください。

ゲートウェイが開始してもメッセージが到着しない場合は、プラットフォーム トークン、許可されたユーザー ID、およびゲートウェイのステータス (hermes gateway status) を確認してください。

セッションが再開しない場合は、セッションをリストし、同じプロファイル hermes sessions list; hermes --continue を使用していることを確認します。

すべてが矛盾していると思われる場合は、診断コマンド hermes doctor を実行します。目標は、正常なレイヤーに戻ることです。まずはプロバイダー。 2番目にチャットします。セッション３回目。ツール4番目。 5番目のゲートウェイ。

結論: 能力はゆっくりと成長する

正しいなHermes Agentセットアップは、最も多くの統合を準備したセットアップではありません。それは、あらゆる能力に理由があるということです。まずはクリーンな会話から始めましょう。モデルプロバイダーを1つ追加します。境界のあるワークスペースを1つ追加します。安全なターミナルバックエンドを1つ追加します。メッセージングチャネルを1つ追加します。されるフローを1つ追加します。そしてそこから改善していきます。

インストールコマンドで開始できますが、実際の作業は、正しい選択肢の選択、基本チャットのテスト、ツールアクセスの制御、コマンド実行の分離、ゲートウェイの慎重な構成、繰り返しの作業をスキルやスケジュールされたワークフローに変えることです。実験している場合は、シンプルにしてください。ワークフローを構築している場合は、Docker 分離、プロジェクトチームに構築している場合は、アクセス制御、ログ、コマンドの承認をクリーンアップタスクとしてではなく、製品の一部向けとして扱います。

次の AI エージェントの波は、チャットウィンドウでどれだけ賢く聞こえるかによって判断されることはありません。