SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

Hermes AgentをLINEで使う:Webhook設定と無料200通の守り方

Hermes Agent v0.23.3をLINEのMessaging APIにつなぐ手順です。VPSのCaddyでWebhookを受け、返信は無料でPushは課金という通数ルールの中で無料プラン月200通に収める設定と、上限に達したときの挙動を解説します。

Hermes Agent を LINE で使うには何が要るか

Hermes Agent を LINE で使うには、LINE Developers Console で Messaging API チャネルを作ります。そのうえで、VPS の Hermes が公開 HTTPS の Webhook を受け取れるようにします。v0.23.3 には LINE 用のプラットフォームプラグインが同梱されているので、追加のインストールは要りません。注意が要るのは料金です。LINE は返信(Reply API)を月の通数に数えませんが、Push は数えます。無料のコミュニケーションプランは月200通を超えると送れなくなります。そのため、Hermes がどの場面で Push を使うかを知っておく必要があります。

この記事は、2026年11月19日付でリリースされた Hermes Agent v0.23.3 を前提にしています。このタグには plugins/platforms/line ディレクトリがあり、adapter.py と plugin.yaml が入っています。リリースノートの本文に LINE の名前は出てきませんが、プラグイン自体はタグに含まれています。以下の挙動の説明は、このタグのコードと公式ドキュメントを読んだ結果です。

Hermes 本体はすでに VPS で動いている前提です。まだなら VPS に Hermes Agent を自前で立てる手順 を先に済ませてください。Telegram など他のゲートウェイでスマホから使う方法は スマホから Hermes Agent に話しかける方法 にまとめています。

全体の構成:LINE から VPS までの流れ

ユーザーがボットにメッセージを送ると、LINE のサーバーがその内容を Webhook として HTTPS で POST します。Hermes の LINE アダプターは既定でポート 8646 を開き、パス /line/webhook で受け取ります。この記事では、その手前に Caddy を置きます。

  • LINE のサーバーが https://line.example.com/line/webhook に POST する(Caddy がポート 443 で受ける)
  • Caddy が 127.0.0.1:8646 の Hermes LINE アダプターへ転送する
  • Hermes が LINE Messaging API を呼び、返信または Push で答えを送る

LINE が Webhook を送る先には、はっきりした条件があります。URL は HTTPS でなければなりません。証明書は、一般のブラウザが広く信頼する認証局(CA、certificate authority)が発行したものに限られます。自己署名証明書は使えません。TLS(Transport Layer Security)は 1.2 と 1.3 だけが受け付けられ、1.1 以下は不可です。

Hermes の公式ドキュメントは、公開の方法として Cloudflare Tunnel(本番向けの推奨)、ngrok(開発向け)、devtunnel の3つを挙げています。自宅の PC で動かす場合や、ポートを開けられない環境ではトンネルが向いています。その場合は ポートを開けずに Cloudflare Tunnel で公開する方法 が参考になります。一方、ドメインを持つ VPS なら、リバースプロキシを1つ置くだけで足ります。Caddy は ACME(Automatic Certificate Management Environment)を使い、Let's Encrypt から証明書を自動で取得して更新します。Let's Encrypt から取れない場合は ZeroSSL を試します。どちらも公開 CA なので、LINE の条件を満たします。

LINE Developers Console でチャネルを作る

まず LINE 側の準備です。Hermes のドキュメントの手順に沿って進めます。

  1. https://developers.line.biz/console/ にログインする。
  2. プロバイダー(Provider)を作り、その下に Messaging API チャネルを作る。
  3. Basic settings タブで Channel secret をコピーする。
  4. Messaging API タブで Channel access token (long-lived) までスクロールし、Issue を押して長期のチャネルアクセストークンを発行する。
  5. 応答メッセージ(Auto-reply messages)とあいさつメッセージ(Greeting messages)を無効にする。

