尚未安裝 OpenClaw?點此查看一鍵安裝指令
curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
擔心影響電腦?ClawTank 免安裝雲端運行,免除誤刪風險
Key Findings
  • LINE 在台灣擁有超過 2,100 萬月活躍用戶,滲透率逾 90%,是部署 AI 客服代理的最佳通路選擇[9]
  • OpenClaw 串接 LINE Official Account 僅需四步驟:建立 Messaging API Channel、設定 Channel Token 與 Secret、配置 Webhook、完成 Pairing 配對驗證[1]
  • 透過 OpenClaw Gateway 的 Remote 模式,LINE 用戶的訊息可即時轉發至 AI 代理,實現企業級 AI 客服自動回覆、工單分派與多輪對話[5]
  • Rich Menu、Flex Message 與多媒體訊息支援,讓 AI 代理不只能回覆文字,更能呈現結構化卡片、圖文選單與互動按鈕[2]
  • 企業部署需特別注意 LINE Messaging API 的速率限制、Token 輪換機制與安全性最佳實踐,確保生產環境穩定運行[7]

一、為什麼選擇 LINE × OpenClaw?

1.1 台灣市場的 LINE 霸主地位

在台灣的即時通訊市場中,LINE 的地位幾乎無可撼動。根據 LINE 官方公布的數據,LINE 在台灣擁有超過 2,100 萬月活躍用戶,滲透率高達 90% 以上。[9] 從青少年到銀髮族、從個人社交到企業溝通,LINE 已成為台灣人日常生活的數位基礎設施。這意味著,如果你的企業想要在台灣部署 AI 客服代理,LINE Official Account 幾乎是唯一能觸及全客層的通路。

與其要求客戶下載新的 App 或造訪陌生的網頁介面,不如讓 AI 直接住進他們每天使用的 LINE 裡——這正是 OpenClaw 串接 LINE 的核心價值。

1.2 LINE Official Account 的商業優勢

LINE Official Account(前身為 LINE@)為企業提供了完整的商業通訊基礎設施:[3]

1.3 OpenClaw 為 LINE 帶來什麼?

傳統的 LINE Bot 開發需要自行架設伺服器、處理 Webhook、管理對話狀態,並整合 NLP 引擎——這些工程工作往往比 AI 對話本身更為繁複。OpenClaw 徹底改變了這個流程:[8]

二、前置準備

在開始串接之前,請確認以下三項前置條件已就緒:

2.1 LINE Developers 帳號

前往 LINE Developers 註冊或登入你的帳號。如果你還沒有 LINE Developers 帳號,可以使用現有的 LINE 個人帳號登入,系統會自動引導你完成開發者帳號的建立流程。[2]

2.2 LINE Official Account

前往 LINE Official Account Manager 建立或確認你的 LINE 官方帳號。[3] 選擇適合你業務規模的方案:

方案月費(NTD)免費推播訊息數適用場景
免費$0500 則小型企業或測試環境
輕量$8004,000 則中小型企業日常客服
進階$4,00025,000 則中大型企業高流量客服

重要提示:AI 客服的自動回覆屬於 Reply Message(回覆訊息),不計入推播訊息額度。只有主動推播(Push Message)才會扣除免費額度。因此即使是免費方案,也能應對大量的客服對話。

2.3 OpenClaw 已安裝並運行

如果你尚未安裝 OpenClaw,請參閱頁首的一鍵安裝指令,或前往《架構解析與實戰部署全指南》完成完整部署。確認 OpenClaw 已正常運行:[4]

openclaw --version
openclaw gateway status

你應該看到版本號輸出與 Gateway 的運行狀態。如果 Gateway 尚未啟動,執行:

openclaw gateway start

三、步驟一:建立 LINE Messaging API Channel

LINE 的 Bot 功能透過「Messaging API Channel」提供。以下是在 LINE Developers Console 中建立 Channel 的完整步驟:[2]

3.1 建立 Provider

  1. 登入 LINE Developers Console
  2. 點擊「Create a new provider」
  3. 輸入 Provider 名稱(通常使用你的公司名稱,例如「My Company」)
  4. 點擊「Create」

