AntiGravityのダッシュボードを起動したらTelegramが切れた話

何が起きたか

HermesエージェントをTelegramと連携して使っていたところ、AntiGravityのダッシュボードを立ち上げた直後からスマホのTelegramが反応しなくなった。

gateway を再起動しようとしたら、こんなエラーが出た。

[Telegram] Telegram bot token already in use (PID 6296).
Stop the other gateway first.

原因

AntiGravityのダッシュボードが、起動時に別のゲートウェイ（TUIゲートウェイ）を自動で立ち上げていた。

Hermesはゲートウェイが1つのTelegramボットトークンを排他的に使用する仕組みになっている。ダッシュボードが先にトークンを掴んでしまったため、後から起動しようとしたTelegramゲートウェイが弾かれていた。

Telegramボットトークン：8▓▓▓▓▓▓▓▓:AA▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

※トークンは外部に漏れると第三者にボットを乗っ取られるため厳重管理が必要

--replace では解決しなかった理由

通常、hermes gateway run --replace を使えば既存のゲートウェイを置き換えられる。しかし今回はダッシュボードが起動したプロセスが「別扱い」になっており、--replace が効かなかった。

ログを確認すると：

gateway.log:
ERROR: Telegram bot token already in use (PID 6296).

PIDが特定できたので、直接強制停止する必要があった。

解決手順

Step 1：競合しているプロセスを強制停止

Stop-Process -Id 6296 -Force

Step 2：Telegramゲートウェイを再起動

C:\Users\[ユーザー名]\AppData\Local\hermes\hermes-agent\venv\Scripts\hermes gateway run --replace

Step 3：接続確認

[Telegram] Connected to Telegram (polling mode)
Gateway running with 1 platform(s)

このログが出れば成功。

今後の対処法

AntiGravityのダッシュボードを起動するたびに同じ問題が起きる可能性がある。

まず --replace を試す：

C:\Users\[ユーザー名]\AppData\Local\hermes\hermes-agent\venv\Scripts\hermes gateway run --replace

それでも繋がらない場合はPIDを直接停止：

Stop-Process -Id (Get-Content C:\Users\[ユーザー名]\.hermes\gateway.pid) -Force
C:\Users\[ユーザー名]\AppData\Local\hermes\hermes-agent\venv\Scripts\hermes gateway run

まとめ

原因解決策ダッシュボードがTUIゲートウェイを自動起動競合PIDを強制停止--replace が効かないStop-Process -Id [PID] を使う

ダッシュボードとTelegramゲートウェイは共存できない。 どちらかを使う場合はもう片方を停止する必要がある。

環境：Windows 11 / AntiGravity IDE / Hermes Agent / Telegram