5番目は忘れやすい手順です。LINE のドキュメントによると、新しいチャネルではこの2つが最初から有効になっています。有効のままだと、Hermes の返事とは別に LINE 公式アカウントの自動応答が届きます。Hermes のドキュメントも、ボットの返信とぶつからないように無効にするよう書いています。LINE のドキュメントでは、この設定は LINE Official Account Manager で Disabled に変えるよう案内されています。

自分の LINE ユーザー ID(U から始まる ID)を確認する

Hermes に話しかけてよい人は、LINE_ALLOWED_USERS に書いたユーザー ID で決まります。自分だけが使うなら、自分の ID を1つ書けば十分です。

LINE のドキュメントによると、開発者自身のユーザー ID は、LINE Developers Console のチャネルの Basic settings タブにある Your user ID に表示されます。形式は U のあとに16進数32文字が続くもので、正規表現で書くと U[0-9a-f]{32} です。ただし、ビジネス ID が LINE アカウントに連携されていない場合、この欄は表示されません。表示されないときは、ビジネス ID の連携を確認してください。

LINE_ALLOW_ALL_USERS という設定もあります。既定値は false で、Hermes のドキュメントは「dev only」(開発専用)としています。これを有効にすると許可リストを完全に飛ばします。友だち追加した人なら誰でも、あなたのエージェントを動かせるということです。VPS 上のエージェントはシェルやファイルに触れることがあるので、本番では false のままにしてください。

逆に、許可リストを空にしたまま LINE_ALLOW_ALL_USERS も false だと、誰も許可されません。ボットに話しかけても返事がないときは、まず ~/.hermes/logs/gateway.log に LINE: rejecting unauthorized source という行がないか確認します。この行が出ていれば、メッセージは届いていて、許可リストで弾かれています。

Hermes 側の設定:ウィザードか手書きか

v0.23.3 では、hermes gateway setup の一覧に LINE が出ます。同梱のプラットフォームプラグインは設定メニューを作る時点で登録されるので、plugins.disabled に入れていない限り選べます。

hermes gateway setup

LINE を選ぶと、次の4つを聞かれます。

  1. チャネルアクセストークン(入力は伏せ字になる)
  2. チャネルシークレット(同じく伏せ字)
  3. 公開 HTTPS のベース URL(任意。LINE_PUBLIC_URL になる)
  4. 許可するユーザー ID(カンマ区切り。空欄ならスキップ。LINE_ALLOWED_USERS になる)

最後に、LINE の Console で Webhook URL を <公開 URL>/line/webhook に設定するよう案内が出ます。

手で書く場合は、~/.hermes/.env に次の行を加えます。LINE_HOST は、この記事の構成に合わせた追加の設定です。

LINE_CHANNEL_ACCESS_TOKEN=YOUR_LONG_LIVED_TOKEN
LINE_CHANNEL_SECRET=YOUR_CHANNEL_SECRET
LINE_ALLOWED_USERS=U0123456789abcdef0123456789abcdef
LINE_PUBLIC_URL=https://line.example.com
LINE_HOST=127.0.0.1

LINE_HOST を書かないと、アダプターはすべてのインターフェイスで IPv4 と IPv6 の両方を待ち受けます。Caddy を同じマシンに置くなら、127.0.0.1 に限定しておきます。そうすれば、ファイアウォールの設定を間違えてもポート 8646 は外から見えません。これはドキュメントの指示ではなく、この記事の推奨です。

次に ~/.hermes/config.yaml でプラットフォームを有効にします。

gateway:
  platforms:
    line:
      enabled: true

トークンかシークレットが欠けていると、アダプターは接続の段階で config_missing として失敗します。設定を変えたら、普段の起動方法でゲートウェイを再起動してください。

チャネルシークレットをエージェントから遠ざける

