行 - OpenClaw

LINE 透過 LINE Messaging API 連接到 OpenClaw。Plugin 會在 Gateway 上作為 Webhook 接收器執行，並使用你的頻道存取權杖與頻道密鑰進行驗證。狀態：可下載的 Plugin。支援私訊、群組聊天、媒體、位置、Flex 訊息、範本訊息和快速回覆。不支援回應和對話串。

安裝

設定頻道前，請先安裝 LINE：

openclaw plugins install @openclaw/line

本機簽出（從 git repo 執行時）：

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

設定

建立 LINE Developers 帳戶並開啟主控台： https://developers.line.biz/console/
建立（或選取）Provider，並新增 Messaging API 頻道。
從頻道設定複製 Channel access token 和 Channel secret。
在 Messaging API 設定中啟用 Use webhook。
將 Webhook URL 設為你的 Gateway 端點（需要 HTTPS）：

https://gateway-host/line/webhook

Gateway 會回應 LINE 的 Webhook 驗證（GET）和傳入事件（POST）。如果你需要自訂路徑，請設定 channels.line.webhookPath 或 channels.line.accounts.<id>.webhookPath，並相應更新 URL。安全注意事項：

LINE 簽章驗證依賴請求本文（對原始本文執行 HMAC），因此 OpenClaw 會在驗證前套用嚴格的預先驗證本文大小限制和逾時。
OpenClaw 會從已驗證的原始請求位元組處理 Webhook 事件。為確保簽章完整性安全，會忽略上游中介軟體轉換後的 req.body 值。

設定組態

最小組態：

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

公開私訊組態：

{
  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：允許私訊的 LINE 使用者 ID；dmPolicy: "open" 需要 ["*"]
channels.line.groupPolicy：allowlist | open | disabled
channels.line.groupAllowFrom：允許群組的 LINE 使用者 ID
每個群組覆寫：channels.line.groups.<groupId>.allowFrom
靜態傳送者存取群組可由 allowFrom、groupAllowFrom 和每個群組的 allowFrom 使用 accessGroup:<name> 參照。
執行階段注意事項：如果完全缺少 channels.line，執行階段會對群組檢查退回使用 groupPolicy="allowlist"（即使已設定 channels.defaults.groupPolicy）。

LINE ID 區分大小寫。有效 ID 如下：

使用者：U + 32 個十六進位字元
群組：C + 32 個十六進位字元
聊天室：R + 32 個十六進位字元

訊息行為

文字會以 5000 個字元為單位分段。
Markdown 格式會被移除；可行時，程式碼區塊和表格會轉換為 Flex 卡片。
串流回應會被緩衝；Agent 工作時，LINE 會收到完整分段並顯示載入動畫。
媒體下載受 channels.line.mediaMaxMb 限制（預設 10）。
傳入媒體會先儲存在 ~/.openclaw/media/inbound/ 下，再傳遞給 Agent，這與其他內建頻道 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 也提供 /card 指令用於 Flex 訊息預設集：

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

ACP 支援

LINE 支援 ACP (Agent Communication Protocol) 對話綁定：

/acp spawn <agent> --bind here 會將目前的 LINE 聊天綁定到 ACP 工作階段，而不建立子對話串。
已設定的 ACP 綁定和作用中的對話綁定 ACP 工作階段在 LINE 上的運作方式與其他對話頻道相同。

詳情請參閱 ACP Agent。

傳出媒體

LINE Plugin 支援透過 Agent 訊息工具傳送圖片、影片和音訊檔案。媒體會透過 LINE 專用遞送路徑傳送，並具備適當的預覽和追蹤處理：

圖片：以 LINE 圖片訊息傳送，並自動產生預覽。
影片：以明確的預覽和內容類型處理傳送。
音訊：以 LINE 音訊訊息傳送。

傳出媒體 URL 必須是公開 HTTPS URL。OpenClaw 會先驗證目標主機名稱，再將 URL 交給 LINE，並拒絕 local loopback、link-local 和私有網路目標。當 LINE 專用路徑不可用時，一般媒體傳送會退回使用既有的僅圖片路由。

疑難排解

Webhook 驗證失敗： 確認 Webhook URL 是 HTTPS，且 channelSecret 與 LINE 主控台相符。
沒有傳入事件： 確認 Webhook 路徑符合 channels.line.webhookPath，且 Gateway 可由 LINE 連線。
媒體下載錯誤： 如果媒體超過預設限制，請提高 channels.line.mediaMaxMb。

Documentation Index

​安裝

​設定

​設定組態

​存取控制

​訊息行為

​頻道資料（豐富訊息）

​ACP 支援

​傳出媒體

​疑難排解

​相關

安裝

設定