Provider 是 LINE Developers 中的最上層組織單位,一個 Provider 下可以建立多個 Channel。建議以公司或團隊為單位建立 Provider。

3.2 建立 Messaging API Channel

  1. 在剛建立的 Provider 頁面中,點擊「Create a Messaging API channel」
  2. 填寫 Channel 基本資訊:
    • Channel type:選擇「Messaging API」
    • Channel name:你的 Bot 顯示名稱(例如「AI 智慧客服」)
    • Channel description:Bot 的簡短描述
    • Category / Subcategory:選擇最接近你業務的類別
    • Email address:聯絡用電子郵件
  3. 勾選同意 LINE 的使用條款,點擊「Create」

3.3 取得 Channel Secret 與 Channel Access Token

Channel 建立完成後,你需要取得兩組關鍵憑證:

取得 Channel Secret:

  1. 進入剛建立的 Channel 頁面
  2. 切換到「Basic settings」分頁
  3. 找到「Channel secret」欄位,點擊複製

取得 Channel Access Token:

  1. 切換到「Messaging API」分頁
  2. 捲動至頁面底部,找到「Channel access token (long-lived)」
  3. 點擊「Issue」按鈕產生一組長期有效的 Token
  4. 複製產生的 Token

務必妥善保管這兩組憑證——Channel Secret 用於驗證 Webhook 請求的簽章,Channel Access Token 則用於 Bot 發送訊息。擁有這兩組憑證的人可以完全控制你的 Bot。

3.4 關閉預設的自動回覆

LINE Official Account 預設啟用「自動回應訊息」與「加入好友的歡迎訊息」,這些功能會與 OpenClaw 的 AI 回覆衝突。你需要將它們關閉:[3]

  1. 前往 LINE Official Account Manager
  2. 選擇你的官方帳號
  3. 進入「設定」→「回應設定」
  4. 將「自動回應訊息」設為停用
  5. 將「Webhook」設為啟用

這一步非常關鍵。如果忘記關閉自動回覆,用戶會同時收到 LINE 預設的罐頭回覆和 OpenClaw AI 的回覆,造成混亂的使用體驗。

四、步驟二:OpenClaw 端設定

取得 Channel Secret 與 Channel Access Token 後,回到你的終端機,將這兩組憑證寫入 OpenClaw 的設定中:[1]

4.1 設定 Channel Access Token

openclaw config set channels.line.channelAccessToken "你的_CHANNEL_ACCESS_TOKEN"

4.2 設定 Channel Secret

openclaw config set channels.line.channelSecret "你的_CHANNEL_SECRET"

4.3 驗證設定

設定完成後,可以透過以下指令確認設定是否正確寫入:

openclaw config get channels.line

你應該看到類似以下的輸出(Token 會以遮罩方式顯示):

{
"channelAccessToken": "****...****Xk3d",
"channelSecret": "****...****a1b2",
"enabled": true
}

4.4 設定 AI 代理的語言偏好

由於 LINE 在台灣的使用者以中文為主,建議在代理的 System Prompt 中明確設定語言偏好:

openclaw config set agent.systemPrompt "你是一位專業的 AI 客服助理。請全程使用繁體中文回覆。保持回覆精簡但完整,適當使用條列式格式提升可讀性。"

然後重啟 Gateway 讓所有設定生效:

openclaw gateway restart

五、步驟三:Webhook 配置與 Pairing

LINE Messaging API 採用 Webhook 架構——當用戶發送訊息給你的 Bot 時,LINE 平台會將訊息以 HTTP POST 的形式傳送到你指定的 Webhook URL。OpenClaw 的 Gateway 負責接收這些 Webhook 請求。[5]

5.1 Gateway Remote 模式

要讓外部的 LINE 平台能夠將訊息傳送到你的 OpenClaw 實例,你需要以 Remote 模式啟動 Gateway:

openclaw gateway start --mode remote

Remote 模式會讓 Gateway 監聽公開端口,接收來自 LINE 的 Webhook 請求。如果你的伺服器位於防火牆或 NAT 後方,你需要以下其中一種方式暴露 Gateway 端點:

以 Cloudflare Tunnel 為例:

# 安裝 cloudflared
brew install cloudflare/cloudflare/cloudflared

