LINE（プラグイン）

LINEはLINE Messaging API経由でOpenClawに接続します。プラグインはGateway上のウェブフックレシーバーとして動作し、チャンネルアクセストークン＋チャンネルシークレットで認証します。

ステータス：プラグイン経由で対応。ダイレクトメッセージ、グループチャット、メディア、位置情報、Flexメッセージ、テンプレートメッセージ、クイックリプライに対応。リアクションとスレッドには非対応。

プラグインが必要

LINEプラグインをインストール：

openclaw plugins install @openclaw/line

ローカルチェックアウト（gitリポジトリから実行する場合）：

openclaw plugins install ./extensions/line

セットアップ

1. LINE Developersアカウントを作成し、コンソールを開く： https://developers.line.biz/console/
2. プロバイダーを作成（または選択）し、Messaging APIチャンネルを追加。
3. チャンネル設定からチャンネルアクセストークンとチャンネルシークレットをコピー。
4. Messaging API設定でWebhookの利用を有効化。
5. ウェブフックURLをGatewayのエンドポイントに設定（HTTPS必須）：

https://gateway-host/line/webhook

GatewayはLINEのウェブフック検証（GET）と受信イベント（POST）に応答します。 カスタムパスが必要な場合は、channels.line.webhookPathまたはchannels.line.accounts.<id>.webhookPathを設定し、URLを合わせて更新してください。

セキュリティに関する注意：

• LINEの署名検証はボディ依存（生のボディに対するHMAC）のため、OpenClawは検証前に厳格なプリオース用ボディ制限とタイムアウトを適用します。

設定

最小限の設定：

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "pairing",
    },
  },
}

環境変数（デフォルトアカウントのみ）：

• LINE_CHANNEL_ACCESS_TOKEN
• LINE_CHANNEL_SECRET

トークン/シークレットファイル：

{
  channels: {
    line: {
      tokenFile: "/path/to/line-token.txt",
      secretFile: "/path/to/line-secret.txt",
    },
  },
}

tokenFileとsecretFileは通常のファイルを指す必要があります。シンボリックリンクは拒否されます。

複数アカウント：

{
  channels: {
    line: {
      accounts: {
        marketing: {
          channelAccessToken: "...",
          channelSecret: "...",
          webhookPath: "/line/marketing",
        },
      },
    },
  },
}

アクセス制御

ダイレクトメッセージはデフォルトでペアリングです。未知の送信者にはペアリングコードが発行され、承認されるまでメッセージは無視されます。

openclaw pairing list line
openclaw pairing approve line <CODE>

許可リストとポリシー：

• channels.line.dmPolicy：pairing | allowlist | open | disabled
• channels.line.allowFrom：DM用の許可済みLINEユーザーID
• channels.line.groupPolicy：allowlist | open | disabled
• channels.line.groupAllowFrom：グループ用の許可済みLINEユーザーID
• グループごとの上書き：channels.line.groups.<groupId>.allowFrom
• ランタイムの注意：channels.lineが完全に欠落している場合、グループチェックではgroupPolicy="allowlist"にフォールバックします（channels.defaults.groupPolicyが設定されていても同様）。

LINE IDは大文字小文字を区別します。有効なIDの形式：

• ユーザー：U + 32桁のhex
• グループ：C + 32桁のhex
• ルーム：R + 32桁のhex

メッセージの動作

• テキストは5000文字で分割。
• Markdownフォーマットはストリップされ、コードブロックやテーブルは可能な場合Flexカードに変換。
• ストリーミング応答はバッファリングされ、LINEはエージェントの処理中にローディングアニメーション付きの完全なチャンクを受信。
• メディアダウンロードはchannels.line.mediaMaxMbで制限（デフォルト10）。

チャンネルデータ（リッチメッセージ）

channelData.lineでクイックリプライ、位置情報、Flexカード、テンプレートメッセージを送信可能。

{
  text: "Here you go",
  channelData: {
    line: {
      quickReplies: ["Status", "Help"],
      location: {
        title: "Office",
        address: "123 Main St",
        latitude: 35.681236,
        longitude: 139.767125,
      },
      flexMessage: {
        altText: "Status card",
        contents: {
          /* Flexペイロード */
        },
      },
      templateMessage: {
        type: "confirm",
        text: "Proceed?",
        confirmLabel: "Yes",
        confirmData: "yes",
        cancelLabel: "No",
        cancelData: "no",
      },
    },
  },
}

LINEプラグインにはFlexメッセージプリセット用の/cardコマンドも付属しています：

/card info "Welcome" "Thanks for joining!"

トラブルシューティング

• ウェブフック検証が失敗： ウェブフックURLがHTTPSであり、channelSecretがLINEコンソールと一致していることを確認。
• 受信イベントなし： ウェブフックパスがchannels.line.webhookPathと一致し、GatewayがLINEから到達可能であることを確認。
• メディアダウンロードエラー： メディアがデフォルト制限を超える場合はchannels.line.mediaMaxMbを引き上げ。