OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Regional platforms

LINE

LINE 透過 LINE Messaging API 連接至 OpenClaw。此外掛在閘道上作為網路鉤子接收器執行，並使用你的頻道存取權杖與頻道密鑰進行驗證。

狀態：官方外掛，需另行安裝。支援私訊、群組聊天、媒體、位置、Flex 訊息、範本訊息及快速回覆。不支援表情回應與討論串。

安裝

設定頻道前，先安裝 LINE：

bash
openclaw plugins install @openclaw/line

本機簽出版本（從 git 儲存庫執行時）：

bash
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. 將網路鉤子 URL 設為你的閘道端點（必須使用 HTTPS）：
text
https://gateway-host/line/webhook

閘道會回應 LINE 的網路鉤子驗證（GET），並在驗證簽章及承載資料後，立即確認收到已簽署的傳入事件（POST）；代理程式處理會以非同步方式繼續進行。 如需自訂路徑，請設定 channels.line.webhookPath 或 channels.line.accounts.<id>.webhookPath，並相應更新 URL。

安全性注意事項：

  • LINE 的簽章驗證取決於本文內容（對原始本文執行 HMAC），因此 OpenClaw 會在驗證前套用嚴格的本文大小限制（64 KB）與讀取逾時。
  • OpenClaw 會根據已驗證的原始請求位元組處理網路鉤子事件。為確保簽章完整性安全，會忽略經上游中介軟體轉換的 req.body 值。

組態

最小組態：

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

公開私訊組態：

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

環境變數（僅適用於預設帳號）：

  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET

權杖／密鑰檔案：

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

tokenFile 與 secretFile 必須指向一般檔案。不接受符號連結。 行內組態值優先於檔案；對預設帳號而言，環境變數是最後的備援來源。

多個帳號：

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

存取控制

私訊預設使用配對。未知傳送者會取得配對碼，其訊息在獲得核准前將被忽略：

bash
openclaw pairing list lineopenclaw pairing approve line &lt;CODE&gt;

允許清單與政策：

  • channels.line.dmPolicy：pairing | allowlist | open | disabled（預設為 pairing）
  • channels.line.allowFrom：私訊允許清單中的 LINE 使用者 ID；dmPolicy: "open" 需要 ["*"]
  • channels.line.groupPolicy：allowlist | open | disabled（預設為 allowlist）
  • channels.line.groupAllowFrom：群組允許清單中的 LINE 使用者 ID
  • 各群組覆寫：channels.line.groups.<groupId>.allowFrom（以及 enabled、requireMention、systemPrompt、skills）
  • allowFrom、groupAllowFrom 及各群組的 allowFrom 可使用 accessGroup:<name> 參照靜態傳送者存取群組；請參閱存取群組。
  • 執行階段注意事項：若完全缺少 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/，再傳遞給代理程式；此路徑與其他頻道外掛使用的共用媒體儲存區一致。

頻道資料（豐富訊息）

使用 channelData.line 傳送快速回覆、位置、Flex 卡片或範本訊息。

json5
{  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 外掛也提供用於 Flex 訊息預設樣式的 /card 命令：

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

ACP 支援

LINE 支援 ACP（代理程式通訊協定）對話繫結：

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

詳情請參閱 ACP 代理程式。

傳出媒體

LINE 外掛會透過代理程式訊息工具傳送圖片、影片與音訊：

  • 圖片：以 LINE 圖片訊息傳送；預覽圖片預設使用媒體 URL。
  • 影片：需要預覽圖片；請將 channelData.line.previewImageUrl 設為圖片 URL。
  • 音訊：以 LINE 音訊訊息傳送；除非設定 channelData.line.durationMs，否則持續時間預設為 60 秒。

若有設定 channelData.line.mediaKind，便以其決定媒體類型；否則會從其他 LINE 選項或 URL 檔案副檔名推斷，並以圖片作為備援類型。

傳出媒體 URL 必須是公開的 HTTPS URL，且長度不得超過 2000 個字元。OpenClaw 會先驗證目標主機名稱，再將 URL 交給 LINE，並拒絕回送、本機連結及私人網路目標。

未使用 LINE 專屬選項的一般媒體傳送會採用圖片路徑。

疑難排解

  • **網路鉤子驗證失敗：**請確認網路鉤子 URL 使用 HTTPS，且 channelSecret 與 LINE Console 中的值相符。
  • **沒有傳入事件：**請確認網路鉤子路徑與 channels.line.webhookPath 相符，且 LINE 可連線至閘道。
  • **媒體下載錯誤：**若媒體超過預設限制，請提高 channels.line.mediaMaxMb。

相關內容

Was this useful?
On this page

On this page