8.12 LINE集成 - OpenClaw中文社区

LINE 通过 LINE Messaging API 连接到 OpenClaw。该插件在网关上作为 Webhook 接收器运行，使用您的频道访问令牌和频道密钥进行身份验证。

概述

状态：通过插件支持

LINE 集成支持私信、群聊、媒体、位置、Flex 消息、模板消息和快速回复。不支持反应和线程。

安装插件

首先需要安装 LINE 插件：

# 从 npm 安装
openclaw plugins install @openclaw/line

# 本地开发（从 git 仓库运行时）
openclaw plugins install ./extensions/line

设置步骤

创建 LINE Developers 账户并打开控制台：https://developers.line.biz/console/
创建（或选择）一个 Provider 并添加 Messaging API 频道
从频道设置中复制 Channel access token 和 Channel secret
在 Messaging API 设置中启用 Use webhook
将 Webhook URL 设置为您的网关端点（需要 HTTPS）：
```
https://gateway-host/line/webhook
```

网关会响应 LINE 的 Webhook 验证（GET）和入站事件（POST）。如果需要自定义路径，请设置 channels.line.webhookPath 或 channels.line.accounts..webhookPath 并相应更新 URL。

配置

最小配置

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

环境变量

仅限默认账户：

LINE_CHANNEL_ACCESS_TOKEN
LINE_CHANNEL_SECRET

令牌/密钥文件

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

多账户配置

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

访问控制

私信策略

私信默认使用配对模式。未知发件人会收到配对码，在批准之前其消息会被忽略。

# 列出配对请求
openclaw pairing list line

# 批准配对
openclaw pairing approve line <code>

允许列表和策略

channels.line.dmPolicy：pairing | allowlist | open | disabled
channels.line.allowFrom：私信允许的 LINE 用户 ID
channels.line.groupPolicy：allowlist | open | disabled
channels.line.groupAllowFrom：群组允许的 LINE 用户 ID
每个群组覆盖：channels.line.groups..allowFrom

LINE ID 格式

LINE ID 区分大小写。有效的 ID 格式：

用户：U + 32 个十六进制字符
群组：C + 32 个十六进制字符
聊天室：R + 32 个十六进制字符

消息行为

文本在 5000 字符处分块
Markdown 格式被去除；代码块和表格在可能的情况下转换为 Flex 卡片
流式响应被缓冲；LINE 在 Agent 工作时接收完整块并显示加载动画
媒体下载受 channels.line.mediaMaxMb 限制（默认 10 MB）

频道数据（富消息）

使用 channelData.line 发送快速回复、位置、Flex 卡片或模板消息：

{
  "text": "给你",
  "channelData": {
    "line": {
      "quickReplies": ["状态", "帮助"],
      "location": {
        "title": "办公室",
        "address": "主街 123 号",
        "latitude": 35.681236,
        "longitude": 139.767125
      },
      "flexMessage": {
        "altText": "状态卡片",
        "contents": { /* Flex 载荷 */ }
      },
      "templateMessage": {
        "type": "confirm",
        "text": "继续吗？",
        "confirmLabel": "是",
        "confirmData": "yes",
        "cancelLabel": "否",
        "cancelData": "no"
      }
    }
  }
}

Flex 卡片命令

LINE 插件还提供 /card 命令用于 Flex 消息预设：

/card info "欢迎" "感谢加入！"

故障排除

Webhook 验证失败：确保 Webhook URL 是 HTTPS，并且 channelSecret 与 LINE 控制台匹配
无入站事件：确认 Webhook 路径与 channels.line.webhookPath 匹配，并且网关可从 LINE 访问
媒体下载错误：如果媒体超过默认限制，提高 channels.line.mediaMaxMb

功能支持

功能	支持状态
私信	✅ 支持
群聊	✅ 支持
媒体文件	✅ 支持
位置共享	✅ 支持
Flex 消息	✅ 支持
模板消息	✅ 支持
快速回复	✅ 支持
反应	❌ 不支持
线程	❌ 不支持

常用命令

# 安装 LINE 插件
openclaw plugins install @openclaw/line

# 检查渠道状态
openclaw channels status

# 列出配对请求
openclaw pairing list line

# 批准配对
openclaw pairing approve line <code>

# 发送 Flex 卡片
/card info "标题" "内容"

# 运行诊断
openclaw doctor

重要提示

Webhook URL 必须使用 HTTPS 协议
确保网关可以从互联网访问
妥善保管您的 Channel access token 和 Channel secret
LINE ID 区分大小写，请确保格式正确

概述