LINE - 亚太即时通讯接入

LINE 是亚太地区（日本、台湾、泰国等）最主流的即时通讯平台之一。通过 LINE Messaging API（消息接口），可以将 OpenClaw 接入 LINE Official Account（官方账号），实现自动化客服和交互。

前置要求

• 一个 LINE 账号
• LINE Official Account（可在 LINE Official Account Manager 中创建）
• OpenClaw Gateway（网关）已安装并运行

安装插件

openclaw plugins install @openclaw/line

验证安装：

openclaw plugins list

接入步骤

第一步：创建 LINE Channel

1. 登录 LINE Developers Console
2. 创建一个新的 Provider（提供者），或选择已有 Provider
3. 在 Provider 下创建一个 Messaging API Channel
4. 记录以下凭据：
   • Channel ID（频道 ID）
   • Channel Secret（频道密钥）
   • Channel Access Token（频道访问令牌）— 在 Messaging API 标签页中点击 Issue 生成

安全提示

Channel Access Token 和 Channel Secret 是访问你 LINE 频道的唯一凭证，请妥善保管，不要泄露到公开仓库或日志中。

第二步：配置 Webhook

1. 在 LINE Developers Console 的 Messaging API 标签页中找到 Webhook settings
2. 将 Webhook URL 设置为：

https://your-gateway/line/webhook

3. 点击 Verify 验证连接
4. 启用 Use webhook 开关

Webhook 要求

必须使用 HTTPS 协议，服务器需有公网可访问的域名。LINE 不支持 HTTP 或 localhost。

第三步：配置 OpenClaw

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "YOUR_CHANNEL_ACCESS_TOKEN",
      channelSecret: "YOUR_CHANNEL_SECRET",
      dmPolicy: "pairing"       // DM Policy（私信策略）
    }
  }
}

也可以通过 Environment Variable（环境变量）设置：

export LINE_CHANNEL_ACCESS_TOKEN="your-access-token"
export LINE_CHANNEL_SECRET="your-channel-secret"

第四步：重启 Gateway 并配对

openclaw gateway restart

在 LINE 中向官方账号发送消息，获取 Pairing Code（配对码）后批准：

openclaw pairing approve line <pairing-code>

Webhook 验证

OpenClaw 会自动使用 Channel Secret 验证来自 LINE 的 Webhook 请求签名。确保配置中的 channelSecret 与 LINE Developers Console 中一致。

{
  channels: {
    line: {
      verifySignature: true    // 默认开启，强烈建议保持
    }
  }
}

Rich Messages（富消息）

LINE 支持多种消息类型，OpenClaw 会自动选择最合适的格式：

消息类型	说明
Text（文本）	纯文本消息
Image（图片）	图片消息，需提供 URL
Sticker（贴图）	LINE 贴图
Template（模板）	按钮、确认、轮播等模板
Flex Message	高度自定义的卡片消息

Flex Messages

Flex Message（弹性消息）是 LINE 特有的高级消息格式，支持复杂排版：

{
  channels: {
    line: {
      flexMessages: {
        enabled: true,
        defaultStyle: "bubble"    // bubble（气泡）或 carousel（轮播）
      }
    }
  }
}

Flex Message 设计工具

使用 LINE Flex Message Simulator 可视化设计消息布局。

群组 / 聊天室支持

LINE Bot 可以被添加到群组（Group）或聊天室（Room）中：

{
  channels: {
    line: {
      groups: {
        allowAll: false,
        allowGroups: ["C_GROUP_ID"],   // 允许的群组 ID
        requireMention: true            // 群组中需 @机器人
      }
    }
  }
}

群组 ID

群组 ID 以 C 开头，当 Bot 被邀请加入群组时会在 Gateway 日志中显示。

DM Policy（私信策略）

策略	说明
pairing	用户需先获取 Pairing Code（配对码）验证
allowlist	仅允许指定用户私聊
open	所有人均可私聊（谨慎使用）

常见问题

Webhook 验证失败

1. 确认 channelSecret 与 LINE Developers Console 中完全一致
2. 确认服务器时钟同步（NTP）
3. 检查 Gateway 日志：openclaw logs --channel line

Bot 已收到消息但不回复

1. 确认 Channel Access Token 有效且未过期
2. 在 LINE Official Account Manager 中关闭 Auto-reply messages（自动回复）
3. 确认 Messaging API 模式而非 Chat 模式

Reply Token 过期

LINE 的 Reply Token（回复令牌）仅在 30 秒内有效。如果 Bot 响应时间超过 30 秒，将使用 Push Message API（推送消息接口）替代。

🇨🇳 中国用户须知

LINE 在日本、台湾、泰国等亚太地区非常流行，但在中国大陆几乎无用户基础且无法直接访问。

不推荐在中国大陆使用：LINE 服务器在中国大陆不可访问，Gateway 部署在国内需要代理。

适用场景：面向日本、台湾或东南亚用户的跨境业务客服，建议将 Gateway 部署在对应区域的云服务器上。

替代方案：国内通讯场景建议使用企业微信、钉钉或飞书，东南亚（越南）可考虑 Zalo。