通过 LINE Messaging API 接入 LINE 消息。插件作为 webhook 接收器运行,使用 channel access token + channel secret 认证。支持私信、群聊、媒体、位置、Flex 消息、模板消息和快速回复。

安装

openclaw plugins install @openclaw/line

配置步骤

  1. 在 LINE Developers Console 创建 Messaging API 频道
  2. 复制 Channel access token 和 Channel secret
  3. 启用 Use webhook,设置 webhook URL(需 HTTPS):https://gateway-host/line/webhook
  4. 配置 OpenClaw:
{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "pairing",
    },
  },
}

环境变量(默认账号)

  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET

访问控制

openclaw pairing list line
openclaw pairing approve line <CODE>

策略配置:

  • dmPolicy:pairing | allowlist | open | disabled
  • allowFrom:LINE 用户 ID(格式:U + 32 位十六进制)
  • groupPolicy:allowlist | open | disabled
  • groupAllowFrom:群组白名单

富消息(channelData)

{
  text: "Here you go",
  channelData: {
    line: {
      quickReplies: ["Status", "Help"],
      flexMessage: {
        altText: "Status card",
        contents: { /* Flex payload */ },
      },
      templateMessage: {
        type: "confirm",
        text: "Proceed?",
        confirmLabel: "Yes",
        confirmData: "yes",
        cancelLabel: "No",
        cancelData: "no",
      },
    },
  },
}

消息行为

  • 文本分块:5000 字符
  • Markdown 格式被剥离,代码块和表格转为 Flex 卡片
  • 流式响应被缓冲,LINE 收到完整块并显示加载动画
  • 媒体下载上限:mediaMaxMb(默认 10MB)

多账号

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

相关链接