チャネルシークレットは、Webhook が本当に LINE から来たかを確かめる鍵です。LINE は Webhook の本文を入力に、チャネルシークレットを鍵にして HMAC-SHA256 で署名を作ります。その署名を x-line-signature ヘッダーに入れて送ります。Hermes は同じ計算をして、定数時間の比較で照合します。つまり、シークレットを知っている人は正しい署名を作れます。その人は、LINE を装った Webhook を Hermes に受け入れさせることができます。アクセストークンが漏れた場合は、他人があなたの名前で Push を送り、月の通数を使い切れます。

chmod 600 ~/.hermes/.env

.env は本人だけが読めるようにします。トークンやシークレットをチャットに貼ってエージェントに設定させるのも避けてください。会話の履歴に残るからです。また、エージェントがシェルを実行できる構成なら、同じユーザー権限で読めるファイルはエージェントからも読める可能性があります。この問題の整理と対策は AI エージェントに秘密情報を見せない方法 にまとめています。

Caddy で /line/webhook を 8646 に転送する

ここからが VPS 側の作業です。先に、使うサブドメイン(例:line.example.com)の DNS の A レコードを VPS の IP アドレスに向けておきます。IPv6 を使うなら AAAA レコードも向けます。Caddy の証明書取得では HTTP チャレンジを使うので、ポート 80 も外から届く必要があります。

Caddy は公式の apt リポジトリから入れます。Ubuntu と Debian では、公式ドキュメントの手順は次のとおりです。

sudo apt install --yes debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

/etc/caddy/Caddyfile の中身を、次の内容にします。

line.example.com {
  reverse_proxy 127.0.0.1:8646
}
sudo systemctl reload caddy

パスを /line/webhook だけに絞らず、サブドメイン全体を転送しているのには理由があります。アダプターは同じポートで /line/webhook/health(ヘルスチェック)も提供しています。画像や音声の配信に使う /line/media/<トークン>/<ファイル名> も同じポートです。LINE 専用のサブドメインにすれば、Caddyfile は3行で済みます。

もう1つ大事な点があります。署名は本文そのものから計算されます。そのため、途中で本文を書き換える仕組みを挟むと検証が失敗します。Hermes のドキュメントも、シークレットのコピーミスと並んで、本文を書き換えるトンネルを invalid signature の原因に挙げています。上の Caddyfile には、本文を加工する設定を入れていません。

ファイアウォール:8646 は外に開けない

外に開けるのは SSH と 80、443 だけです。8646 は開けません。Ubuntu の ufw なら次のようにします。

sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status

ufw status の一覧に 8646 が出ていなければ正しい状態です。VPS 事業者のコントロールパネルに別のネットワークファイアウォールがある場合は、そちらでも 80 と 443 を許可してください。

動作を確認する:health と署名チェック

まず、アダプターがループバックだけで待ち受けているかを見ます。

sudo ss -ltnp | grep 8646

127.0.0.1:8646 と表示されれば、外からは直接届きません。0.0.0.0:8646 や [::]:8646 と出る場合は、LINE_HOST が読み込まれていません。

次に、Caddy 経由で外から届くかを確かめます。

curl -i https://line.example.com/line/webhook/health

{"status":"ok","platform":"line"} が返れば、DNS、証明書、Caddy、アダプターのすべてがつながっています。証明書のエラーが出る場合は、DNS がまだ VPS を指していないか、ポート 80 が閉じていて証明書を取れていません。502 が返る場合は、Caddy は動いていますが、8646 で何も待ち受けていません。

最後に、署名のない POST が拒否されることを確かめます。

curl -i -X POST https://line.example.com/line/webhook -H 'Content-Type: application/json' -d '{}'

HTTP 401 と invalid signature が返るのが正しい結果です。署名のないリクエストは受け付けられていません。なお、1 MiB を超える本文には 413 が返ります。

確認が済んだら、LINE Developers Console の Messaging API タブで Webhook URL に https://line.example.com/line/webhook を入れます。Webhook の利用が有効になっているかも見ておきます。ボットを友だち追加してメッセージを送り、tail -f ~/.hermes/logs/gateway.log で受信の様子を確認します。

LINE 公式アカウントの料金プランと月の通数

