LINE

​

LINE (插件)

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

状态：通过插件支持。支持直接消息、群聊、媒体、位置、Flex 消息、模板消息和快速回复。不支持表情回应和消息串。

​

所需插件

安装 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 设置为您的网关端点（需要 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 值将被忽略。

​

配置

最低配置：

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

​

访问控制

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

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 个十六进制字符

​

消息行为

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

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

​

故障排除

• Webhook 验证失败： 请确保 Webhook URL 是 HTTPS，并且 channelSecret 与 LINE 控制台中的匹配。
• 没有接收到入站事件： 请确认 webhook 路径与 channels.line.webhookPath 匹配，并且 LINE 可以访问到网关。
• 媒体下载错误： 如果媒体超出 默认限制，会抛出 channels.line.mediaMaxMb。

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。