消息平台

行

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

Status：可下载插件。支持私信、群聊、媒体、位置、Flex 消息、模板消息和快捷回复。不支持回应和线程。

安装

在配置渠道前安装 LINE：

bash

openclaw plugins install @openclaw/line

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

bash

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

设置

创建 LINE Developers 账号并打开 Console： https://developers.line.biz/console/
创建（或选择）一个 Provider，并添加一个 Messaging API 渠道。
从渠道设置中复制 Channel access token 和 Channel secret。
在 Messaging API 设置中启用 Use webhook。
将 webhook URL 设置为你的 Gateway 网关端点（需要 HTTPS）：

Code

https://gateway-host/line/webhook

Gateway 网关会响应 LINE 的 webhook 验证（GET）和入站事件（POST）。如果你需要自定义路径，请设置 channels.line.webhookPath 或 channels.line.accounts.<id>.webhookPath，并相应更新 URL。

安全注意事项：

LINE 签名验证依赖请求体（对原始请求体执行 HMAC），因此 OpenClaw 会在验证前应用严格的预认证请求体限制和超时。
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
channels.line.allowFrom：允许发送私信的 LINE 用户 ID；dmPolicy: "open" 需要 ["*"]
channels.line.groupPolicy：allowlist | open | disabled
channels.line.groupAllowFrom：允许用于群组的 LINE 用户 ID
按群组覆盖：channels.line.groups.<groupId>.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: "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 插件还随附一个用于 Flex 消息预设的 /card 命令：

Code

/card info "Welcome" "Thanks for joining!"

ACP 支持

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

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

详见 ACP Agents。

出站媒体

LINE 插件支持通过智能体消息工具发送图片、视频和音频文件。媒体会通过 LINE 专用投递路径发送，并带有适当的预览和跟踪处理：

图片：作为 LINE 图片消息发送，并自动生成预览。
视频：发送时会显式处理预览和内容类型。
音频：作为 LINE 音频消息发送。

出站媒体 URL 必须是公开 HTTPS URL。OpenClaw 会在将 URL 交给 LINE 前验证目标主机名，并拒绝 local loopback、链路本地和私有网络目标。

当 LINE 专用路径不可用时，通用媒体发送会回退到现有的仅图片路由。

故障排除

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

行

安装

设置

配置

访问控制

消息行为

渠道数据（富消息）

ACP 支持

出站媒体

故障排除

相关

Molty