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

Windows ユーザー向けに、WSL と Ubuntu を入れ、Ollama と Gemma 4 を使って Hermes Agent をローカル導入し、Telegram を接続する流れを整理します。

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

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

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

全体の流れ

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

  1. WSL を有効化して Ubuntu を入れる
  2. Ubuntu 内で Python、Node.js、Git などの基本環境を入れる
  3. Ollama を入れてローカルモデルを取得する
  4. 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 のよく使うコマンド

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

起動

1
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

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

元記事

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

记录并分享
Hugo で構築されています。
テーマ StackJimmy によって設計されています。