hermes: command not found の対処は？

~/.local/bin を PATH に追加しシェルを再読み込み。hermes doctor で CLI と Node 版を確認します。

Telegram が返信しない理由は？

launchd/systemd に TELEGRAM_BOT_TOKEN が渡っていない、または古い Webhook が残っている可能性。gateway status を確認します。

ノート PC のふたを閉じると Bot が止まる？

正常です。7×24 には常時オンラインの Mac または VPS が必要です。

2026 Hermes Agent 超入門インストール：macOS / Linux / VPS から Telegram 7×24 まで

Nous Research の Hermes Agent は「ワンライナーで入る」と話題ですが、現場では hermes: command not found、モデル 401、Telegram 無応答で止まるケースが後を絶ちません。本稿はインストールから Telegram 接続までに限定します。公式 install.sh、~/.hermes、hermes setup、BotFather の TELEGRAM_BOT_TOKEN、hermes gateway install を順に踏めば、初日から Bot を常時稼働させられます。永続メモリやハード選定は 20260527・20260528 の記事へ。

1. つまずきやすい三つのポイント

PATH 未反映： ~/.local/bin 直後は hermes が見えない。
対話 shell のみ Key： launchd ゲートウェイに届かず 401 か沈黙。
フォアグラウンド起動： ターミナル終了で Bot 停止。

2. macOS / Linux / VPS 比較マトリックス

項目	macOS（リモート Mac 含む）	Linux / WSL2	クラウド VPS
最低スペック	16GB RAM、30GB ディスク	2 vCPU / 4GB、Ubuntu 22.04+	Linux 同等、swap 注意
推奨	Mac mini M4 16〜24GB、NVMe に ~/.hermes	4 vCPU / 8GB+	固定 IP、8GB+ メモリ
常駐	launchd + スリープ無効	systemd user unit	安定、macOS ツールなし
Telegram	LaunchAgent の EnvironmentVariables	EnvironmentFile + daemon-reload	HTTPS または長時間 outbound

試作は WSL2 可。本番 Telegram は常時 Mac か固定 IP VPS を推奨。

3. 手順1：install.sh 一発導入

macOS・Linux・WSL2（sudo 不要、~/.hermes に保存）：

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

成功：hermes --version と ~/.hermes/config.yaml。30GB 確保。

4. 手順2：hermes doctor

hermes doctor

Node ≥ 20、書き込み権、ポート競合を確認。PATH 警告は rc に ~/.local/bin を追加。

5. 手順3：hermes setup で LLM 設定

hermes setup

config.yaml に OpenRouter／Anthropic／Ollama（127.0.0.1:11434）を設定。hermes chat "ping" で応答確認後チャネルへ。

6. 手順4：Telegram BotFather

Telegram で @BotFather を開き /newbot で Bot 作成、Token を取得。
環境変数に設定（名称はリリースに合わせ TELEGRAM_BOT_TOKEN が一般的）：

export TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrsTUVwxyz"

Token は LaunchAgent／EnvironmentFile へ。ローテ後は deleteWebhook して再起動。

7. 手順5〜6：gateway install と 7×24

hermes gateway install
hermes gateway start
hermes gateway status

macOS： launchd + スリープ無効。Linux： loginctl enable-linger。Telegram テストと gateway status で検証。

8. 典型エラー早見表

症状	原因	対処
command not found	PATH 未設定	~/.local/bin を PATH に、doctor 再実行
401 unauthorized	守護プロセスに Key なし	LaunchAgent / systemd に環境変数
Telegram 無応答	Token 空、Webhook 競合	status 確認、deleteWebhook
install 失敗	ポート占有	lsof で解放、非 root で再試行
SSH 切断で停止	デーモン未登録	gateway install 必須

9. FAQ

Q：curl | bash は安全？ 保存して中身確認後に実行。

Q：OpenClaw 共存？ ポートと ~/.hermes を分離。

Q：VPS だけで足りる？ Telegram + API なら多くの場合可。

10. まとめ：リモート Mac への橋渡し

本当のハードルは資格情報がデーモンに届くかと24時間稼働。install → doctor → setup → BotFather → gateway → status。

SFTPMAC リモート Mac mini M4 レンタルで launchd・NVMe ~/.hermes・SFTP を一括確保。ハード比較は 20260527・20260528 へ。