# LINE

> LINE Messaging API 插件的设置、配置和使用

- 网址：https://funcoding.ai/agents/openclaw/channels/line/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/channels/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/](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 line
openclaw pairing approve line <CODE>
```

允许列表和策略：

- `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` 中引用静态发送者访问组；请参阅[访问组](https://funcoding.ai/agents/openclaw/channels/access-groups/)。
- 运行时说明：如果完全缺少 `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 智能体](https://funcoding.ai/agents/openclaw/tools/acp-agents/)。

## 出站媒体

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`。

## 相关内容

- [渠道概览](https://funcoding.ai/agents/openclaw/channels/) — 所有受支持的渠道
- [配对](https://funcoding.ai/agents/openclaw/channels/pairing/) — 私信身份验证和配对流程
- [群组](https://funcoding.ai/agents/openclaw/channels/groups/) — 群聊行为和提及限制
- [频道路由](https://funcoding.ai/agents/openclaw/channels/channel-routing/) — 消息的会话路由
- [安全](https://funcoding.ai/agents/openclaw/gateway/security/) — 访问模型和安全加固