realvco Docs

LINE 連接教學

LINE 是台灣（~90% 覆蓋率）、日本、泰國的主流通訊平台。連接 AI 需透過 LINE Official Account（以前叫 LINE@）+ Messaging API。

難度：⭐⭐⭐（介於 Telegram 和 WhatsApp 之間）

流程總覽

① LINE Developers 建立 Provider 和 Channel    ← 5 分鐘
② 取得 Channel Secret + Access Token          ← 2 分鐘
③ 在 管理儀表板（Admin Panel） 填入 + 拿到 Webhook URL      ← 1 分鐘
④ 回 LINE Developers 貼 Webhook URL           ← 1 分鐘
⑤ 關閉 LINE 預設自動回覆                      ← 30 秒
⑥ 加 Official Account 為好友，測試對話        ← 完成

準備工作

你需要：

步驟 1：建立 LINE Channel

1.1 登入 LINE Developers Console

前往 https://developers.line.biz/console/，用你的 LINE 帳號登入。

首次登入會被要求同意開發者條款。

1.2 建立 Provider

Provider 是你（或你的公司）在 LINE 平台上的「開發者身份」。一個 Provider 底下可以有多個 Channel。

  1. 點 Create → New provider
  2. 輸入 Provider 名稱（公司名或個人名稱）
  3. 送出

[截圖：LINE Developers Create Provider 畫面]

1.3 建立 Channel

  1. 在 Provider 頁面點 Create a Messaging API channel
  2. 填寫：
    • Channel name：Official Account 的顯示名稱（可中文，公開顯示）
    • Channel description：簡短描述（公開顯示）
    • Category / Subcategory：選類別
    • Email address：聯絡信箱
    • Large/Small icon：圖示（建議 1000x1000px）
  3. 同意條款 → Create

[截圖：LINE Developers Messaging API Channel 建立畫面]

步驟 2：取得 Channel 憑證

建立完成後進入 Channel 設定頁，你需要兩組資訊：

Channel Secret

  • 位置：Basic settings Tab
  • 找到「Channel secret」欄位
  • 較短的字串（32 字元）
  • 點眼睛圖示顯示，複製下來

Channel Access Token

  • 位置：Messaging API Tab
  • 最下方「Channel access token」
  • 預設是空的，點 Issue 產生
  • 選擇「Long-lived」（長期 Token）
  • 會產生一組較長的字串（約 170 字元）
  • 複製下來

這兩組憑證是密碼等級的資料。

  • 不要截圖公開
  • 不要寫死在前端程式碼
  • 洩漏可立即在 LINE Developers 重新 Issue 作廢

步驟 3：管理儀表板 設定

  1. 管理儀表板 → Ada (oc-2) Tab → 設定 → Messaging → LINE
  2. 填入：
    • Channel Secret：剛才的短字串
    • Channel Access Token：剛才的長字串
  3. 按 Save
  4. 驗證成功後會顯示「Connected」+ 給你一個 Webhook URL：
https://{你的前綴}-2.realvco.com/webhooks/line

複製這個 URL，下一步要用。

[截圖：管理儀表板 > Ada > Messaging > LINE 設定畫面 + Webhook URL]

步驟 4：設定 LINE Webhook

回到 LINE Developers Console 的 Channel 頁：

  1. Messaging API Tab
  2. 找 Webhook settings
  3. Webhook URL：貼上剛才 管理儀表板 給你的 URL
  4. 按 Update
  5. Use webhook：打開（ON）
  6. 按 Verify 測試（應顯示 Success）

[截圖：LINE Developers Webhook settings 畫面]

步驟 5：關閉 LINE 預設自動回覆

這步沒做，AI 的回覆會被 LINE 預設機器人蓋掉。

  1. 在 Messaging API Tab 頁面找 LINE Official Account features
  2. 點 Edit 進入 LINE Official Account Manager
  3. Auto-reply messages：關閉（OFF）
  4. Greeting messages：關閉（OFF，或改成你自己想要的）

