はじめに#

今回作る環境#

今回構築する環境は以下のような構成です。

1
PC / スマートフォン
2
        │
3
        ▼
4
     Discord
5
        │
6
        ▼
7
   Discord Bot
8
        │
9
        ▼
10
  Hermes Gateway
11
        │
12
        ▼
13
   Hermes Agent
14
        │
15
        ├── Codex
16
        ├── 各種Tools
17
        └── Memory / Skills
18
        │
19
        ▼
20
      Docker
21
        │
22
        ▼
23
  作業ディレクトリ

今回はHermes AgentをWindows上へ直接インストールするのではなく、Dockerコンテナ内で動作させることにしました。 なぜDocker上に構築したかですが、理由の一つがセキュリティです。
Hermes AgentのようなAIエージェントは、設定次第でコマンドを実行したり、ファイルを読み書きしたりできます。 これは非常に便利なのですが、AIが意図しないコマンドを実行してしまった場合、普段使用しているPC環境へ直接影響する可能性があります。
そこで今回は、

1
Windows
2
│
3
├── 普段使用する環境
4
│
5
└── Docker
6
     └── Hermes Agent

というように、Hermes AgentをDockerコンテナの中に隔離して動かすことにしました。
もちろん、Dockerを使えば何をしても安全というわけではありません。
例えばホスト側のディレクトリをDockerへマウントすれば、そのディレクトリについてはHermesからアクセスできる可能性があります。
そのため今回は、Hermesからアクセスさせるディレクトリも必要な範囲に限定します。
僕の場合は、開発中のアプリを

1
/workspace/"開発中のアプリフォルダ"

としてDocker側からアクセスできるようにしています。
これによって、Hermesには基本的にこのプロジェクトを中心に作業してもらう構成にしました。

Hermes Agentの導入#

それではHermes Agentを導入していきます。
今回はDockerを利用します。

まずWindows側にHermes用のディレクトリを作成しました。

1
mkdir C:\Users\<ユーザー名>\hermes-docker
2
cd C:\Users\<ユーザー名>\hermes-docker

このディレクトリ内に、

1
hermes-docker/
2
├── Dockerfile
3
├── compose.yaml
4
├── .env
5
└── ...

といったDocker関連のファイルを配置していきます。

Dockerfileとcompose.yaml、.envは以下のように作りました。
Dockerfileで記述しているHermes Agentのバージョンが最新ではないですが、この理由については後程記載します。
envファイルはDiscord関連の設定です。こちらについても後で説明するDiscordの連携に関連します。

1
FROM nousresearch/hermes-agent:v2026.7.7.2
2

3
USER root
4

5
RUN npm install -g @openai/codex \
6
    && npm cache clean --force
7

8
USER hermes

1
services:
2
  hermes:
3
    build:
4
      context: .
5
      dockerfile: Dockerfile
6

7
    container_name: hermes
8
    restart: unless-stopped
9

10
    env_file:
11
      - .env
12

13
    volumes:
14
      - ./hermes-data:/opt/data
15
      - ../projects/"プロジェクト名":/workspace/"プロジェクト名"
16

17
    working_dir: /workspace/"プロジェクト名"
18

19
    environment:
20
      CODEX_HOME: /opt/data/codex
21

22
    command: ["gateway", "run"]

1
DISCORD_REQUIRE_MENTION=true
2
DISCORD_ALLOW_ALL_USERS=false
3
DISCORD_ALLOW_ANY_ATTACHMENT=false
4
DISCORD_MAX_ATTACHMENT_BYTES=33554432
5
DISCORD_REPLY_TO_MODE=on

次にDockerイメージをビルドして起動します。

1
docker compose build
2
docker compose up -d

起動できているか確認します。

1
docker compose ps

正常に起動していれば、Hermesのコンテナが Up になっているはずです。

Hermes Agentのバージョンも確認してDockerfileで設定したバージョンと合っているか確認します。

1
docker compose exec hermes hermes --version

これでHermes Agent自体の準備は完了です。

Discord Botの作成#

次にDiscord側の準備をします。

Hermes AgentとDiscordを直接接続するのではなく、Discord Botを作成し、そのBotをHermesから利用します。

Discord Developer Portalを開き、新しいApplicationを作成します。

Applicationを作成したら、Botの設定画面へ移動します。

BotがDiscordに投稿されたメッセージの内容を取得できるように、“Message Content Intent”を有効にします。ほかの設定については適当にAIに聞いてやってみてください笑

次にBot Tokenも取得します。このTokenは後ほどHermes Agent側の設定で使用します。 このTokenはパスワードのようなものなのでAIとかに送らないようにしてローカルで保管するようにしてください！

また、今回のBotはDiscordサーバーで利用するため、Guild Installを使用しました。

InstallationのページでScopesには、以下を設定します。

1
bot
2
applications.commands

そしてPoermissionsでBotには必要な範囲の権限のみを付与します。

