Hermes Agent Wiki 非公式・日本語wiki

LINE の設定

目次

公式の LINE Messaging API を使って、Hermes Agent を LINE のボットとして動かします。アダプターは同梱のプラグインとして plugins/platforms/line/ に入っています。中核に手を入れる必要はなく、ほかの経路と同じように有効にするだけです。

LINE は日本、台湾、タイでいちばん使われているメッセンジャーです。相手がそこにいるなら、これがつながる道になります。

> hermes gateway setup を動かして LINE を選ぶと、手順に沿って設定できます。

ボットが返事をする条件

相手 ふるまい
1 対 1 のトーク（U で始まる ID） すべてのメッセージに返事をします
グループトーク（C で始まる ID） そのグループが許可の一覧にあるときに返事をします
複数人のトークルーム（R で始まる ID） そのルームが許可の一覧にあるときに返事をします

受信は、文字、画像、音声、動画、ファイル、スタンプ、位置情報のいずれにも対応します。送信はまず 無料の応答トークン を使い（一度きりで、およそ 60 秒のあいだ有効です）、期限が切れていたら課金対象の Push API に切り替えます。

ステップ 1: LINE Messaging API のチャネルを作る

  1. LINE Developers コンソール を開きます。
  2. プロバイダーを作り、その下に Messaging API のチャネルを作ります。
  3. チャネルの チャネル基本設定 のタブから、チャネルシークレット をコピーします。
  4. Messaging API のタブで チャネルアクセストークン（長期） まで進み、発行 を押します。出てきたトークンをコピーします。
  5. 同じ Messaging API のタブで、応答メッセージ と あいさつメッセージ を無効にします。有効なままだと、ボットの返事とぶつかります。

ステップ 2: Webhook のポートを外から届くようにする

LINE は Webhook を公開された HTTPS 経由で届けます。ポートの初期値は 8646 で、必要なら LINE_PORT で変えられます。

# Cloudflare Tunnel (recommended for production — fixed hostname)
cloudflared tunnel --url http://localhost:8646

# ngrok (good for dev)
ngrok http 8646

# devtunnel
devtunnel create hermes-line --allow-anonymous
devtunnel port create hermes-line -p 8646 --protocol https
devtunnel host hermes-line

出てきた https://... の URL をコピーします。このあと Webhook の URL として設定します。試しているあいだは トンネルを止めないでください。本番では、再起動しても URL が変わらないよう、Cloudflare の名前付きトンネルを用意しておくのがおすすめです。

ステップ 3: Hermes を設定する

~/.hermes/.env に書き足します。

LINE_CHANNEL_ACCESS_TOKEN=YOUR_LONG_LIVED_TOKEN
LINE_CHANNEL_SECRET=YOUR_CHANNEL_SECRET

# Allowlist — at least one of these (or LINE_ALLOW_ALL_USERS=true for dev)
LINE_ALLOWED_USERS=U1234567890abcdef...           # comma-separated U-prefixed IDs
LINE_ALLOWED_GROUPS=C1234567890abcdef...          # optional group IDs
LINE_ALLOWED_ROOMS=R1234567890abcdef...           # optional room IDs

# Required for image / audio / video sends — the public HTTPS base URL
# the tunnel resolves to.  Without it, send_image/voice/video will refuse.
LINE_PUBLIC_URL=https://my-tunnel.example.com

続いて ~/.hermes/config.yaml に書きます。

gateway:
  platforms:
    line:
      enabled: true

これで十分です。gateway/config.py が同梱のプラグインを走査して、plugins/platforms/line/ を自動で拾います。Platform.LINE の列挙に手を入れる必要も、_create_adapter に登録する必要もありません。

ステップ 4: Webhook の URL を設定する

LINE のコンソールに戻ります。

  1. 自分のチャネルを開き、Messaging API のタブへ進みます。
  2. Webhook 設定 の Webhook URL に、https://<your-tunnel>/line/webhook を貼り付けます（末尾の /line/webhook を忘れずに。アダプターはそこで待ち受けます）。
  3. 検証 を押します。LINE がその URL に問い合わせるので、200 が返れば成功です。
  4. Webhook の利用 を オン にします。

ステップ 5: ゲートウェイを動かす

hermes gateway

エージェントの記録に、次のように出ます。

