LINE（插件）

适用范围

LINE 渠道目前通过插件接入：网关（Gateway）作为 Webhook 接收端，使用你的 Channel Access Token + Channel Secret 与 LINE 通信。

这里给出“最小可用 + 可验证”的落地路径；更细的 LINE 富消息（Flex/模板等）后续再展开。

前置条件

• 已在 LINE Developers Console 创建 Messaging API Channel
• 已拿到：
  • Channel access token
  • Channel secret
• 你的网关有一个可被 LINE 访问到的 HTTPS 地址（Webhook 必须是 HTTPS）

安装插件

moltbot plugins install @moltbot/line

从源码仓库运行（本地 checkout）：

moltbot plugins install ./extensions/line

配置 Webhook

在 LINE Developers Console：

1. 打开 Messaging API 设置，启用 “Use webhook”
2. 设置 Webhook URL：

https://<your-gateway-host>/line/webhook

如果你改了路径（例如 channels.line.webhookPath 或多账号的 channels.line.accounts.<id>.webhookPath），Webhook URL 也要同步更新。

最小配置（示例）

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

默认账号也可用环境变量：

• LINE_CHANNEL_ACCESS_TOKEN
• LINE_CHANNEL_SECRET

安全建议：DM 默认配对

默认使用 pairing 更安全：陌生人会收到配对码，只有你批准后才会继续处理消息。

moltbot pairing list line
moltbot pairing approve line <CODE>

常见排障

• Webhook 校验失败：确认 Webhook URL 是 HTTPS，且 channelSecret 与控制台一致
• 收不到消息：确认网关对外可达、路径与 channels.line.webhookPath 一致