OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Regional platforms

LINE

LINE 通过 LINE Messaging API 连接到 OpenClaw。该插件在 Gateway 网关上作为 webhook 接收器运行，并使用你的渠道访问令牌和渠道密钥进行 身份验证。

状态：官方插件，需单独安装。支持私信、群聊、媒体、 位置、Flex 消息、模板消息和快速回复。 不支持表情回应和话题串。

安装

配置渠道前，请先安装 LINE：

bash
openclaw plugins install @openclaw/line

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

bash
openclaw plugins install ./path/to/local/line-plugin

设置

  1. 创建 LINE Developers 账户并打开 Console： https://developers.line.biz/console/
  2. 创建（或选择）Provider，并添加 Messaging API 渠道。
  3. 从渠道设置中复制 Channel access token 和 Channel secret。
  4. 在 Messaging API 设置中启用 Use webhook。
  5. 将 webhook URL 设置为你的 Gateway 网关端点（必须使用 HTTPS）：
text
https://gateway-host/line/webhook

Gateway 网关会响应 LINE 的 webhook 验证（GET）。对于已签名的入站事件 （POST），它会先将每个事件写入持久入口队列，然后再返回 200； 智能体处理会异步继续。投递失败时会从 队列重试，包括 Gateway 网关重启后；有害事件在有限次数的重试后会成为失败的队列 记录。如果持久化失败，请求会返回 500，而不会确认一个可能丢失的事件。 从队列到智能体的边界采用至少一次投递：Gateway 网关在活动投递期间关闭或 崩溃时，可能会重放该轮次。消息事件按 LINE 消息 ID 去重；其他事件类型使用 webhookEventId。保留的完成记录 会抑制普通的重复 webhook，但执行外部副作用的处理程序 仍应具备幂等性。 如果需要自定义路径，请设置 channels.line.webhookPath 或 channels.line.accounts.<id>.webhookPath，并相应更新 URL。

安全说明：

  • LINE 签名验证依赖请求体（对原始请求体执行 HMAC），因此 OpenClaw 会在验证前应用严格的请求体大小限制（64 KB）和读取超时。
  • OpenClaw 使用已验证请求的原始字节处理 webhook 事件。为确保签名完整性，会忽略由上游中间件转换的 req.body 值。

配置

最小配置：

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

公开私信配置：

json5
{  channels: {    line: {      enabled: true,      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",      channelSecret: "LINE_CHANNEL_SECRET",      dmPolicy: "open",      allowFrom: ["*"],    },  },}

环境变量（仅限默认账户）：

  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET

令牌/密钥文件：

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

tokenFile 和 secretFile 必须指向常规文件。符号链接会被拒绝。 内联配置值优先于文件；环境变量是默认账户的最后回退选项。

多个账户：

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

访问控制

私信默认采用配对模式。未知发送者会收到配对码，其 消息在获批前将被忽略：

bash
openclaw pairing list lineopenclaw pairing approve line &lt;CODE&gt;

允许列表和策略：

  • channels.line.dmPolicy：pairing | allowlist | open | disabled（默认值为 pairing）
  • channels.line.allowFrom：允许发送私信的 LINE 用户 ID；dmPolicy: "open" 要求设置 ["*"]
  • channels.line.groupPolicy：allowlist | open | disabled（默认值为 allowlist）
  • channels.line.groupAllowFrom：允许在群组中发送消息的 LINE 用户 ID；私信的 allowFrom 条目不会准入群组发送者
  • 按群组覆盖：channels.line.groups.<groupId>.allowFrom（以及 enabled、requireMention、systemPrompt、skills）。使用 groupPolicy: "allowlist" 时，请设置 groupAllowFrom 或按群组设置 allowFrom；即使私信已开放，空的群组允许列表也会阻止群组消息。
  • 可以通过 accessGroup:<name>，从 allowFrom、groupAllowFrom 和按群组设置的 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）。
  • 入站媒体在传递给智能体之前，会保存到 ~/.openclaw/media/inbound/ 下， 与其他渠道插件使用的共享媒体存储保持一致。

渠道数据（富消息）

使用 channelData.line 发送快速回复、位置、Flex 卡片或模板 消息。

json5
{  text: "给你",  channelData: {    line: {      quickReplies: ["状态", "帮助"],      location: {        title: "办公室",        address: "主街 123 号",        latitude: 35.681236,        longitude: 139.767125,      },      flexMessage: {        altText: "状态卡片",        contents: {/* Flex 载荷 */},      },      templateMessage: {        type: "confirm",        text: "是否继续？",        confirmLabel: "是",        confirmData: "yes",        cancelLabel: "否",        cancelData: "no",      },    },  },}

LINE 插件还提供用于 Flex 消息预设的 /card 命令：

text
/card info "欢迎" "感谢加入！"

ACP 支持

LINE 支持 ACP（Agent Communication Protocol）对话绑定：

  • /acp spawn <agent> --bind here 将当前 LINE 聊天绑定到 ACP 会话，而不创建子话题串。
  • 已配置的 ACP 绑定和已激活的对话绑定 ACP 会话，在 LINE 上的工作方式与其他对话渠道相同。

有关详情，请参阅 ACP 智能体。

出站媒体

LINE 插件通过智能体消息工具发送图像、视频和音频：

  • 图像：作为 LINE 图像消息发送；预览图像默认使用媒体 URL。
  • 视频：需要预览图像；将 channelData.line.previewImageUrl 设置为图像 URL。
  • 音频：作为 LINE 音频消息发送；除非设置了 channelData.line.durationMs，否则时长默认为 60 秒。

设置 channelData.line.mediaKind 时，媒体类型取自该值；否则根据 其他 LINE 选项或 URL 文件后缀推断，并以图像作为回退类型。

出站媒体 URL 必须是长度不超过 2000 个字符的公开 HTTPS URL。OpenClaw 在将 URL 交给 LINE 之前会验证目标主机名，并拒绝 local loopback、 链路本地和私有网络目标。

不带 LINE 特定选项的通用媒体发送使用图像路由。

故障排除

  • **Webhook 验证失败：**确保 webhook URL 使用 HTTPS，并且 channelSecret 与 LINE Console 一致。
  • **没有入站事件：**确认 webhook 路径与 channels.line.webhookPath 匹配，并且 LINE 可以访问 Gateway 网关。
  • **媒体下载错误：**如果媒体超过默认 限制，请提高 channels.line.mediaMaxMb。

相关内容

Was this useful?
On this page

On this page