LINE: webhook listening on * (all interfaces, IPv4+IPv6):8646/line/webhook (public: https://my-tunnel.example.com)

LINE のアプリからボットを友だちに追加し（チャネルの Messaging API のタブにある QR コードを読み取ります）、メッセージを送ってみてください。

LLM の返事が遅いとき

LINE の応答トークンは一度きりで、メッセージが届いてからおよそ 60 秒で切れます。返事の遅い LLM は間に合わず、そのままだと課金対象の Push API を使うことになります。

LLM の処理が LINE_SLOW_RESPONSE_THRESHOLD 秒（初期値は 45）を超えて続いているとき、アダプターは元の応答トークンを使って テンプレートのボタン の吹き出しを送ります。

> 🤔 Still thinking. Tap below to fetch the answer when it's ready. > > [ Get answer ]

読む人は、都合のいいときに Get answer を押します。その操作で *新しい* 応答トークンが渡されるので、アダプターはそれを使って、取っておいた答えを送ります（こちらも無料のままです）。

状態は PENDING → READY → DELIVERED と移ります。取り消された処理には ERROR が付きます（/stop のあとに取り残された PENDING は「Run was interrupted before completion.」として片づけられ、残ったボタンが押され続けることはありません）。

このボタンをやめて、いつでも Push に切り替えたい場合は次のようにします。

LINE_SLOW_RESPONSE_THRESHOLD=0

このボタンの仕組みを確実に働かせるには、しきい値に達する前に応答トークンを使ってしまう、途中のおしゃべりを止めておきます。

# ~/.hermes/config.yaml
display:
  interim_assistant_messages: false
  platforms:
    line:
      tool_progress: off

定期実行と通知の届け先

LINE_HOME_CHANNEL=Uxxxxxxxxxxxxxxxxxxxx     # default delivery target

deliver: line を指定した定期実行の仕事は LINE_HOME_CHANNEL に届きます。アダプターには Push 専用の単体の送信機能も入っているので、定期実行がゲートウェイとは別のプロセスで動いていても届きます。

環境変数の一覧

変数 必須 初期値 説明
LINE_CHANNEL_ACCESS_TOKEN はい — 長期のチャネルアクセストークン
LINE_CHANNEL_SECRET はい — チャネルシークレット（Webhook の検証に HMAC-SHA256 で使います）
LINE_HOST いいえ 未設定（IPv4 と IPv6 の全インターフェース） Webhook を待ち受けるホスト
LINE_PORT いいえ 8646 Webhook を待ち受けるポート
LINE_PUBLIC_URL メディアを送るなら必要 — 公開された HTTPS の基点となる URL。画像・音声・動画の送信に必要です
LINE_ALLOWED_USERS いずれか一つ — 利用者の ID をカンマ区切りで指定（U で始まるもの）
LINE_ALLOWED_GROUPS いずれか一つ — グループの ID をカンマ区切りで指定（C で始まるもの）
LINE_ALLOWED_ROOMS いずれか一つ — ルームの ID をカンマ区切りで指定（R で始まるもの）
LINE_ALLOW_ALL_USERS 開発時のみ false 許可の一覧をまったく使わない
LINE_HOME_CHANNEL いいえ — 定期実行や通知の既定の届け先
LINE_SLOW_RESPONSE_THRESHOLD いいえ 45 ボタンを出すまでの秒数（0 で無効）
LINE_PENDING_TEXT いいえ "🤔 Still thinking…" ボタンと一緒に出す吹き出しの文章
LINE_BUTTON_LABEL いいえ "Get answer" ボタンの文字
LINE_DELIVERED_TEXT いいえ "Already replied ✅" 届け終わったボタンをもう一度押したときの返事
LINE_INTERRUPTED_TEXT いいえ "Run was interrupted before completion." /stop で取り残されたボタンを押したときの返事

困ったときは

Webhook の検証で「invalid signature」と出る。 Channel secret の写し間違いか、トンネルが本文を書き換えています。まず curl -i https://<tunnel>/line/webhook/health で確かめてください。{"status":"ok","platform":"line"} が返るはずです。

グループで何も受け取らない。 LINE_ALLOWED_GROUPS に C... で始まるグループの ID が入っているか確かめます。グループの ID を知るには、試しにメッセージを送ってから ~/.hermes/logs/gateway.log を LINE: rejecting unauthorized source で検索します。はねられた相手の情報に ID が入っています。

send_image が「LINE_PUBLIC_URL must be set」で失敗する。 LINE の Messaging API はファイルそのものの送信を受け付けません。画像、音声、動画は HTTPS で取りにいける URL である必要があります。LINE_PUBLIC_URL にトンネルの公開ホスト名を設定すれば、アダプターが /line/media/<token>/<filename> からファイルを配ります。

ボタンがまったく出てこない。 LLM が LINE_SLOW_RESPONSE_THRESHOLD より早く答えたか、ほかの吹き出し（道具の進み具合や、流しながらの返事）が先に応答トークンを使ってしまっています。「LLM の返事が遅いとき」にある、止め方の設定を見てください。

「already in use by another profile」と出る。 同じチャネルアクセストークンが、動いている別の Hermes のプロファイルにひもづいています。もう一方のゲートウェイを止めるか、別のチャネルを使ってください。

できないこと

* 吹き出しと長さの上限。 LINE の一つの吹き出しは 5000 文字までです。長い返事はおよそ 4500 文字ごとに、なるべく切りのよいところで分けられ、一回の Reply / Push につき最大 5 つの吹き出しとして送られます。 * 送ったメッセージを直せません。 LINE にはメッセージを編集する API がないため、流しながらの返事はつねに新しい吹き出しになり、前のものが書き換わることはありません。 * Markdown は表示されません。 太字（**）、斜体（*）、コードの囲い、見出しは、そのままの記号として出てしまいます。アダプターは送る前にこれらを取り除きます。URL は残ります（label は label (url) になります）。 * 入力中の表示は 1 対 1 のときだけです。 LINE はグループとルームでは入力中を示す API を受け付けないので、この表示は 1 対 1 のトークにだけ出ます。