前言
LINE 在日本、东南亚等地区拥有庞大的用户群体。OpenClaw 通过官方插件 @openclaw/line 支持与 LINE Messaging API 的对接，让你的 AI 助手可以通过 LINE 提供服务。
前置要求
- 已安装并运行 OpenClaw
- LINE 账号
- LINE Developers 控制台访问权限
- 一个具备 HTTPS 的公网地址（用于 Webhook）
安装 LINE 插件
openclaw plugins install @openclaw/line
验证安装：
openclaw plugins list
# 确认 @openclaw/line 已列出
创建 LINE Messaging API 频道
1. 访问 LINE Developers 控制台
登录 LINE Developers，创建或选择一个 Provider。
2. 创建 Messaging API 频道
点击 Create a new channel → 选择 Messaging API：
- 填写频道名称、描述、分类等信息
- 选择所在地区
- 同意服务条款后创建
3. 获取 Channel Access Token
在频道设置的 Messaging API 页面底部，点击 Issue 生成 Channel Access Token（长期有效）。
4. 获取 Channel Secret
在 Basic settings 页面中找到 Channel Secret 并复制。
# 记录这两个值
Channel Access Token: xxxxxxxxxxxxxxxxxxxxxxxx...
Channel Secret: xxxxxxxxxxxxxxxxxxxxxxxx
配置 Webhook
LINE 通过 Webhook 推送消息事件，必须使用 HTTPS 地址。
设置 Webhook URL
在 LINE Developers 控制台的 Messaging API 页面：
- 启用 Use webhook
- 填入 Webhook URL：
https://your-domain.com/line/webhook - 点击 Verify 确认连接正常
HTTPS 方案选择
如果没有公网 HTTPS 地址，可以选择以下方案：
# 方案一：使用 Cloudflare Tunnel
cloudflared tunnel --url http://localhost:3000
# 方案二：使用 Caddy 反向代理
caddy reverse-proxy --from your-domain.com --to localhost:3000
# 方案三：使用 ngrok（开发测试用）
ngrok http 3000
OpenClaw 频道配置
channels:
- type: line
channelAccessToken: "你的Channel Access Token"
channelSecret: "你的Channel Secret"
dmPolicy: "open"
allowlist: []
私聊策略
dmPolicy: "open" # 接受所有用户消息（公开机器人）
dmPolicy: "paired" # 需要配对审批
dmPolicy: "off" # 关闭私聊
用户白名单
当需要限制可访问用户时，使用 allowlist 配置用户 ID：
allowlist:
- "Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
- "Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
用户 ID 可以在 Webhook 事件的 source.userId 字段中获取。
消息特性
文本消息
LINE 单条文本消息最大长度为 5000 字符，在大多数场景下足够使用。
媒体消息
支持图片、视频、音频等媒体文件，单个文件大小限制为 10MB。
快速回复（Quick Reply）
LINE 支持在消息底部显示快捷按钮，方便用户快速选择：
# OpenClaw 会根据上下文自动生成快速回复选项
line:
enableQuickReply: true
模板消息（Template Messages）
支持按钮模板、轮播模板等富交互格式，让对话体验更加丰富。
Flex 消息
LINE 的 Flex Message 提供了高度自定义的消息布局能力，可以创建卡片式的消息展示：
{
"type": "flex",
"altText": "AI 回复",
"contents": {
"type": "bubble",
"body": {
"type": "box",
"layout": "vertical",
"contents": [
{
"type": "text",
"text": "OpenClaw 回复内容",
"wrap": true
}
]
}
}
}
关闭自动回复
LINE 官方账号默认启用自动回复消息，需要手动关闭以避免与 OpenClaw 冲突：
- 进入 LINE Official Account Manager
- 选择你的账号
- 进入 设置 → 回应设置
- 关闭自动回应消息和加入好友的欢迎消息（或根据需要自定义）
部署验证
# 启动 OpenClaw
openclaw start
# 检查频道状态
openclaw channels status
在 LINE 中添加机器人为好友，发送一条测试消息，确认 AI 能正常回复。
常见问题
Webhook 验证失败
- 确认 URL 使用 HTTPS 协议
- 确认 OpenClaw 服务正在运行且端口可访问
- 检查防火墙设置是否放行了对应端口
消息发送失败
检查 Channel Access Token 是否有效，确认 LINE 频道处于已发布状态。查看 OpenClaw 日志获取详细错误信息。
用户添加好友后没有反应
确认已关闭 LINE 官方账号的自动回复功能，并检查 dmPolicy 配置是否正确。
回复延迟明显
LINE Webhook 的消息投递存在一定延迟，如果 AI 模型响应也较慢，可以考虑使用更快的模型或优化提示词长度。
总结
LINE 频道对接需要配置 Webhook，因此需要一个具有 HTTPS 的公网地址。LINE 丰富的消息类型（Flex Message、Quick Reply 等）可以提供优秀的交互体验。适合面向日本和东南亚用户提供 AI 服务的场景。