OpenClaw接入Line

LINE 通过 LINE Messaging API 连接到 OpenClaw。该插件作为 webhook 接收器在 Gateway 网关上运行，使用你的 channel access token + channel secret 进行身份验证。 状态：通过插件支持。支持私信、群聊、媒体、位置、Flex 消息、模板消息和快捷回复。不支持表情回应和话题回复。

需要安装插件

安装 LINE 插件：

openclaw plugins install @openclaw/line

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

openclaw plugins install ./extensions/line

配置步骤

1. 创建 LINE Developers 账户并打开控制台：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）：

https://gateway-host/line/webhook

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

配置

最小配置：

{ channels: { line: { enabled: true, channelAccessToken: "LINECHANNELACCESSTOKEN", channelSecret: "LINECHANNEL_SECRET", dmPolicy: "pairing", }, }, }

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

• LINECHANNELACCESS_TOKEN
• LINECHANNELSECRET

Token/secret 文件：

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

多账户配置：

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

访问控制

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

openclaw pairing list line openclaw pairing approve line <CODE

允许列表和策略：

• channels.line.dmPolicy：pairing | allowlist | open | disabled
• channels.line.allowFrom：私信的允许列表 LINE 用户 ID
• channels.line.groupPolicy：allowlist | open | disabled
• channels.line.groupAllowFrom：群组的允许列表 LINE 用户 ID
• 单群组覆盖：channels.line.groups.<groupId.allowFrom

LINE ID 区分大小写。有效 ID 格式如下：

• 用户：U32 位十六进制字符
• 群组：C32 位十六进制字符
• 房间：R32 位十六进制字符

消息行为

• 文本按 5000 字符分块。
• Markdown 格式会被移除；代码块和表格会尽可能转换为 Flex 卡片。
• 流式响应会被缓冲；智能体处理时，LINE 会收到完整分块并显示加载动画。
• 媒体下载受channels.line.mediaMaxMb限制（默认 10）。

渠道数据（富消息）

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

{ 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 插件还提供/card命令用于 Flex 消息预设：

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

故障排除

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