ここからがお金の話です。LINE 公式アカウントには3つのプランがあります。以下は 2026年11月20日に LINE ヤフーの法人向けプランページで確認した数字です。月額は月額換算の税別で、通数は1か月に送れる無料メッセージの数です。

グラフLINE公式アカウントの料金プラン(日本、税別、2026年11月20日確認)
このグラフのデータ
[
  {
    "plan": "\u30b3\u30df\u30e5\u30cb\u30b1\u30fc\u30b7\u30e7\u30f3\u30d7\u30e9\u30f3",
    "monthly_fee_yen": 0,
    "messages_per_month": 200
  },
  {
    "plan": "\u30e9\u30a4\u30c8\u30d7\u30e9\u30f3",
    "monthly_fee_yen": "5,000",
    "messages_per_month": "5,000"
  },
  {
    "plan": "\u30b9\u30bf\u30f3\u30c0\u30fc\u30c9\u30d7\u30e9\u30f3",
    "monthly_fee_yen": "15,000",
    "messages_per_month": "30,000"
  }
]

無料のコミュニケーションプランは月 200 通です。ライトプランは月額 5,000 円で 5,000 通です。スタンダードプランは月額 15,000 円で 30,000 通です。

上限を超えて送れる(追加メッセージ)のはスタンダードプランだけです。コミュニケーションプランとライトプランでは追加メッセージを配信できません。もっと送りたければ、プランを上げる必要があります。追加メッセージの料金は 2026年10月1日に改定済みです。日本では月20万通までが1通3円、20万通を超えた分は1通2.5円(いずれも税別)です。個人で Hermes を使う人には、ほぼ関係のない数字です。

数え方のルールは2つです。

  • Reply API で送ったメッセージは数えない。 Push、Multicast、Broadcast、Narrowcast は数える。
  • 数えるのは送った相手の人数。 1回のリクエストに入れたメッセージ(吹き出し)の数は関係ない。

たとえば、吹き出し4つの Push を5人のトークルームに1回送ると5通です。1対1のチャットなら、吹き出しが最大5つでも Push 1回は1通です。ブロックされたユーザーや存在しないユーザー ID への送信は数えません。

Hermes はいつ無料の返信を使い、いつ Push を使うか

Hermes は、テキストを送るときにまず無料の返信トークン(reply token)を使います。トークンがない、期限切れ、または拒否された場合に、通数を消費する Push に切り替えます。

返信トークンの寿命について、LINE の Messaging API リファレンス(2026年11月20日に確認)はこう書いています。

Reply tokens must be used within one minute after receiving the webhook. Use beyond one minute isn't guaranteed to work.

つまり「Webhook を受けてから1分以内に使うこと。1分を過ぎた場合の動作は保証しない」という意味です。トークンは1回しか使えません。期限は予告なく変わることがある、とも書かれています。Hermes の v0.23.3 のコードは、LINE の1分より短い 50 秒で手元のトークンを期限切れ扱いにします。

そのうえで、Push が出る場面は次のとおりです。

  • 答えが遅いとき。 Hermes は LINE_SLOW_RESPONSE_THRESHOLD(既定 45 秒)を超えると、返信トークンを使って「Get answer」ボタン付きのメッセージを送ります。ユーザーがボタンを押すと新しい返信トークンが届くので、完成した答えも無料の返信で届きます。ボタンを押したあとの返信が失敗した場合だけ、Push に切り替わります。
  • しきい値を 0 にしたとき。 0 以下にするとボタンは出ません。コードの流れから見ると、50 秒を超えた答えは手元のトークンが切れているので Push になります。
  • 続けて送ったとき。 新しいメッセージが届くと、そのチャットの古い返信トークンは上書きされます。前の答えが終わる前に次の質問を送ると、どちらかの答えはトークンなしになり、Push になりやすくなります。
  • 1回の答えが5メッセージを超えるとき。 API は1リクエスト5メッセージまでです。Hermes は最初の5つを返信で送り、残りを Push で送ります。テキストと画像を組み合わせた答えで起こります。
  • cron の出力。 deliver: line の cron ジョブは LINE_HOME_CHANNEL に届けられます。この経路は Push 専用です。返信トークンを使わないので、1回の配信が必ず1通になります。

