跳转到内容
OpenClaw Docs

LINE

LINE (插件)

Section titled “LINE (插件)”

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

状态：通过插件支持。支持直接消息、群聊、媒体、位置、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. Create a LINE Developers account and open the Console: 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 事件。出于签名完整性安全考虑，上游中间件转换后的 req.body 值将被忽略。

配置

Section titled “配置”

最低配置：

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

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
  • 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 区分大小写。有效的 ID 格式如下：

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

消息行为

Section titled “消息行为”
  • 文本会在 5000 个字符处进行分块。
  • Markdown 格式将被去除；代码块和表格在可能的情况下会被转换为 Flex 卡片。
  • 流式响应会被缓冲；在代理工作期间，LINE 会收到带有加载动画的完整消息块。
  • 媒体下载受 channels.line.mediaMaxMb 限制（默认为 10）。

频道数据（富消息）

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

/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 agents。

出站媒体

Section titled “出站媒体”

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

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

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

故障排除

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

相关

Section titled “相关”