HermesAgent Windowsネイティブ オフラインインストーラー、VPNやWSLなしでWindows上でHermesを使う

Windowsユーザー向けのHermesAgentインストールガイドです。WSLもVPNも不要で、面倒な追加設定も必要ありません。手順に沿って進めるだけで、Windowsネイティブ環境でHermesの導入、API設定、WeChat連携まで完了できます。

HermesAgent Windowsネイティブ オフラインインストーラー、VPNやWSLなしでWindows上でHermesを使う

**これはWindowsユーザー向けのHermesAgentインストールガイドです。** WSLもVPNも不要で、面倒な追加設定も必要ありません。以下の手順に従うだけで、Windowsネイティブ環境でHermesの導入、API設定、WeChat連携まで完了できます。

**どんな人向けか**
Windows PC上でHermesをできるだけ手間なく直接動かしたい人向けです。

**このガイドでできること**
Hermesの導入、コマンド動作確認、API設定、TUI起動、必要に応じたWeChatゲートウェイ接続まで完了できます。

# インストール方法の概要

| 状況 | 推奨方法 | 説明 |
|-|-|-|
| PCにproxy / VPN環境がある | オンラインインストール | インストールコマンドをそのままPowerShellに貼り付けます。通常これが最速です。 |
| PCにproxy / VPN環境がない | オフラインパッケージ | 事前に用意されたオフラインパッケージをダウンロードし、スクリプトをダブルクリックして展開します。 |

---

# 方法1：Proxy / VPNがある場合のオンラインインストール

Windows PCでproxy / VPNが使えるなら、まずこちらの方法を使ってください。手順が少なく、インストールも速いです。

1. Windows用インストールコマンドをPowerShellにコピーして実行します。
2. または次のインストールコマンドを直接実行します。

```powershell
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
```

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NDcyNmVhODFmODIyOTk5YjIwNDk2ZWVjNWQxOTI0YTVfOTkzMGFkNmRkNTlhZTQ5MTE3NDA4NjY2MWZlZTg5ODJfSUQ6NzYzOTcwODEwOTI3MTA1OTQyMl8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

あとは表示される案内に従ってインストール完了まで待てば大丈夫です。

---

# 方法2：Proxy / VPNなしでオフラインパッケージを使う

**オフラインパッケージのダウンロード先**
- Baidu Netdisk: [https://pan.baidu.com/s/1zG2dReq6SkMs-Fh7c5YUmA?pwd=f2uq](https://pan.baidu.com/s/1zG2dReq6SkMs-Fh7c5YUmA?pwd=f2uq)（コード: f2uq）
- Quark Drive: [https://pan.quark.cn/s/aee345d1864b](https://pan.quark.cn/s/aee345d1864b)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=MGE5NTRhYjZmNzhmYzljYTdmMjNhOTg1MzEyYTUyMDVfNzc4NWU0YTFjMTY5NDE3ZWNmZDBhNGRhNDI1Y2QwNjZfSUQ6NzYzOTcwODExMjExNjQ4NTA5M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

1. Hermesのオフラインインストールパッケージをダウンロードして展開します。
2. `安装 hermes.cmd` をダブルクリックします。パッケージには最新ソースコードと依存関係が含まれているため、通常は追加設定は不要です。

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=OWJmYWFjNDVkZmY0ZGY1ODE4MjE0MDQxM2NlMjViMzNfYjk3NGJlMmM5NjVkNmRhMWEwNTc1NTNiODA5MjRhMzJfSUQ6NzYzOTcwODExMTk4OTIxNDE1M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=YWZhNTQ1MWQ1MzgwMGRmNDNkODA1MDljNmQ0YzQ0MTRfNGI3NmMyMzI2ZTg1YjNhYTIyNDZmNGVlNGE4NjI1ZTZfSUQ6NzYzOTcwODExNDMxNzAyMDA5Ml8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NDY1MTdkYjYyODllYWU0ODVhMTkyZDA0ZTRmNjgyMGFfOGQ3ODI1NGVhYTc4MGU2OTBlYTdkOTQxN2Y0ODI0NjVfSUQ6NzYzOTcwODExODc3MTEwODgwOV8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

インストールには通常2〜3分ほどかかります。完了したら任意のキーを押して終了します。

---

# インストール成功の確認

1. PowerShellまたはCMDを開きます。
2. `hermes --version` を実行します。
3. ターミナルにバージョン番号が表示されれば、Hermesのインストールは成功です。

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=M2FlYzA1Y2FjY2M3NjFkYWVhNGIwY2FiZjkxMmE5YzRfZjZjMjhiZjRjZTcwNDA4OTIwZDJlNjZlOThjOTk3YzNfSUQ6NzYzOTcwODEyMjY0NjM2NzE4OF8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

---

# Hermes APIサービスの設定

**ここで最も起こりやすいミスはAPI Keyの貼り付け方法です。** Windowsターミナルでは `Ctrl + V` を使わず、必ずマウス右クリックで一度だけ貼り付けてください。右クリックを何度もするとキーが重複して壊れることがあります。

1. `hermes model` を実行してモデル設定ウィザードに入ります。
2. カスタムプロバイダーを使う場合は対応する番号を選びます。このドキュメントでは 36 を選択しています。

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=ODc0M2UyNTBkYjUyZTg3ZDk1ZjYyMDM3MGZhYmRmMzdfZGU3MjA4Yzc1MjFjNjE0M2JhZGQ3OWIyNjdhNGJiYWFfSUQ6NzYzOTcwODEyNDk1NzQ5NDIwMF8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NWE4MmVhMzYyYWM2OGYwYjc3NzMyODhmN2ZkMDFmMzZfOTk2OGY1NzBmZWQ4NjE2ZDA3M2YxNTI0MWI1ODBjMmFfSUQ6NzYzOTcwODEyNDAyNDMyNzExM18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

続いて、Base URL と API Key を順番に入力します。

**Base URL を入力：**

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NjQ3ZjA0NGIzNDI5MWI4YTJlOTQ3Zjc1N2FhYmRjODNfODgxYmZlNWM2YWFiMDdlOGRhNWUwN2IyY2U0MjcwMzhfSUQ6NzYzOTcwODEyNjQzNDMxNTIyMF8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

**API Key を入力：**

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=MWZjMTc4Njg1ZjM1MGMyNGJmOGMwNTk2MzU0ODhkY2ZfMzkyZDI0MjFlYjcyNTYyZjcxYzdiOGUwMTgxMTIzYjhfSUQ6NzYzOTcwODEzMTIyMzg5OTA4M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)