LINE（插件）

LINE 通过 LINE Messaging API 接入 OpenClaw。插件在 Gateway 上运行一个 Webhook 接收器， 使用你的 Channel Access Token 和 Channel Secret 进行认证。

支持状态：通过插件支持。私信、群聊、媒体、位置、Flex 消息、模板消息和快捷回复均已支持。不支持表情回应和话题串（Thread）。

安装插件

安装 LINE 插件：

openclaw plugins install @openclaw/line

本地代码仓库（从 git 仓库运行时）：

openclaw plugins install ./extensions/line

配置步骤

1. 创建 LINE Developers 账号并打开控制台： https://developers.line.biz/console/
2. 创建（或选择）一个 Provider，并添加一个 Messaging API 渠道。
3. 从渠道设置中复制 Channel access token 和 Channel secret。
4. 在 Messaging API 设置中启用 Use webhook。
5. 将 Webhook URL 设置为你的 Gateway 地址（必须 HTTPS）：

https://gateway-host/line/webhook

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

安全说明：

• LINE 签名验证依赖请求体（对原始体进行 HMAC），OpenClaw 在验证前会严格限制请求体大小并设置超时。
• OpenClaw 使用经过验证的原始请求字节处理 Webhook 事件，上游中间件转换的 req.body 值会被忽略，以确保签名完整性。

配置示例

最小配置：

{
  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",
    },
  },
}

tokenFile 和 secretFile 必须指向普通文件，不接受符号链接。

多账号配置：

{
  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.<groupId>.allowFrom
• 运行时注意：如果 channels.line 完全缺失，运行时会对群组检查回退到 groupPolicy="allowlist"（即使设置了 channels.defaults.groupPolicy）。

LINE ID 区分大小写，有效格式如下：

• 用户：U + 32 位十六进制字符
• 群组：C + 32 位十六进制字符
• 房间：R + 32 位十六进制字符

消息行为

• 文本按 5000 字符分块。
• Markdown 格式会被剥除；代码块和表格在可能的情况下转换为 Flex 卡片。
• 流式响应会被缓冲；LINE 以完整分块接收消息，智能体工作期间显示加载动画。
• 媒体下载上限由 channels.line.mediaMaxMb 控制（默认 10）。

渠道数据（富消息）

使用 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 插件还提供 /card 命令用于 Flex 消息预设：

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

故障排查

• Webhook 验证失败：确认 Webhook URL 是 HTTPS，且 channelSecret 与 LINE 控制台一致。
• 没有收到入站事件：确认 Webhook 路径与 channels.line.webhookPath 一致，且 Gateway 可从 LINE 访问。
• 媒体下载报错：如果媒体超出默认限制，请提高 channels.line.mediaMaxMb。