Skip to Content
👋 欢迎来到 HowToUseMoltbot 快速入门
频道Line

LINE（插件）

LINE 通过 LINE Messaging API 连接 Moltbot。插件在网关上作为 webhook 接收端运行，使用频道访问 token 和频道密钥进行认证。状态：通过插件支持。支持私聊、群聊、媒体、位置、Flex 消息、模板消息和快捷回复。不支持表态和主题回复。

需安装插件

安装 LINE 插件：

moltbot plugins install @moltbot/line

本地检出（在 git 仓库中运行时）：

moltbot 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。

配置

最小配置：

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

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

  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET

Token/密钥文件：

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

多账号：

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

访问控制

私聊默认使用配对。未知发件人收到配对码，在批准前消息被忽略。

moltbot pairing list line
moltbot 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

LINE ID 区分大小写。合法 ID 形如：

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

消息行为

  • 文本按 5000 字符分块。
  • Markdown 格式会被剥离；代码块和表格在可能时转为 Flex 卡片。
  • 流式回复会缓冲；LINE 在 agent 工作时以加载动画接收完整分块。
  • 媒体下载受 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 一致，且 LINE 能访问网关。
  • 媒体下载错误：若媒体超过默认限制，可提高 channels.line.mediaMaxMb。
最后更新于:
iMessageLocation 位置