# 建立隧道並指向 Gateway 的本地端口(預設 8080)
cloudflared tunnel --url http://localhost:8080

執行後,cloudflared 會輸出一個 https://xxxx-xxxx.trycloudflare.com 的公開 URL。

5.2 在 LINE Developers Console 設定 Webhook URL

取得公開 URL 後,回到 LINE Developers Console:[2]

  1. 進入你的 Messaging API Channel
  2. 切換到「Messaging API」分頁
  3. 找到「Webhook settings」區塊
  4. 在「Webhook URL」欄位填入:https://你的公開域名/webhooks/line
  5. 點擊「Update」儲存
  6. 點擊「Verify」按鈕進行驗證——如果設定正確,會顯示「Success」
  7. 確認「Use webhook」開關已設為啟用

注意 Webhook URL 的路徑:OpenClaw Gateway 預設的 LINE Webhook 接收路徑為 /webhooks/line。如果你自訂了 Gateway 的路由設定,請確保路徑一致。

5.3 Webhook 簽章驗證

LINE 的 Webhook 請求會在 HTTP Header 中附帶 x-line-signature 簽章,用於驗證請求確實來自 LINE 平台而非惡意偽造。OpenClaw 會自動使用你設定的 Channel Secret 來驗證這個簽章。[7]

如果你在驗證步驟收到 400 錯誤,最常見的原因是 Channel Secret 設定錯誤。請重新確認:

# 檢查 Channel Secret 是否正確
openclaw config get channels.line.channelSecret

5.4 完成 Pairing 配對驗證

Webhook 設定完成後,你需要完成 OpenClaw 的 Pairing(配對)驗證——這是 OpenClaw 確保只有授權的 LINE 帳號能控制代理的安全機制。[10]

  1. 在 LINE 中加入你的官方帳號為好友,並發送任意訊息
  2. Bot 會回覆「Pairing Required」以及一組六位數配對碼
  3. 在終端機中執行配對指令:
# 查看待配對的連線
openclaw pairing list

# 輸出範例:
# ID       Channel   User          Status
# p_abc123 line      U1a2b3c4d5e6  pending

# 批准配對
openclaw pairing approve p_abc123

配對完成後,Bot 會在 LINE 中回覆確認訊息。此後你就可以在 LINE 中與 AI 代理正常對話了。

5.5 測試串接是否成功

完成上述所有步驟後,向你的 LINE 官方帳號發送一則測試訊息:

「你好,請自我介紹一下。」

如果一切正常,你應該在幾秒內收到 AI 代理的回覆。如果沒有回應,請參考本文第十節的疑難排解。

六、步驟四:群組與權限管理

OpenClaw 提供精細的存取控制機制,讓你決定誰可以透過 LINE 與 AI 代理互動。[1]

6.1 DM Policy(私訊政策)

DM Policy 控制哪些 LINE 用戶可以透過一對一私訊與代理互動:

# 設定私訊政策
openclaw config set channels.line.dmPolicy "allowlist"

# 新增白名單用戶(User ID 可從 LINE Developers Console 取得)
openclaw config set channels.line.allowlist '["U1a2b3c4d5e6f7g8h9i0j","Uk9l8m7n6o5p4q3r2s1t"]'

企業客服場景:如果你要部署面向公眾的 AI 客服,需要將 DM Policy 設為 anyone,讓所有加入好友的客戶都能使用。但這也意味著你需要更嚴格地控制代理的能力範圍——確保它只能做客服相關的事,而不能存取你的電腦檔案或執行系統指令。

# 公開客服模式
openclaw config set channels.line.dmPolicy "anyone"

# 限制代理的能力範圍(僅允許知識庫查詢,禁止檔案操作)
openclaw config set agent.skills '["knowledge-query","faq-lookup"]'

6.2 Group Policy(群組政策)

如果你想將 Bot 加入 LINE 群組,群組中的存取控制由 groupPolicy 管理:

# 設定群組政策
openclaw config set channels.line.groupPolicy "allowlist"

# 新增允許的群組 ID
openclaw config set channels.line.groupAllowlist '["C1a2b3c4d5e6f7g8h9i0j"]'

群組中的互動方式有兩種:

