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。外掛會在閘道上以網路鉤子 接收器的形式執行，並使用你的 channel access token 與 channel secret 進行 驗證。

狀態：官方外掛，需另行安裝。支援私訊、群組聊天、媒體、 位置、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），它會先將每個事件寫入持久化輸入佇列，再回傳 200； 代理程式會繼續以非同步方式處理。傳遞失敗時會從 佇列重試，包括閘道重新啟動後；有害事件在有限次重試後會成為失敗的佇列 記錄。如果持久化儲存失敗，請求會回傳 500，而不會確認可能遺失的事件。 佇列至代理程式的邊界採至少一次傳遞：在進行中的傳遞期間，如果閘道關閉或 當機，可能會重新執行該輪對話。訊息事件會依 LINE 訊息 ID 去除重複；其他事件類型使用 webhookEventId。保留的完成記錄 會抑制一般的重複網路鉤子，但會執行外部副作用的處理常式 仍應具備等冪性。 如需自訂路徑，請設定 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 清單；私訊的 allowFrom 項目不會允許群組傳送者
  • 各群組覆寫：channels.line.groups.<groupId>.allowFrom（以及 enabled、requireMention、systemPrompt、skills）。使用 groupPolicy: "allowlist" 時，請設定 groupAllowFrom 或各群組的 allowFrom；即使私訊為開放狀態，空白的群組允許清單仍會封鎖群組訊息。
  • 靜態傳送者存取群組可透過 accessGroup:<name>，從 allowFrom、groupAllowFrom 和各群組的 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/， 與其他頻道外掛所使用的共用媒體儲存區一致。

頻道資料（豐富訊息）

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

json5
{  text: "這是你要的",  channelData: {    line: {      quickReplies: ["狀態", "說明"],      location: {        title: "辦公室",        address: "123 Main St",        latitude: 35.681236,        longitude: 139.767125,      },      flexMessage: {        altText: "狀態卡片",        contents: {/* Flex 承載資料 */},      },      templateMessage: {        type: "confirm",        text: "要繼續嗎？",        confirmLabel: "是",        confirmData: "yes",        cancelLabel: "否",        cancelData: "no",      },    },  },}

LINE 外掛也提供用於 Flex 訊息預設集的 /card 命令：

text
/card info "歡迎" "感謝你的加入！"

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 必須是最多 2000 個字元的公開 HTTPS URL。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