LINE（插件）

LINE 通过 LINE Messaging API 连接�?OpenClaw。插件在 gateway 上作�?webhook 接收器运行，并使用您的通道访问令牌 + 通道密钥进行身份验证�?

状态：通过插件支持。支持直接消息、群组聊天、媒体、位置、Flex 消息、模板消息和快速回复。不支持反应和线程�?

所需插件

安装 LINE 插件�?

openclaw plugins install @openclaw/line

本地检出（�?git 仓库运行时）�?

openclaw plugins install ./extensions/line

设置

  1. 创建 LINE 开发者账户并打开控制台： https://developers.line.biz/console/
  2. 创建（或选择）一�?Provider 并添�?Messaging API 通道�?
  3. 从通道设置中复�?Channel access token 和�?
  4. �?Channel secret Messaging API 设置中启�?Use webhook�?
  5. �?webhook URL 设置为您�?gateway 端点（需�?HTTPS）：
https://gateway-host/line/webhook

gateway 响应 LINE �?webhook 验证（GET）和入站事件（POST）�? 如果需要自定义路径，请设置 channels.line.webhookPath �? channels.line.accounts.<id>.webhookPath 并相应更�?URL�?

配置

基本配置

{
  channels: {
    line: {
      enabled: true,
      accounts: {
        main: {
          channelAccessToken: "YOUR_CHANNEL_ACCESS_TOKEN",
          channelSecret: "YOUR_CHANNEL_SECRET",
        },
      },
    },
  },
}

环境变量

export LINE_CHANNEL_ACCESS_TOKEN="YOUR_CHANNEL_ACCESS_TOKEN"
export LINE_CHANNEL_SECRET="YOUR_CHANNEL_SECRET"

多账�?

{
  channels: {
    line: {
      accounts: {
        main: {
          channelAccessToken: "TOKEN1",
          channelSecret: "SECRET1",
        },
        backup: {
          channelAccessToken: "TOKEN2",
          channelSecret: "SECRET2",
          enabled: false,
        },
      },
    },
  },
}

访问控制

直接消息

  • 默认：dmPolicy: "pairing"（未知用户获得配对代码）
  • 批准配对�?
openclaw pairing approve line <CODE>

群组

  • 默认：groupPolicy: "open"
  • 可以设置�?"allowlist" �?"disabled"

支持的消息类�?

接收

  • �?文本
  • �?图片
  • �?视频
  • �?音频
  • �?位置
  • �?Flex 消息
  • �?模板消息

发�?

  • �?文本
  • �?图片
  • �?视频
  • �?音频
  • �?位置
  • �?Flex 消息
  • �?模板消息
  • �?快速回�?

配置参�?

请参�?Gateway 配置 了解完整的配置选项�?

排查

Webhook 未接收消�?

  1. 确认 webhook URL 正确配置
  2. 检�?Gateway 日志�?
openclaw logs --follow | grep line

身份验证错误

  1. 确认 Channel access token 有效
  2. 确认 Channel secret 正确
  3. 检�?Gateway 日志中的详细错误信息