# 設定群組觸發模式
openclaw config set channels.line.groupTrigger "mention"

6.3 管理員權限分級

對於多人管理的企業場景,OpenClaw 支援管理員權限分級:

角色權限適用對象
Owner完整控制權:修改設定、管理配對、操控電腦系統管理員
Admin與代理對話、觸發預設任務,但無法修改設定部門主管
User僅能透過預設的 Skill 與代理互動一般員工或客戶
# 設定管理員
openclaw config set channels.line.admins '["U_admin_user_id_1","U_admin_user_id_2"]'

七、進階功能:Rich Menu 與多媒體訊息

LINE Messaging API 提供了豐富的互動元素,超越純文字對話。OpenClaw 可以利用這些功能提升 AI 客服的使用體驗。[2]

7.1 Rich Menu(圖文選單)

Rich Menu 是 LINE 聊天室底部的自訂選單,用戶點擊選單中的按鈕即可觸發預設動作。你可以透過 LINE Official Account Manager 建立 Rich Menu,或透過 Messaging API 以程式化方式管理。

透過 LINE Official Account Manager 建立:

  1. 進入 LINE Official Account Manager → 聊天室相關 → 圖文選單
  2. 選擇模板(版面配置)
  3. 為每個區域設定動作類型:
    • 文字:點擊後自動發送預設文字(例如「查詢訂單」、「聯繫真人客服」)
    • URI:點擊後開啟網頁連結
    • Postback:發送自訂資料給 Webhook,不在聊天室顯示
  4. 設定顯示期間與預設開啟狀態

搭配 OpenClaw 的使用技巧:將 Rich Menu 的按鈕文字設定為自然語言指令,例如:

7.2 Flex Message(彈性訊息)

Flex Message 是 LINE 獨有的結構化訊息格式,可以建立類似卡片(Card)的豐富排版。OpenClaw 支援透過 JSON 模板發送 Flex Message:

# 在 OpenClaw 的 Skill 中定義 Flex Message 模板
# config/skills/line-product-card.json
{
"type": "flex",
"altText": "產品資訊",
"contents": {
"type": "bubble",
"hero": {
  "type": "image",
  "url": "https://example.com/product.jpg",
  "size": "full",
  "aspectRatio": "20:13"
},
"body": {
  "type": "box",
  "layout": "vertical",
  "contents": [
    {"type": "text", "text": "{{product_name}}", "weight": "bold", "size": "xl"},
    {"type": "text", "text": "NT$ {{price}}", "size": "lg", "color": "#b8922e"}
  ]
},
"footer": {
  "type": "box",
  "layout": "vertical",
  "contents": [
    {"type": "button", "action": {"type": "uri", "label": "立即購買", "uri": "{{buy_url}}"}}
  ]
}
}
}

當 AI 代理需要展示產品資訊、訂單明細或其他結構化內容時,會自動使用對應的 Flex Message 模板,取代單調的純文字回覆。

7.3 多媒體訊息處理

OpenClaw 支援接收與處理 LINE 用戶發送的多媒體訊息:

# 啟用多媒體訊息處理
openclaw config set channels.line.mediaHandling "enabled"

# 設定多媒體處理模型(需要多模態能力)
openclaw config set agent.visionModel "gpt-4o"

八、企業級部署:多帳號管理與流量控制

8.1 LINE Messaging API 速率限制

LINE Messaging API 有嚴格的速率限制,企業級部署必須妥善處理:[2]

API 類型速率限制說明
Reply Message無速率限制回覆用戶訊息,必須在收到 Webhook 後 30 秒內使用 Reply Token
Push Message100,000 次/分鐘主動推播,受方案額度限制
Multicast100,000 次/分鐘多人推播,同樣受方案額度限制
取得用戶資料2,000 次/分鐘查詢用戶基本資料

關鍵注意事項:Reply Token 的有效期僅 30 秒。這意味著 AI 代理必須在 30 秒內完成推理並回覆。如果你使用的 LLM 推理速度較慢(例如 o3-pro),可能會超時。解決方案:

# 設定快速回覆模型(用於初始回應)
openclaw config set channels.line.quickReplyModel "claude-3-haiku"

