LINE

ZeroClawはMessaging APIを通じてLINEに対応しており、組み込みのWebhookサーバーでメッセージを受信し、Reply APIで返信します（リプライトークンが失効している場合はPush APIにフォールバックします）。

エージェントと対話できるユーザー

受信側の送信者は、バインドされたエージェントに対して解決されたピアセットに照らして制御されます。これはエージェントが所属する peer_groups 設定から導出されます。照合では先頭の @ を取り除き、チャネルのネイティブな送信者識別子に対して大文字・小文字を区別せずに行われます。空のセットはすべてを拒否し、"*" を含むセットはすべてを受け入れます。それ以外の場合は、リストに記載された外部ピア（およびピアエージェント）のみが受け入れられます。これはゲートウェイのペアリング（gateway.require_pairing）とは別物であり、ペアリングはチャットチャネルの送信者ではなく HTTP/WebSocket クライアントを認証します。

line のピアグループでは、channel を line に設定し、許可する送信者を external_peers に列挙します（line の場合は LINE ユーザー ID。["*"] は誰でも受け付けます）。必要に応じて、エージェント間ディスパッチ用のピア agents、ignore ブロックリスト、output_modality（mirror、voice、または text）を指定できます。フィールドのリファレンスについては Peer Groups を参照してください。

この設定の場所:

LINE はピアセットの上に dm_policy と group_policy のレイヤーを重ねます。下記の アクセスポリシー を参照してください。ポリシーが allowlist に設定されている場合、ピアセットがallowlistになります。

前提条件

1. LINE Developers Consoleアカウント。
2. LINEのサーバーから到達可能なパブリックHTTPSエンドポイント (ローカル開発ではngrok)。
3. LINEチャネルサポートが有効になった状態でビルドされたZeroClaw (zeroclaw-channelsクレート上のchannel-line機能)。

1. LINEボットを作成する

1. LINE Developers Consoleにログインします。
2. プロバイダーを作成します (または既存のものを使用)。
3. そのプロバイダーの下に新しいメッセージングAPIチャネルを作成します。
4. チャネル設定から、2つの値を集めます:
   • チャネルアクセストークン: Messaging API タブ → 長期間有効なトークンを発行します。
   • チャネルシークレット: 基本設定タブ。

2. ZeroClawを設定する

zeroclaw config set channels.line.<alias>.channel_access_token    # マスクされた入力、暗号化して保存

export ZEROCLAW_channels__line__<alias>__channel_access_token=

zeroclaw config set channels.line.<alias>.channel_secret    # マスクされた入力、暗号化して保存

export ZEROCLAW_channels__line__<alias>__channel_secret=

zeroclaw config set channels.line.<alias>.dm_policy <value>

export ZEROCLAW_channels__line__<alias>__dm_policy=

zeroclaw config set channels.line.<alias>.excluded_tools <value>

export ZEROCLAW_channels__line__<alias>__excluded_tools=

zeroclaw config set channels.line.<alias>.group_policy <value>

export ZEROCLAW_channels__line__<alias>__group_policy=

zeroclaw config set channels.line.<alias>.proxy_url <value>

export ZEROCLAW_channels__line__<alias>__proxy_url=

zeroclaw config set channels.line.<alias>.sender_name <value>

export ZEROCLAW_channels__line__<alias>__sender_name=

zeroclaw config set channels.line.<alias>.webhook_port <value>

export ZEROCLAW_channels__line__<alias>__webhook_port=

[channels.line.<alias>] の下で LINE チャネルを設定し、少なくとも channel_access_token と channel_secret を指定します。dm_policy / group_policy のユーザー向けの動作については、以下の §6 で説明します。

設定ファイルの代わりに環境変数を使用する

認証情報を設定ファイルに保存したくない場合は、トークンフィールドを省略し、代わりに環境変数としてエクスポートしてください：

export LINE_CHANNEL_ACCESS_TOKEN="your-channel-access-token"
export LINE_CHANNEL_SECRET="your-channel-secret"

環境変数は空の設定フィールドより優先されます。

3. Webhookエンドポイントを公開する

LINEはWebhook URLにPOSTしてメッセージを配信します。埋め込みサーバーは設定されたwebhook_portでリッスンします。

ローカル開発の場合（ngrok）：

ngrok http 8443

ngrokが提供するhttps:// URL（例：https://abc123.ngrok.io）をコピーします。

本番環境の場合： HTTPSリバースプロキシ（nginx、Caddy等）の後ろでポート8443（または設定したポート）を公開するか、TLS証明書を備えたサーバーに直接デプロイしてください。

4. LINE Developers ConsoleでWebhookを登録する

1. チャネル → Messaging APIタブ → Webhook設定に移動します。
2. Webhook URLをhttps://your-domain.com/line/webhookに設定します。
3. Webhookを使用するをオンに切り替えます。
4. Verify をクリックすると、LINE がテストリクエストを送信します。検証を成功させるには、ZeroClaw が実行されている必要があります。

5. ZeroClawを開始する

zeroclaw daemon

スタートアップログシグナル：

LINE: webhook server listening on http://0.0.0.0:8443/line/webhook

6. アクセスポリシー

DM（1対1チャット）: dm_policy

ペアリングワークフロー：

1. ZeroClawはスタートアップ時にログにペアリングコードを出力します。
2. ユーザーはボットとのLINE DMを開き、/bind <code>を送信します。
3. ZeroClawはペアリングを確認し、後続のDMが受け入れられます。

グループ/複数人チャット: group_policy

7. オーディオ/音声メッセージトランスクリプション（オプション）

文字起こしが有効な場合（グローバルな [transcription] 設定経由、Config reference を参照）、LINE の audio メッセージイベントは LINE Content API から自動的にダウンロードされ、モデルに渡される前に文字起こしされます。

最大受け入れオーディオサイズは25 MBです。より大きいファイルはログ警告とともに黙って スキップされます。

8. トラブルシューティング

ログキーワード

関連項目も参照してください

• 設定リファレンス: 設定フィールドの完全な索引
• LINE Developers Documentation