ボタンの文言は LINE_BUTTON_LABEL などで変えられます。v0.23.3 の日本語の文言カタログには「回答を取得」というラベルも入っています。

無料プランの月200通に収めるコツ

上の仕組みが分かれば、対策ははっきりします。

  • LINE_SLOW_RESPONSE_THRESHOLD は既定の 45 のままにする。50 秒より短いので、遅い答えもボタン経由で無料になる。
  • 「Get answer」が出たら、答えができるまで待ってから押す。押せば答えは返信で届く。
  • 答えを待つ間に次の質問を送らない。
  • cron の LINE 配信は控えめにする。毎日1回で月30通、つまり無料枠の15%を使う。1時間ごとなら月720通で、無料枠では足りない。
  • グループやトークルームに入れない。グループへの Push は人数分数えられる。
  • 長い報告は1回にまとめる。1対1なら、吹き出し5つの Push も1通。

どのくらい Push に切り替わったかは、ログで数えられます。返信トークンが拒否されたときは、INFO で LINE: reply token rejected (...); falling back to push が出ます。ボタン後の返信が失敗したときは、WARNING で LINE: postback reply failed (...); falling back to push が出ます。

grep -c 'falling back to push' ~/.hermes/logs/gateway.log

ただし、トークンが手元で期限切れだった場合や cron の配信は、この行に出るとは限りません。この数字は下限として見てください。ログは 5 MB でローテーションされ、3世代まで残ります。正確な通数は、Messaging API リファレンスの「Get number of messages sent this month」(今月送ったメッセージ数)と「Get the target limit for sending messages this month」(今月の上限)で確認できます。

月の上限に達したら何が起きるか

LINE のプランページによると、上限を超えるとエラーが返り、メッセージは送られません。Messaging API リファレンスでは、ステータス 429 Too Many Requests とエラーメッセージ You have reached your monthly limit. がこの場合に当たります。

v0.23.3 のコードを読むと、Hermes 側の動きは次のとおりです。実際に上限に達したアカウントで再現したわけではありません。「コード上は」という前提で読んでください。

  1. アダプターは HTTP 400 以上の応答をすべて例外にする。テキストの Push が失敗すると、ERROR レベルで LINE: push send failed: ... を記録する。再試行はせず、Retry-After も見ない。アダプターには「quota」や「monthly」を判定するコードはない。
  2. ゲートウェイはこのエラーを、レート制限とも通信エラーとも判定しない。プレーンテキストに直して1回だけ送り直す。
  3. 上限は同じなので、送り直しもほぼ確実に失敗する。[line] Fallback send also failed: ... が記録される。
  4. LINE のユーザーには何も届かない。上限に達したことを知らせるメッセージも出ない。

ログには次のような行が並びます。

LINE: push send failed: LINE push 429: ...
[line] Send failed: ... — trying plain-text fallback
[line] Fallback send also failed: ...

cron の配信では、アダプター側はログを出しません。失敗は、その実行の配信エラーとして記録されます。

スマホから見ると「ボットが急に黙った」としか分かりません。ただし、返信トークンで届く答えは数えられません。そのため月末でも、45 秒以内の答えは届き続けます。止まるのは Push の分だけです。ボットが答えたり答えなかったりするときは、次のコマンドで上限を疑ってください。

grep -E 'push send failed|Fallback send also failed' ~/.hermes/logs/gateway.log

上限に達したら、翌月まで待つか、ライトプランに上げるかのどちらかです。コミュニケーションプランのまま追加で送る方法はありません。

