LINE

LINE は LINE Messaging API 経由で OpenClaw に接続します。この Plugin は Gateway 上の Webhook 受信機として動作し、認証には channel access token + channel secret を使用します。

ステータス: ダウンロード可能な Plugin。ダイレクトメッセージ、グループチャット、メディア、位置情報、Flex メッセージ、テンプレートメッセージ、クイック返信に対応しています。リアクションとスレッドには 対応していません。

# インストール

チャンネルを設定する前に LINE をインストールします。

openclaw plugins install @openclaw/line

ローカルチェックアウト (git リポジトリから実行する場合):

openclaw plugins install ./path/to/local/line-plugin

# セットアップ

1. LINE Developers アカウントを作成し、Console を開きます: https://developers.line.biz/console/
2. Provider を作成 (または選択) し、Messaging API チャンネルを追加します。
3. チャンネル設定から Channel access token と Channel secret をコピーします。
4. Messaging API 設定で Use webhook を有効にします。
5. Webhook URL を Gateway エンドポイントに設定します (HTTPS 必須):

https://gateway-host/line/webhook

Gateway は LINE の Webhook 検証 (GET) と受信イベント (POST) に応答します。 カスタムパスが必要な場合は、channels.line.webhookPath または channels.line.accounts.<id>.webhookPath を設定し、それに応じて URL を更新します。

セキュリティ上の注意:

• LINE の署名検証はボディに依存するため (raw body に対する HMAC)、OpenClaw は検証前に厳格な事前認証ボディ制限とタイムアウトを適用します。
• OpenClaw は、検証済みの raw request bytes から Webhook イベントを処理します。署名の完全性を安全に保つため、上流ミドルウェアによって変換された req.body 値は無視されます。

# 設定

最小設定:

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

公開 DM 設定:

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "open",
      allowFrom: ["*"],
    },
  },
}

環境変数 (デフォルトアカウントのみ):

• 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。dmPolicy: "open" には ["*"] が必要です
• 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 個の 16 進文字
• グループ: C + 32 個の 16 進文字
• ルーム: R + 32 個の 16 進文字

# メッセージの動作

• テキストは 5000 文字ごとに分割されます。
• Markdown 書式は取り除かれます。可能な場合、コードブロックとテーブルは Flex カードに変換されます。
• ストリーミング応答はバッファリングされます。エージェントが動作している間、LINE は読み込み アニメーション付きで完全なチャンクを受け取ります。
• メディアダウンロードは channels.line.mediaMaxMb (デフォルト 10) で上限設定されます。
• 受信メディアはエージェントに渡される前に ~/.openclaw/media/inbound/ の下に保存され、 他の同梱チャンネル Plugin が使用する共有メディアストアと一致します。

# チャンネルデータ (リッチメッセージ)

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 payload */
        },
      },
      templateMessage: {
        type: "confirm",
        text: "Proceed?",
        confirmLabel: "Yes",
        confirmData: "yes",
        cancelLabel: "No",
        cancelData: "no",
      },
    },
  },
}

LINE Plugin には、Flex メッセージプリセット用の /card コマンドも含まれています。

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

# ACP サポート

LINE は ACP (Agent Communication Protocol) 会話バインディングに対応しています。

• /acp spawn <agent> --bind here は、子スレッドを作成せずに現在の LINE チャットを ACP セッションにバインドします。
• 設定済みの ACP バインディングと、アクティブな会話バインド ACP セッションは、他の会話チャンネルと同様に LINE で動作します。

詳細は ACP エージェント を参照してください。

# 送信メディア

LINE Plugin は、エージェントメッセージツールを通じた画像、動画、音声ファイルの送信に対応しています。メディアは、適切なプレビューと追跡処理を備えた LINE 固有の配信パス経由で送信されます。

• 画像: 自動プレビュー生成付きの LINE 画像メッセージとして送信されます。
• 動画: 明示的なプレビューと content-type 処理付きで送信されます。
• 音声: LINE 音声メッセージとして送信されます。

送信メディア URL は公開 HTTPS URL である必要があります。OpenClaw は URL を LINE に渡す前に対象ホスト名を検証し、ループバック、リンクローカル、プライベートネットワークのターゲットを拒否します。

汎用メディア送信は、LINE 固有のパスが利用できない場合、既存の画像専用ルートにフォールバックします。

# トラブルシューティング

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

# 関連

• チャンネル概要 — 対応しているすべてのチャンネル
• ペアリング — DM 認証とペアリングフロー
• グループ — グループチャットの動作とメンションゲーティング
• チャンネルルーティング — メッセージのセッションルーティング
• セキュリティ — アクセスモデルと強化