本網站為獨立社群專案，與 OpenClaw 官方無任何關聯。內容僅供參考。 了解更多

翻譯文件

本頁為社群翻譯版本，可能與官方最新內容有出入。 查看官方英文原文 →

LINE

透過 LINE Messaging API 外掛整合 OpenClaw 與 LINE，支援私訊、群組和豐富訊息。

LINE 外掛讓 OpenClaw 能透過 LINE Messaging API 整合 LINE 通訊平台，作為 Gateway 上的 webhook 接收器運作。

功能支援

此外掛支援私訊、群組聊天、媒體、位置、Flex 訊息、範本訊息和快速回覆。目前不支援表情回應和對話串。

安裝與設定

安裝

openclaw plugins install @openclaw/line

設定步驟

  1. 在 LINE Developers Console 中建立 Messaging API 頻道
  2. 取得 Channel Access Token 和 Channel Secret
  3. 在設定檔中配置或使用環境變數（LINE_CHANNEL_ACCESS_TOKEN、LINE_CHANNEL_SECRET）
  4. 設定 webhook URL 指向 https://gateway-host/line/webhook（必須使用 HTTPS）

存取控制

私訊預設為配對模式。未知傳送者會收到配對代碼，在核准前其訊息將被忽略。

管理員可以使用有效的 LINE ID 分別管理私訊和群組的允許清單和策略：

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

訊息處理

  • 文字訊息以 5,000 字元為單位分段
  • Markdown 格式會被移除
  • 程式碼區塊會轉換為 Flex 卡片
  • 串流回應會被緩衝，並顯示載入動畫
  • 媒體下載預設上限為 10 MB

豐富訊息

代理可透過 channelData.line 物件傳送互動內容，包括：

  • 快速回覆
  • 位置資料
  • Flex 卡片
  • 範本訊息與自訂負載

/card 指令提供 Flex 訊息預設範本。

疑難排解

常見問題包括：

  • Webhook 驗證失敗 — 檢查 HTTPS 設定是否正確
  • 缺少接收事件 — 確認路徑和可達性
  • 媒體錯誤 — 嘗試增加檔案大小限制