LINE ならではの制約:画像、文字数、Markdown

  • 画像や音声には LINE_PUBLIC_URL が要る。 LINE はファイルのアップロードを受け付けず、公開された HTTPS の URL を受け取ります。Hermes は /line/media/<トークン>/<ファイル名> でファイルを配り、このトークンは30分で切れます。LINE_PUBLIC_URL がないと LINE_PUBLIC_URL must be set to send images (LINE only accepts publicly reachable HTTPS URLs) で失敗します。画像では http:// の URL も拒否されます。画像は JPEG か PNG で最大 10 MB、動画は mp4 で最大 200 MB です。
  • 吹き出し1つは5000文字まで。 Hermes は余裕をみて約4500文字で区切り、1回の返信または Push で最大5つの吹き出しに分けます。それでも収まらない分は送られず、5つ目の吹き出しが … で終わります。長い答えが途中で切れるのはこのためです。
  • Markdown は表示されない。 LINE は Markdown を解釈しないので、Hermes が送る前に記号を取り除きます。太字や見出しの記号は消え、コードブロックは中身だけが残ります。[ラベル](URL) は ラベル (URL) になり、箇条書きの記号は • に変わります。

吹き出しの数には、もう1つ注意があります。LINE ヤフーのプランページには「1回に配信できるのは最大3吹き出し」とあります。これは LINE 公式アカウントの管理画面から配信する場合の話です。Messaging API は1リクエストに5メッセージまで受け付けます。Hermes はこちらに合わせて、最大5つに分けています。

LINE と Telegram、どちらを選ぶか

普段のやり取りが LINE で完結している人にとって、LINE で Hermes を呼べるのは大きな利点です。ただし、この用途には2つの負担があります。1つは公開 HTTPS の Webhook を用意すること、もう1つは Push の月の通数です。会話の返事だけなら、返信トークンでほとんど無料に収まります。一方、毎日の cron 通知を何本も LINE に流したい人には、無料プランの200通では足りません。その場合は、通知だけを別のゲートウェイに分けるか、ライトプランの料金を払うかを選ぶことになります。

FAQ

Hermes Agent の LINE ボットが返事をしないのはなぜですか?

まず curl -i https://line.example.com/line/webhook/health で {"status":"ok","platform":"line"} が返るか確認します。返るなら、~/.hermes/logs/gateway.log を見ます。LINE: rejecting unauthorized source が出ていれば、LINE_ALLOWED_USERS に自分の U から始まる ID が入っていません。invalid signature が出ていれば、チャネルシークレットのコピーミスか、途中で本文が書き換えられています。push send failed と 429 が出ていれば、月の通数を使い切っています。

LINE の無料プランで Hermes Agent は使えますか?

使えます。コミュニケーションプランは月200通ですが、Reply API の返信は数えられません。Hermes はまず無料の返信トークンで答えます。45 秒を超えると「Get answer」ボタンを出し、押されたら無料の返信で答えを届けます。数えられるのは主に Push で、cron の LINE 配信はすべて Push です。毎日1回の cron なら月30通で、無料枠に収まります。

Cloudflare Tunnel と Caddy、どちらを使うべきですか?

ドメインを持つ VPS なら Caddy で十分です。Caddy は公開 CA の証明書を自動で取得するので、LINE の HTTPS の条件を満たします。ポート 80 と 443 を開けられない環境や、自宅の PC で動かす場合は、Cloudflare Tunnel が向いています。Hermes のドキュメントも本番向けに推奨しています。どちらを使う場合も、Webhook の本文を書き換えない構成にしてください。書き換えると署名の検証が失敗するからです。

LINE_ALLOW_ALL_USERS を true にしても大丈夫ですか?

本番ではやめてください。既定値は false で、Hermes のドキュメントは開発専用としています。true にすると許可リストを飛ばすので、ボットを友だち追加した人なら誰でもエージェントを動かせます。自分だけで使うなら、Basic settings タブの Your user ID に表示される ID を LINE_ALLOWED_USERS に書きます。

この記事は役に立ちましたか?