2026年に Hermes Agent のインストールを追いかけ、PATH・API Key・Telegram グループ無応答で止まる開発者向けに、再現可能な手順をまとめました。公式 curl 一行インストールから hermes setup でモデル設定、hermes gateway で Telegram 接続、launchd/systemd による 7×24 常駐までを扱い、macOS・Linux・クラウド Mac をカバーします。五つのつまずき、四プラットフォーム比較表、六ステップ実践、よくあるエラー対照表が得られます。三層メモリ30日体験 と併読してください。
01

2026年の Hermes Agent とは?OpenClaw との違い

Hermes AgentNous Research が 2026 年に公開した MIT ライセンスの自律 Agent です。プロセスは長期常駐し、タスク成功後に手順を ~/.hermes/skills/ の Skill として保存するため、同種タスクのトークン消費が下がります。一度きりの ChatGPT ウェブ会話とは異なり、マシン上に常駐するエンジニアのように Telegram から指示を受け、シェル実行・検索・リポジトリ変更をバックグラウンドで行います。

OpenClaw との比較では、OpenClaw はメッセージチャネル Gateway と workspace ファイルが中心で、openclaw CLI 周辺のエコシステムが発達しています。Hermes は Closed Learning Loop(自進化 Skill)、三層メモリ(セッション / MEMORY.md / USER.md)、MCP 拡張を重視します。LangGraph や CrewAI のようなマルチ Agent オーケストレーションと比べ、Hermes は個人・小チーム向けの単機常駐アシスタントに寄せており、入口は公式スクリプト一行です。

本稿は「なぜ 7×24 が要るか」(メモリ構造の記事参照)を繰り返さず、入る・通る・Telegram が返る・サービスが常駐することに集中します。macOS ローカル、Linux VPS/WSL2、KVMNODE クラウド Mac の本番配置を想定しています。

01

PATH 未更新:直後に hermes を打つと command not found。Shell の reload が必要です。

02

API Key 未設定:hermes setuphermes model を省略すると API key not set になります。

03

ノートPCのスリープ:蓋を閉めると Gateway が落ち、Telegram が溜まり Skill は増えるのに複利が止まります。

04

グループのプライバシー:Bot は既定で / コマンドのみ。BotFather で Group Privacy を切らないと「壊れた」と誤解します。

05

ヘッドレス依存不足:Linux で --skip-browser なし、またはシステム Python 使用で ModuleNotFoundError が出ます。

まず配置プレーンを選び、続いて六ステップのコマンドに進みます。

02

Hermes Agent はどこに置く?MacBook、VPS、月額 Mac Mini?

公式インストールスクリプトは macOS と Linux で最も検証されています。uv、Python 3.11、Node.js 22、ripgrep、ffmpeg を自動導入し、リポジトリは ~/.hermes/hermes-agent/ に配置されます。API と Gateway のみなら 4GB メモリで足ります。ローカルモデルやブラウザ自動化 Skill には 16GB 以上を推奨します。

配置プレーン7×24 可用性公式パス完全度Skill 複利月額コスト感
個人 MacBookスリープで断(約60%)高(macOS)頻繁に中断ハード0円+運用不安
Raspberry Pi 4B 8GB約88%Linux、Metal なしI/O ボトルネックハード一括
x86 VPS 4GB約99.5%Linux、macOS Skill 制限比較的安定従量課金
月額 Mac Mini M4データセンター SLA、約100%最高(launchd + UMA)継続蓄積固定 OpEx、返却可

インストール手順は「動かす」、プラットフォーム選定は「どれだけ動かすか、Skill が複利するか」を決めます。本番 Telegram アシスタントには macOS 専有ノードを推奨します。

03

一行インストールと環境チェック:curl、doctor、setup

公式推奨の一行インストール(macOS / Linux / WSL2 / Termux):

shell
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes doctor
hermes --version

スクリプトは uv の検出・インストール、uv 経由の Python 3.11(sudo 不要)、Node.js 22・ripgrep・ffmpeg、~/.hermes/hermes-agent/ へのクローン、hermes の PATH 追加、デフォルト Skills レジストリ取得を行います。成功時は Hermes Agent installed at ~/.hermes 相当のメッセージが出ます。

ヘッドレスサーバーではブラウザスタックを省略します:

shell
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser

hermes doctor は Python、Node、ripgrep、ffmpeg、PATH、API Key など十数項目を自检します。モデル設定はウィザードまたは個別コマンドです:

shell
hermes setup
hermes model
hermes config set OPENROUTER_API_KEY sk-or-xxxx
hermes

キーは ~/.hermes/.env に保存します。Nous Portal、OpenRouter、Anthropic、OpenAI、GitHub Copilot、Ollama などに対応します。CLI で会話確認後に Gateway を起動する流れが安全です。

ヒント:アップグレード後に Missing config と出たら hermes config check && hermes config migrate を実行してください。システム Python ではなく ~/.hermes/hermes-agent/venv/bin/hermes を使います。

04

六ステップで Telegram 接続と 7×24 常駐

01

Bot 作成:Telegram で @BotFather、/newbot、Token を控える。@userinfobot で自分の数値 ID を取得します。

02

Gateway ウィザード:hermes gateway setup で Telegram を選び、Token と TELEGRAM_ALLOWED_USERS を設定します。

03

フォアグラウンド試行:hermes gateway を起動し、スマホから Bot に送って応答を確認します。

04

デーモン登録:macOS は hermes gateway install && hermes gateway start。Linux は sudo hermes gateway install --system も利用できます。

05

グループ(任意):BotFather で Group Privacy をオフにし、Bot を一度外して再招待。そうでないと / コマンドのみ応答します。

06

クラウド Mac 発注:7×24 と macOS Skill パスが必要なら 注文ページ で専有 M4 をレンタルし、SSH で同コマンドを実行。返却前に ~/.hermes/ をアーカイブします。

shell
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
journalctl -u hermes-gateway -f

クラウド移行は 30日移行チェックリスト を参照してください。skills、.env、config.yaml をバックアップし、新ノードで再インストール後にディレクトリを戻すだけで足ります。

05

環境要件、Skill 複利、よくあるエラー

引用しやすい三つの目安:① 公式スクリプトは Python 3.11 + Node 22 を固定取得し、ディスクは Skills キャッシュ込みで約 1.5GB、ローカルモデルは 20GB SSD+ を確保。② コミュニティ報告では Skill ヒット後トークンが約 38% 減る例があり(前提はホスト 7×24 オンライン)。③ 2026年6月の安定版は v0.14.x が多く、v0.15 候補へ上げたら hermes config migrate を必ず実行します。

エラー原因対処
command not foundPATHsource ~/.zshrc
API key not setモデル未設定hermes model
グループ無応答プライバシーモードBotFather で Privacy オフ、Bot 再招待
dotenv 不足システム Pythonvenv 内 hermes

代替案の整理:スリープする MacBook は入るが Gateway を守れない。安価 Linux VPS は Telegram は動くが macOS ブラウザ自動化・Metal ローカル推論は欠ける。Raspberry Pi は I/O とメモリが長セッション SQLite に耐えにくい。KVMNODE で専有 Mac Mini M4 を月額レンタルすれば launchd 常駐・UMA で Gateway と任意ローカルモデルを載せ、SSH でもローカルと同じ手順で入れられます。月額 OpEx で 30 日検証してから購入判断するのが、Skill 複利を狙うチームには「たまに起動のノートPC」より現実的です。料金は 料金ページ、納品とネットワークは ヘルプセンター をご覧ください。