1
View Channels
2
Send Messages
3
Embed Links
4
Attach Files
5
Read Message History
6
Send Messages in Threads
7
Add Reactions

などです。

今回は Administrator 権限は付与しませんでした。AIエージェントと接続するBotなので、必要以上に強い権限を与えないようにします。

設定が完了したら、作成したBotを自分のDiscordサーバーへ招待します。

Hermes Agent側でDiscordを設定・起動#

Discord Botを作成したので、次はHermes Agentと接続します。

HermesにはGatewayのセットアップ機能があります。Powershellで以下コマンドを打ちます。

1
docker compose exec -it hermes hermes gateway setup

セットアップ画面からDiscordを選択します。すると以下の3つについて順番に設定する画面が出ます。

1. Bot Tokenの設定
2. Allowed Usersの設定
3. Home Channelの設定

1.では先ほど取得したBot Tokenを設定します。
2.では自分のDiscordアカウントのUser IDを入力します。Hermes AgentはDiscordから指示を受けてさまざまな処理を実行できるため、誰でもBotを操作できる状態にはしたくありません。なので、これで指示を送れるユーザを制限します。DiscordのDeveloper Modeを有効にすると、自分のUser IDを取得できます。
3.ではHermesからの通知などを送信するためのDiscordチャンネルのchannel IDを入力します。ここはセットアップ時に指定することもできますが、後から設定することもできます。

以上で設定が完了したのでHermesを再起動します。

1
docker compose restart hermes

ログも確認してみます。

1
docker compose logs -f hermes

Discord上でBotがオンラインになれば、ひとまず接続成功です。

DiscordからHermesを操作してみる#

それでは実際にDiscordからHermesへ話しかけてみます。

例えば、

現在の作業ディレクトリを確認してください。

と送信します。

Hermesから以下のような応答が来るはずです。

他にも自己紹介もしてもらいました。プライバシー保護のため、一部黒塗りにしています。

ただ、この画像をみるとHermes Agentから２回同じ返信が来ています。。本来なら１回しか来ないはずなのでバグってますね。
この対処法についてはこの次で説明します！

これで、

1
Discord
2
   ↓
3
Hermes Gateway
4
   ↓
5
Hermes Agent
6
   ↓
7
Codex / Tools
8
   ↓
9
/workspace/"プロジェクトフォルダ"

という環境を作ることができました！

PCの前でHermesのCLIを開かなくても、Discordから指示できるのは便利ですね！
スマートフォンのDiscordからも操作できるので、今後いろいろ試してみたいと思います。

ハマったポイント Botの2重返信#

この問題にはかなり振り回されました。

DiscordからHermesへメッセージを送信すると、なぜか同じ内容の返信が2回来ます。

Discordの動作確認のところで載せた画像のように通常のメッセージと元のメッセージに対するReply の2種類で同じ回答が返ってきました。

2重で返答が返ってくる原因として以下の可能性を考えて対処を行いました。

• Botの二重起動の対策
• Discordから2回受信の停止
• Streamingの無効化
• Discord Botの作り直し
• HermesのDiscordコードの確認
• Hermes Agentのバージョンダウン

以上の対策を行いましたが、正解は最後のHermes Agentのバージョンダウンでした。
もともとDockerfileでバージョンはlatestにして最新のバージョンを取得していたのですが、最初は直近の安定化バージョンであるv2026.7.30にしたのですが、これでも治りませんでした。
これのせいで解決法がわからず、かなり時間がかかってしまいました。。最終的にchatgptは見捨ててclaudecodeに浮気して解決しました笑

最終的に正常に動作したのが、

1
FROM nousresearch/hermes-agent:v2026.7.7.2

です。

そしてDiscordからもう一度メッセージを送ってみると返信が1回だけになりました！

かなり長いこと原因を探しましたが、少なくとも僕の環境では、Hermes Agentのバージョンを v2026.7.7.2 に戻すことで問題が解消しました。

新しいDiscord Botを作成しても再現していたことや、コンテナ・Gatewayの二重起動も確認できなかったことから、Hermes Agentの新しいバージョン側におけるDiscord関連処理のバージョン依存問題だった可能性が高そうです。

ただし、今回は問題のコードそのものまで特定したわけではないので、

「このバージョン以降には必ずこのバグがある」

と断定することはできません。

あくまで僕の環境では、

1
新しいHermes Agent
2
    ↓
3
Discordで二重返信が発生

1
v2026.7.7.2
2
    ↓
3
正常に1回だけ返信

という結果になりました。

同じ問題に遭遇した方は、Hermes Agentのバージョンを確認してみるとよいかもしれません。

最初はとある短眠家の方の呪いかと思ってしまいました。。

まとめ#

今回はHermes AgentをDocker上に構築し、Discord Botと連携してみました。

今後はこの環境を使って、Codexと連携しながらアプリ開発などにも活用していきたいと思います。