# 設定深度推理模型(用於複雜問題)
openclaw config set channels.line.deepModel "claude-sonnet-4"

OpenClaw 會先使用快速模型回覆一則初始回應(例如「正在為您查詢,請稍候...」),然後以 Push Message 發送深度推理的結果,避免 Reply Token 超時。

8.2 多帳號管理

大型企業通常擁有多個 LINE Official Account(例如各品牌、各門市、各部門各一個)。OpenClaw 支援在同一個實例中管理多個 LINE Channel:

# 設定多個 LINE Channel
openclaw config set channels.line.accounts '{
"brand-a": {
"channelAccessToken": "TOKEN_A",
"channelSecret": "SECRET_A",
"agent": "customer-service-a"
},
"brand-b": {
"channelAccessToken": "TOKEN_B",
"channelSecret": "SECRET_B",
"agent": "customer-service-b"
}
}'

每個 LINE Channel 可以綁定不同的 AI 代理(Agent),配備不同的知識庫與 Skill,實現品牌差異化的客服體驗。

8.3 監控與告警

生產環境中,你需要監控 LINE Channel 的運行狀態。OpenClaw 提供內建的監控指標:

# 查看 Gateway 運行狀態與用量
openclaw status

# 輸出範例:
# Gateway: running
# Channels: line (connected)
# Uptime: 3d 12h
# API calls (24h): 1,247

建議設定以下告警規則:

8.4 高可用架構

對於要求 24/7 不間斷的企業客服場景,建議採用以下高可用架構:[5]

  1. 多實例部署:至少部署兩個 OpenClaw Gateway 實例,以負載平衡器分配流量
  2. 資料庫備援:使用 PostgreSQL 或 Redis 作為 OpenClaw 的持久化儲存,配置主從備援
  3. Webhook 重試機制:LINE 在 Webhook 回應失敗時會自動重試(最多 3 次),確保 Gateway 具備冪等性(Idempotency)處理
  4. 跨區域部署:如果客戶分布在多個地區,可在不同雲端區域部署 Gateway,降低網路延遲

九、疑難排解

以下彙整了 OpenClaw 串接 LINE 時最常見的問題與解決方案:

問題可能原因解決方案
Bot 完全沒有回應Gateway 未啟動;Webhook URL 設定錯誤;Channel Access Token 無效執行 openclaw gateway status 確認運行中;在 LINE Developers Console 重新驗證 Webhook URL;重新 Issue Token
Webhook 驗證失敗(400 錯誤)Channel Secret 設定錯誤;Webhook URL 路徑不正確重新確認 Channel Secret(openclaw config get channels.line.channelSecret);確保路徑為 /webhooks/line
「Pairing Required」反覆出現配對未完成或已過期執行 openclaw pairing list 查看狀態,重新 openclaw pairing approve
回覆延遲超過 30 秒LLM 推理速度慢;Reply Token 已過期改用快速模型(Haiku)作為初始回覆;啟用雙模型架構(快速回覆 + Push 深度回覆)
群組中 Bot 不回應Bot 權限不足;groupPolicy 未設定在群組設定中將 Bot 加為成員;確認 groupPolicygroupAllowlist 設定正確
多媒體訊息無法處理mediaHandling 未啟用;未設定多模態模型執行 openclaw config set channels.line.mediaHandling "enabled";設定 visionModel
中文回覆出現亂碼模型未設定中文偏好;編碼問題在 System Prompt 中加入語言偏好;確認 Gateway 的 Response Encoding 為 UTF-8
Rich Menu 按鈕無效動作設定錯誤;Postback Data 未被 OpenClaw 處理確認 Rich Menu 的動作類型為「文字」(自動發送預設文字);或在 OpenClaw 中設定 Postback 處理
Token 過期或被撤銷Channel Access Token 被手動撤銷或 LINE 安全性機制觸發在 LINE Developers Console 重新 Issue Token 並更新 OpenClaw 設定

9.1 進階除錯:查看 Gateway 日誌

如果上述常見問題無法解決你的情況,可以透過 Gateway 日誌進行深入除錯:

# 查看即時日誌
openclaw logs --follow

# 查看最近 100 條日誌
openclaw logs --limit 100

