chore(i18n): refresh zh-CN translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
619809ac58
commit
6322366b30
@ -1,25 +1,22 @@
|
||||
---
|
||||
read_when:
|
||||
- 你想将 OpenClaw 连接到 LINE
|
||||
- 你需要设置 LINE 网络钩子和凭证
|
||||
- 你需要 LINE 专属的消息选项
|
||||
summary: LINE Messaging API 插件设置、配置和使用
|
||||
- 你需要设置 LINE webhook 和凭证
|
||||
- 你想要 LINE 专用的消息选项
|
||||
summary: LINE Messaging API 插件设置、配置和用法
|
||||
title: 行
|
||||
x-i18n:
|
||||
generated_at: "2026-05-02T07:01:29Z"
|
||||
generated_at: "2026-05-06T06:46:07Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: 7a42afc437140185415347f66a8c0b8eaf7d623a6cc08aedf274121e89cdc3b7
|
||||
source_hash: ff803e9d08038d028e2863cf4391ac5c065837903052914de4cef3cf4e881737
|
||||
source_path: channels/line.md
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
LINE 通过 LINE Messaging API 连接到 OpenClaw。该插件作为 webhook
|
||||
接收器运行在 Gateway 网关上，并使用你的渠道访问令牌 + 渠道密钥进行
|
||||
身份验证。
|
||||
LINE 通过 LINE Messaging API 连接到 OpenClaw。该插件作为 webhook 接收器在 Gateway 网关上运行，并使用你的 channel access token + channel secret 进行身份验证。
|
||||
|
||||
Status：可下载插件。支持私信、群聊、媒体、位置、Flex
|
||||
消息、模板消息和快速回复。不支持回应和线程。
|
||||
Status：可下载插件。支持私信、群聊、媒体、位置、Flex 消息、模板消息和快速回复。不支持表态和线程。
|
||||
|
||||
## 安装
|
||||
|
||||
@ -54,7 +51,7 @@ Gateway 网关会响应 LINE 的 webhook 验证（GET）和入站事件（POST
|
||||
|
||||
安全注意事项：
|
||||
|
||||
- LINE 签名验证依赖请求体（对原始请求体执行 HMAC），因此 OpenClaw 会在验证前应用严格的请求体大小限制和超时。
|
||||
- LINE 签名验证依赖请求体（对原始请求体进行 HMAC），因此 OpenClaw 会在验证前应用严格的预认证请求体限制和超时。
|
||||
- OpenClaw 会从已验证的原始请求字节处理 webhook 事件。为保证签名完整性安全，会忽略上游中间件转换后的 `req.body` 值。
|
||||
|
||||
## 配置
|
||||
@ -74,6 +71,22 @@ Gateway 网关会响应 LINE 的 webhook 验证（GET）和入站事件（POST
|
||||
}
|
||||
```
|
||||
|
||||
公开私信配置：
|
||||
|
||||
```json5
|
||||
{
|
||||
channels: {
|
||||
line: {
|
||||
enabled: true,
|
||||
channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
|
||||
channelSecret: "LINE_CHANNEL_SECRET",
|
||||
dmPolicy: "open",
|
||||
allowFrom: ["*"],
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
环境变量（仅默认账号）：
|
||||
|
||||
- `LINE_CHANNEL_ACCESS_TOKEN`
|
||||
@ -92,7 +105,7 @@ Gateway 网关会响应 LINE 的 webhook 验证（GET）和入站事件（POST
|
||||
}
|
||||
```
|
||||
|
||||
`tokenFile` 和 `secretFile` 必须指向常规文件。符号链接会被拒绝。
|
||||
`tokenFile` 和 `secretFile` 必须指向普通文件。符号链接会被拒绝。
|
||||
|
||||
多个账号：
|
||||
|
||||
@ -114,8 +127,7 @@ Gateway 网关会响应 LINE 的 webhook 验证（GET）和入站事件（POST
|
||||
|
||||
## 访问控制
|
||||
|
||||
私信默认使用配对。未知发送者会收到配对码，在获批前其
|
||||
消息会被忽略。
|
||||
私信默认使用配对。未知发送者会收到一个配对码，在获批之前其消息会被忽略。
|
||||
|
||||
```bash
|
||||
openclaw pairing list line
|
||||
@ -124,14 +136,14 @@ 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`
|
||||
- 运行时注意事项：如果完全缺少 `channels.line`，运行时会在群组检查中回退到 `groupPolicy="allowlist"`（即使设置了 `channels.defaults.groupPolicy`）。
|
||||
- `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`
|
||||
- 运行时注意事项：如果完全缺少 `channels.line`，运行时会回退到 `groupPolicy="allowlist"` 来执行群组检查（即使设置了 `channels.defaults.groupPolicy`）。
|
||||
|
||||
LINE ID 区分大小写。有效 ID 如下：
|
||||
LINE ID 区分大小写。有效 ID 的形式如下：
|
||||
|
||||
- 用户：`U` + 32 个十六进制字符
|
||||
- 群组：`C` + 32 个十六进制字符
|
||||
@ -140,19 +152,14 @@ LINE ID 区分大小写。有效 ID 如下：
|
||||
## 消息行为
|
||||
|
||||
- 文本会按 5000 个字符分块。
|
||||
- Markdown 格式会被移除；代码块和表格会在可行时转换为 Flex
|
||||
卡片。
|
||||
- 流式响应会被缓冲；当智能体工作时，LINE 会收到带加载
|
||||
动画的完整分块。
|
||||
- Markdown 格式会被移除；代码块和表格会在可行时转换为 Flex 卡片。
|
||||
- 流式响应会被缓冲；智能体工作期间，LINE 会收到带加载动画的完整分块。
|
||||
- 媒体下载受 `channels.line.mediaMaxMb` 限制（默认 10）。
|
||||
- 入站媒体会先保存到 `~/.openclaw/media/inbound/`，再传递
|
||||
给智能体，这与其他内置渠道
|
||||
插件使用的共享媒体存储一致。
|
||||
- 入站媒体会先保存到 `~/.openclaw/media/inbound/`，再传递给智能体，与其他内置渠道插件使用的共享媒体存储一致。
|
||||
|
||||
## 渠道数据（富消息）
|
||||
|
||||
使用 `channelData.line` 发送快速回复、位置、Flex 卡片或模板
|
||||
消息。
|
||||
使用 `channelData.line` 发送快速回复、位置、Flex 卡片或模板消息。
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -185,7 +192,7 @@ LINE ID 区分大小写。有效 ID 如下：
|
||||
}
|
||||
```
|
||||
|
||||
LINE 插件还附带一个用于 Flex 消息预设的 `/card` 命令：
|
||||
LINE 插件还提供一个用于 Flex 消息预设的 `/card` 命令：
|
||||
|
||||
```
|
||||
/card info "Welcome" "Thanks for joining!"
|
||||
@ -195,29 +202,27 @@ LINE 插件还附带一个用于 Flex 消息预设的 `/card` 命令：
|
||||
|
||||
LINE 支持 ACP（Agent Communication Protocol）对话绑定：
|
||||
|
||||
- `/acp spawn <agent> --bind here` 会将当前 LINE 聊天绑定到 ACP 会话，而不创建子线程。
|
||||
- `/acp spawn <agent> --bind here` 将当前 LINE 聊天绑定到一个 ACP 会话，而不创建子线程。
|
||||
- 已配置的 ACP 绑定和活跃的对话绑定 ACP 会话在 LINE 上的工作方式与其他对话渠道相同。
|
||||
|
||||
详情请参阅 [ACP agents](/zh-CN/tools/acp-agents)。
|
||||
详情请参阅 [ACP 智能体](/zh-CN/tools/acp-agents)。
|
||||
|
||||
## 出站媒体
|
||||
|
||||
LINE 插件支持通过智能体消息工具发送图片、视频和音频文件。媒体会通过 LINE 专用投递路径发送，并带有合适的预览和跟踪处理：
|
||||
LINE 插件支持通过智能体消息工具发送图片、视频和音频文件。媒体会通过 LINE 专用投递路径发送，并带有适当的预览和跟踪处理：
|
||||
|
||||
- **图片**：作为 LINE 图片消息发送，并自动生成预览。
|
||||
- **视频**：发送时会显式处理预览和内容类型。
|
||||
- **视频**：发送时带有显式的预览和内容类型处理。
|
||||
- **音频**：作为 LINE 音频消息发送。
|
||||
|
||||
出站媒体 URL 必须是公开 HTTPS URL。OpenClaw 会在把 URL 交给 LINE 之前验证目标主机名，并拒绝 local loopback、链路本地和私有网络目标。
|
||||
出站媒体 URL 必须是公开 HTTPS URL。OpenClaw 会在将 URL 交给 LINE 之前验证目标主机名，并拒绝 loopback、link-local 和私有网络目标。
|
||||
|
||||
当 LINE 专用路径不可用时，通用媒体发送会回退到现有的仅图片路由。
|
||||
|
||||
## 故障排除
|
||||
|
||||
- **Webhook 验证失败：** 确保 webhook URL 使用 HTTPS，并且
|
||||
`channelSecret` 与 LINE 控制台匹配。
|
||||
- **没有入站事件：** 确认 webhook 路径与 `channels.line.webhookPath`
|
||||
匹配，并且 LINE 可以访问 Gateway 网关。
|
||||
- **Webhook 验证失败：** 确保 webhook URL 使用 HTTPS，并且 `channelSecret` 与 LINE console 匹配。
|
||||
- **没有入站事件：** 确认 webhook 路径与 `channels.line.webhookPath` 匹配，并且 LINE 能访问 Gateway 网关。
|
||||
- **媒体下载错误：** 如果媒体超过默认限制，请提高 `channels.line.mediaMaxMb`。
|
||||
|
||||
## 相关
|
||||
|
||||
Loading…
Reference in New Issue
Block a user