LINE (plugin)

LINE 通过 LINE Messaging API 连接到 OpenClaw。这个 Plugin 在 Gateway 上作为 Webhook 接收器运行，使用你的 channel access token 和 channel secret 进行认证。

状态：通过 Plugin 支持。支持私信、群聊、媒体、位置、Flex 消息、模板消息和快速回复。不支持表情回应和话题串。

需要安装 Plugin

安装 LINE Plugin：

openclaw plugins install @openclaw/line

本地安装（从 git 仓库运行时）：

openclaw plugins install ./extensions/line

设置

创建 LINE Developers 账号并打开控制台： https://developers.line.biz/console/
创建（或选择）一个 Provider，然后添加一个 Messaging API Channel。
从 Channel 设置中复制 Channel access token 和 Channel secret。
在 Messaging API 设置中启用 Use webhook。
把 Webhook URL 设置为你的 Gateway 端点（必须是 HTTPS）：

https://gateway-host/line/webhook

Gateway 会响应 LINE 的 Webhook 验证（GET）和入站事件（POST）。如果你需要自定义路径，可以设置 channels.line.webhookPath 或 channels.line.accounts.<id>.webhookPath，然后相应地更新 URL。

配置

最小配置：

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

环境变量（仅默认账号）：

LINE_CHANNEL_ACCESS_TOKEN
LINE_CHANNEL_SECRET

Token/secret 文件：

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

多账号配置：

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

访问控制

私信默认使用 Pairing 模式。未知发送者会收到一个配对码，他们的消息会被忽略，直到被批准。

openclaw pairing list line
openclaw pairing approve line <CODE>

白名单和策略：

channels.line.dmPolicy：pairing | allowlist | open | disabled
channels.line.allowFrom：DM 白名单中的 LINE 用户 ID
channels.line.groupPolicy：allowlist | open | disabled
channels.line.groupAllowFrom：群组白名单中的 LINE 用户 ID
单个群组覆盖：channels.line.groups.<groupId>.allowFrom

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

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

消息行为

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

Channel data（富消息）

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

{
  text: "Here you go",
  channelData: {
    line: {
      quickReplies: ["Status", "Help"],
      location: {
        title: "Office",
        address: "123 Main St",
        latitude: 35.681236,
        longitude: 139.767125,
      },
      flexMessage: {
        altText: "Status card",
        contents: {
          /* Flex payload */
        },
      },
      templateMessage: {
        type: "confirm",
        text: "Proceed?",
        confirmLabel: "Yes",
        confirmData: "yes",
        cancelLabel: "No",
        cancelData: "no",
      },
    },
  },
}

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

/card info "Welcome" "Thanks for joining!"

故障排除

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