9.2 Webhook 連通性測試

你可以使用 curl 模擬 LINE 發送 Webhook 請求,測試 Gateway 是否正常回應:

curl -X POST https://你的域名/webhooks/line \
-H "Content-Type: application/json" \
-H "x-line-signature: test" \
-d '{"events":[]}'

如果 Gateway 正常運行,應該回覆 HTTP 200。如果回覆 403 或 500,請檢查日誌找出錯誤原因。

十、實戰案例:台灣企業 AI 客服部署

以下介紹三個典型的台灣企業 AI 客服部署場景,說明 OpenClaw × LINE 的實際應用方式。

10.1 案例一:電商平台 — 24/7 智慧客服

企業背景:一家中型電商平台,每日透過 LINE 官方帳號收到約 500 則客服訊息,內容涵蓋訂單查詢、退換貨申請、產品諮詢等。原本由 5 位客服人員輪班處理,平均回覆時間 15 分鐘。

部署方案:

成效:

10.2 案例二:醫療診所 — 預約掛號與衛教諮詢

企業背景:一家連鎖牙醫診所擁有 6 間分院,每日透過 LINE 收到大量預約掛號與診後諮詢。護理人員花費大量時間重複回答相同問題。

部署方案:

成效:

10.3 案例三:金融機構 — 內部知識管理助理

企業背景:一家本土銀行的理財部門,內部有大量的法規文件、產品 DM、作業流程 SOP。理專每天花費大量時間查找文件、確認規定。

部署方案:

成效:

十一、安全最佳實踐

將 AI 代理部署在 LINE 上意味著將企業的智慧能力延伸到了公開的通訊渠道。以下是必須嚴格遵守的安全原則:[7]

  1. 最小權限原則:AI 代理的 Skill 權限應限制在業務需求的最小範圍。客服機器人不需要檔案系統存取權限;知識查詢助理不需要執行系統指令的能力
  2. Token 定期輪換:每 90 天重新 Issue Channel Access Token 並更新 OpenClaw 設定。如果懷疑 Token 洩漏,立即在 LINE Developers Console 撤銷並重新產生
  3. Webhook 簽章驗證不可關閉:OpenClaw 預設啟用 LINE Webhook 的簽章驗證,切勿為了開發方便而關閉此功能
  4. 定期檢查配對裝置:使用 openclaw pairing list 查看所有已配對的連線,移除不再使用或不明的配對
  5. 對話內容加密:確保 Gateway 僅接受 HTTPS 連線,並在伺服器端啟用 TLS 1.3
  6. 敏感資訊過濾:設定 AI 代理的輸出過濾規則,防止洩漏信用卡號、身份證字號等個人敏感資訊
  7. 稽核日誌:啟用完整的對話紀錄與操作日誌,以便事後追蹤與合規稽核
# 啟用安全相關的設定
openclaw config set security.webhookSignatureVerification true
openclaw config set security.auditLog true
openclaw config set security.sensitiveDataFilter true
openclaw config set security.tlsMinVersion "1.3"

結語

LINE 是台灣企業接觸客戶的最短路徑,OpenClaw 則是讓 AI 代理真正為企業工作的開源引擎。兩者結合,讓任何規模的企業都能在最短時間內部署專屬的 AI 客服代理——不需要自行開發 Bot 程式碼、不需要維護 NLP 引擎、不需要建立複雜的後端基礎設施。[8]

本文涵蓋了從零開始的完整串接流程:從 LINE Developers Console 建立 Messaging API Channel、將憑證寫入 OpenClaw、配置 Webhook 與 Pairing、設定群組權限,到 Rich Menu、Flex Message、多媒體處理等進階功能,以及企業級部署所需的多帳號管理、流量控制與安全策略。

如果你是第一次接觸 OpenClaw,建議先閱讀《架構解析與實戰部署全指南》完成基礎安裝與概念理解。如果你對其他通訊平台的串接有興趣,可以參閱《Telegram 串接完全指南》《企業整合實戰指南》。對於安全性有更高要求的企業,建議同步閱讀《安全性深度分析》一文。

AI 客服不是未來式,而是現在進行式。現在就開始你的 OpenClaw × LINE 串接之旅吧。