跳转到内容
OpenClaw Docs

LINE

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

状态：可下载插件。支持私信、群聊、媒体、位置、Flex 消息、模板消息和快速回复。不支持反应和会话串。

安装

Section titled “安装”

在配置渠道之前安装 LINE：

Terminal window
openclaw plugins install @openclaw/line

本地检出版本（当从 git 仓库运行时）：

Terminal window
openclaw plugins install ./path/to/local/line-plugin

设置

Section titled “设置”
  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 设置为您的网关端点（需要 HTTPS）：
https://gateway-host/line/webhook

网关会响应 LINE 的 webhook 验证 (GET)，并在验证签名和载荷后立即确认已签名的入站事件 (POST)；代理处理将异步继续。 如果您需要自定义路径，请设置 channels.line.webhookPath 或 channels.line.accounts.<id>.webhookPath 并相应地更新 URL。

安全提示：

  • LINE 签名验证依赖于正文（对原始正文进行 HMAC 运算），因此 OpenClaw 在验证之前应用严格的预认证正文限制和超时。
  • OpenClaw 处理来自已验证原始请求字节的 webhook 事件。出于签名完整性安全考虑，上游中间件转换的 OpenClawreq.body 值将被忽略。

配置

Section titled “配置”

最小配置：

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

公开私信配置：

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "open",
      allowFrom: ["*"],
    },
  },
}

环境变量（仅限默认账户）：

  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_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",
        },
      },
    },
  },
}

访问控制

Section titled “访问控制”

私信默认为配对模式。未知发送者将收到配对码，其消息在被批准前将被忽略。

Terminal window
openclaw pairing list line
openclaw pairing approve line <CODE>

白名单和策略：

  • channels.line.dmPolicy: pairing | allowlist | open | disabled
  • channels.line.allowFrom: 允许使用的 LINE 用户 ID 用于私信；dmPolicy: "open" 需要 ["*"]
  • channels.line.groupPolicy: allowlist | open | disabled
  • channels.line.groupAllowFrom: 允许使用的 LINE 用户 ID 用于群组
  • 每群组覆盖：channels.line.groups.<groupId>.allowFrom
  • 静态发送者访问组可以通过 allowFrom、groupAllowFrom 以及每个组的 allowFrom（配合 accessGroup:<name>）进行引用。
  • 运行时说明：如果完全缺少 channels.line，运行时将回退到 groupPolicy="allowlist" 进行组检查（即使设置了 channels.defaults.groupPolicy）。

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

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

消息行为

Section titled “消息行为”
  • 文本将在 5000 个字符处进行分块。
  • Markdown 格式会被去除；代码块和表格会在可能的情况下转换为 Flex 卡片。
  • 流式响应会被缓冲；在代理（Agent）工作时，LINE 会收到带有加载动画的完整分块。
  • 媒体下载受 channels.line.mediaMaxMb 限制（默认为 10）。
  • 传入媒体在传递给代理之前会保存在 ~/.openclaw/media/inbound/ 下，这与其它内置渠道插件使用的共享媒体存储相匹配。

渠道数据（富消息）

Section titled “渠道数据（富消息）”

使用 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!"

ACP 支持

Section titled “ACP 支持”

LINE 支持 ACP（Agent Communication Protocol）会话绑定：

  • /acp spawn <agent> --bind here 将当前的 LINE 聊天绑定到 ACP 会话，而不创建子线程。
  • 配置的 ACP 绑定和活动的会话绑定 ACP 会话在 LINE 上的工作方式与其他会话渠道类似。

有关详细信息，请参阅 ACP 代理。

出站媒体

Section titled “出站媒体”

LINE 插件支持通过代理消息工具发送图片、视频和音频文件。媒体通过 LINE 专用交付路径发送，并具有适当的预览和跟踪处理：

  • 图片：作为 LINE 图片消息发送，并自动生成预览。
  • 视频：发送时包含明确的预览和内容类型处理。
  • 音频：作为 LINE 音频消息发送。

出站媒体 URL 必须是公共 HTTPS URL。OpenClaw 在将 URL 传递给 LINE 之前会验证目标主机名，并拒绝环回、链路本地和私有网络目标。

当不可用 LINE 特定路径时，通用媒体发送会回退到现有的仅图像路由。

故障排除

Section titled “故障排除”
  • Webhook 验证失败： 确保 webhook URL 是 HTTPS，并且 channelSecret 与 LINE 控制台匹配。
  • 没有入站事件： 确认 webhook 路径匹配 channels.line.webhookPath 并且网关可从 LINE 访问。
  • 媒体下载错误： 如果媒体超过 默认限制，会引发 channels.line.mediaMaxMb。

相关

Section titled “相关”