Windows で WSL + Ollama を使って Hermes Agent をローカル導入し、Telegram に接続する

Sat, 18 Apr 2026 00:48:22 +0800

Windows 上でできるだけ手軽に Hermes Agent を動かしたいなら、比較的やりやすい流れは次の通りです。

ホスト OS はそのまま Windows を使う
WSL 内で Ubuntu を動かす
Ollama でローカルモデルを提供する
Hermes Agent からローカル Ollama のエンドポイントへ直接つなぐ

この方法の利点は、環境を比較的きれいに保ちやすく、コマンドも Linux 方式でそろえやすいことです。別に Linux マシンを用意しなくても始められます。

全体の流れ

この構成は 4 ステップに分けられます。

WSL を有効化して Ubuntu を入れる
Ubuntu 内で Python、Node.js、Git などの基本環境を入れる
Ollama を入れてローカルモデルを取得する
Hermes Agent を入れ、Telegram を接続する

まず Hermes Agent を動かすことだけが目的なら、実質的には 3 ステップ目まででかなり近いところまで行けます。

1. WSL と Ubuntu をインストールする

管理者権限の PowerShell で次を実行します。

`1`	`wsl --install`

インストールが終わったら PC を再起動し、そのあと Ubuntu を入れます。

`1`	`wsl --install -d Ubuntu`

以降のコマンドは、WSL の Ubuntu 側で実行していきます。

2. Ubuntu を更新し、基本環境を入れる

まずシステムを更新します。

1
2

sudo apt update
sudo apt upgrade -y

そのあと Python、展開ツール、Node.js、Git を入れます。

Python をインストール

`1`	`sudo apt install python3-pip python3-venv -y`

zstd をインストール

`1`	`sudo apt install -y zstd`

Node.js をインストール

1
2

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

Git をインストール

1
2

sudo apt update
sudo apt install -y git

入れ終わったら、軽く確認しておくと安心です。

1
2
3

node -v
npm -v
git --version

3. Ollama を入れて Gemma 4 を取得する

Ollama のインストール:

`1`	`curl -fsSL https://ollama.com/install.sh \| sh`

Hermes Agent 用にローカルモデルを用意するなら、まずは Gemma 4 から始めるのが無難です。

たとえば:

`1`	`ollama run gemma4:e4b`

もしマシンのリソースが弱ければ:

`1`	`ollama run gemma4:e2b`

より大きい版としては:

1
2

ollama run gemma4:26b
ollama run gemma4:31b

一般的な Windows + WSL 環境では、gemma4:e4b が現実的な出発点になりやすいです。

4. Hermes Agent をインストールして設定する

インストールコマンド:

`1`	`curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh \| bash`

インストール後、Ollama のローカルエンドポイントを指定します。

`1`	`http://127.0.0.1:11434`

モデル名には実際に使うものを入れます。たとえば:

`1`	`gemma4:e4b`

インストーラから shell の再読み込みを求められたら:

`1`	`source ~/.bashrc`

Hermes Agent のよく使うコマンド

普段よく使うのは次のあたりです。

起動

hermes

再設定

`1`	`hermes setup`

チャットゲートウェイ設定

`1`	`hermes setup gateway`

更新

`1`	`hermes update`

Telegram 接続の基本手順

Hermes Agent で Telegram の送受信をしたいなら、まずは次を実行します。

`1`	`hermes setup gateway`

そのうえで Telegram 側で次の 2 つを用意します。

BotFather で bot を作成する
@userinfobot で自分の User ID を確認する

これらを揃えたら、Hermes Agent のゲートウェイ設定に入力していきます。

この構成が向いている人

この方法は、次のような人に向いています。

メイン環境が Windows
別に Linux マシンを用意したくない
まずはローカル Agent を動かし、その後チャット連携を広げたい
できるだけクラウド API ではなくローカルモデルを使いたい

最初から本格的な本番環境を組むのではなく、まずローカルで Agent を試したい人には十分実用的です。

注意点

WSL はあくまで互換レイヤーなので、極端なケースではネイティブ Linux と完全に同じとは限りません
大きなモデルが快適に動くかどうかは、RAM、VRAM、CPU / GPU に依存します
gemma4:e4b は現実的な出発点ですが、最終的な体感はマシン性能次第です
Hermes Agent のチャット連携は拡張機能なので、まずローカルモデル経路を通してから Telegram を足すほうが安定しやすいです

まとめ

Windows 上でなるべく素直に Hermes Agent をローカル導入するなら、流れは次の順番がやりやすいです。

WSL -> Ubuntu -> Ollama -> Gemma 4 -> Hermes Agent -> Telegram

最初にローカルモデルを確実に動かし、そのあとでゲートウェイ接続を追加すると成功率が上がります。多くのユーザーにとって、最初から部品を積みすぎるよりもこのほうが切り分けしやすく、後から拡張もしやすいです。

元記事

この投稿は次のページをもとに整理・リライトしています。

X超哥博客：太简单了！Hermes Agent 本地部署（无需API）接入 Telegram + 微信

AI Tools on KnightLiブログ