English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Regional platforms

行

LINE 透過 LINE Messaging API 連接到 OpenClaw。此 Plugin 會在 Gateway 上作為 Webhook 接收器執行，並使用你的頻道存取權杖 + 頻道密鑰進行 驗證。

狀態：可下載的 Plugin。支援私訊、群組聊天、媒體、位置、Flex 訊息、範本訊息和快速回覆。不支援反應和討論串。

安裝

設定頻道前先安裝 LINE：

openclaw plugins install @openclaw/line

本機 checkout（從 git repo 執行時）：

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 簽章驗證依賴請求主體（對原始主體執行 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 &lt;CODE&gt;

允許清單與政策：

  • 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
  • 執行階段注意事項：如果完全缺少 channels.line，執行階段會在群組檢查時退回到 groupPolicy="allowlist"（即使已設定 channels.defaults.groupPolicy）。

LINE ID 區分大小寫。有效 ID 看起來像：

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

訊息行為

  • 文字會以 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 圖片訊息傳送，並自動產生預覽。
  • 影片：傳送時會明確處理預覽和內容類型。
  • 音訊：以 LINE 音訊訊息傳送。

傳出媒體 URL 必須是公開 HTTPS URL。OpenClaw 會在將 URL 交給 LINE 前驗證目標主機名稱，並拒絕 loopback、link-local 和 private-network 目標。

當 LINE 專屬路徑不可用時，通用媒體傳送會退回到既有的僅圖片路由。

疑難排解

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

相關