[截圖：LINE Official Account Manager > 自動回覆設定]

步驟 6：加好友並測試

加 Official Account 為好友

LINE Developers 的 Messaging API Tab 最上方有：

  • Bot basic ID（如 @123abcde）
  • QR code

用你的 LINE 掃 QR Code 或搜尋 ID 加好友。

傳第一則訊息

加好友後傳任意訊息，Ada 應該在 1-3 秒內回覆。

如果沒回應，看 常見問題。

進階設定

LINE Messaging API 免費額度

  • 回覆訊息（使用者先發訊你才回）：不計費
  • 主動推播：每月前 500 則免費，之後需訂閱
    • Light 方案：$10/月，5,000 則
    • Standard 方案：$45/月，30,000 則
    • Premium 方案：$225/月，不限

大部分客服用途用回覆訊息即可，不會超額。

媒體支援

LINE Messaging API 支援：

  • ✅ 文字
  • ✅ 圖片（AI 可讀取）
  • ✅ 貼圖（AI 收到會識別為「貼圖」訊息，不會真的讀取貼圖意涵）
  • ✅ 音訊（自動轉文字）
  • ✅ 影片（AI 可讀取）
  • ✅ Flex Message（彈性版型卡片）— AI 可發送

限制對話對象

對 Rose 說：「只允許特定 LINE User 對 Ada 傳訊，他們的 User ID 是 Uxxxx…」

或手動：

openclaw config set channels.line.dmPolicy "allowlist"
openclaw config set channels.line.allowFrom '["Uxxxxxxxxxxxxxxxxxx"]'

取得 LINE User ID：對方傳訊後，在 管理儀表板 → Ada Dashboard → 活動 的訊息紀錄裡會顯示。

群組聊天

LINE 允許把 Official Account 加入群組（需群組成員邀請）：

  1. 邀請 Bot 到群組
  2. 預設 Bot 只會回覆 @Bot名稱 的訊息
  3. 關閉此限制：對 Rose 說「讓 Ada 在 LINE 群組裡所有訊息都回覆，不用 @mention」

或手動：

openclaw config set channels.line.groups."*".requireMention false

Rich Menu（固定選單）

LINE 獨有功能 — 對話視窗底部的固定選單。建議常用指令設為 Rich Menu：

  1. LINE Developers → Rich Menu Manager（或直接在 LINE Official Account Manager）
  2. 設計 2500x1686 的圖片 + 熱區
  3. 每個熱區對應一個訊息（AI 會收到該訊息並回應）

常見問題

Webhook Verify 失敗

  • Webhook URL 是否完整（包含 https:// 和 /webhooks/line）
  • Ada 容器是否 Running
  • Channel Access Token 是否為「Long-lived」而非臨時 Token
  • 換瀏覽器或清快取再試（LINE Console 偶爾有快取問題）

AI 沒回應但 Webhook Verify 成功

十之八九是 LINE 預設自動回覆沒關（步驟 5）。使用者的訊息被 LINE 機器人先處理掉了。

檢查：LINE Official Account Manager → Response settings → Auto-response 是否為 OFF。

回應很慢（超過 5 秒）

  • LINE 的 Webhook 機制本身就比 Telegram 慢一點（經過 LINE 轉發 + 你的 Cloudflare Tunnel）
  • 正常 2-4 秒是可接受的
  • 超過 10 秒通常是 AI 模型端慢，不是 LINE 問題

每月 500 則限制是什麼意思

只限制「主動推播」。使用者傳給你、你回覆，都不算推播。

如果你想用 AI 定期主動發訊（例如每天早上推播天氣），500 則/月很快就用光。超過會被擋或計費。

可以同時連接多個 LINE Channel 嗎

可以，但每個 AI 夥伴只能綁一個 LINE Channel。如果要多個：

  • 建多個 Channel
  • 分別綁 Rose、Ada、Vi
  • 或啟用 Vi 的 Profiles 多實例

下一步