LINE 是东亚和东南亚地区最流行的即时通讯应用之一，在日本、泰国、台湾拥有庞大用户群。通过 OpenClaw 的 LINE 插件，你可以将 AI Agent 接入 LINE，实现私聊和群组的 AI 对话服务。
支持功能
- ✅ 私信（Direct Messages）
- ✅ 群组聊天
- ✅ 媒体消息（图片、视频等）
- ✅ 位置消息
- ✅ Flex 消息（富文本卡片）
- ✅ 模板消息
- ✅ 快速回复按钮
- ❌ 消息反应（不支持）
- ❌ 消息线程（不支持）
第一步：安装 LINE 插件
bash
openclaw plugins install @openclaw/line本地开发环境（从 git 仓库运行）：
bash
openclaw plugins install ./extensions/line第二步：创建 LINE Messaging API 频道
- 访问 LINE Developers Console
- 创建或选择一个 Provider
- 新建 Messaging API 类型的频道
- 在频道设置中获取：
- Channel Access Token（频道访问令牌）
- Channel Secret（频道密钥）
- 在 Messaging API 设置中启用 Webhook
- 将 Webhook URL 设置为你的 Gateway 端点（必须是 HTTPS）：
https://你的gateway地址/line/webhook
Gateway 会自动响应 LINE 的 Webhook 验证请求（GET）和入站事件（POST）。
第三步：配置 OpenClaw
最简配置
json
{
"channels": {
"line": {
"enabled": true,
"channelAccessToken": "你的LINE_CHANNEL_ACCESS_TOKEN",
"channelSecret": "你的LINE_CHANNEL_SECRET",
"dmPolicy": "pairing"
}
}
}使用环境变量（推荐）
bash
export LINE_CHANNEL_ACCESS_TOKEN="your_token"
export LINE_CHANNEL_SECRET="your_secret"使用密钥文件
json
{
"channels": {
"line": {
"tokenFile": "/path/to/line-token.txt",
"secretFile": "/path/to/line-secret.txt"
}
}
}多账号配置
如需同时管理多个 LINE Bot（如面向不同地区或业务线）：
json
{
"channels": {
"line": {
"accounts": {
"marketing": {
"channelAccessToken": "...",
"channelSecret": "...",
"webhookPath": "/line/marketing"
},
"support": {
"channelAccessToken": "...",
"channelSecret": "...",
"webhookPath": "/line/support"
}
}
}
}
}每个账号有独立的 Webhook 路径，分别在 LINE Developers Console 中配置对应 URL。
访问控制
默认情况下，私信采用配对（Pairing）策略：未知用户发来消息后会收到配对码，需审批后才能与 Agent 正常对话。
开放访问（无需配对）
json
{
"channels": {
"line": {
"dmPolicy": "open"
}
}
}白名单限制
json
{
"channels": {
"line": {
"dmPolicy": "allowlist",
"allowFrom": ["Ue12345678abcdef"]
}
}
}allowFrom 中填写 LINE User ID（以 U 开头的字符串）。
群组配置
json
{
"channels": {
"line": {
"groups": {
"*": {
"requireMention": true
}
}
}
}
}设置 requireMention: true 后，Bot 只在被 @提及 时响应，避免在群组中过度介入。
自定义 Webhook 路径
如果需要自定义路径（比如放在反向代理后面）：
json
{
"channels": {
"line": {
"webhookPath": "/custom/line/path"
}
}
}同步更新 LINE Developers Console 中的 Webhook URL。
常见问题
Webhook 验证失败？ Gateway 必须可以通过 HTTPS 公网访问。本地开发可以使用 ngrok 或 Cloudflare Tunnel 做临时 HTTPS 隧道。
收不到群组消息？ 确认 Bot 已被邀请加入群组，且 LINE 频道设置中已开启「加入群组和多人聊天」权限。
Channel Access Token 过期？ LINE 提供长期和短期令牌，建议使用长期令牌（Long-lived token）避免频繁刷新。
原文：LINE - OpenClaw | 来源：OpenClaw 官方文档