OpenClaw从入门到应用——频道:Line

张开发
2026/4/7 21:52:12 15 分钟阅读

分享文章

OpenClaw从入门到应用——频道:Line
通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》需要插件安装 LINE 插件openclaw pluginsinstallopenclaw/line本地检出从 git 仓库运行时openclaw pluginsinstall./extensions/line设置创建 LINE Developers 账号并打开控制台https://developers.line.biz/console/创建或选择一个 Provider并添加Messaging API频道。从频道设置中复制Channel access token和Channel secret。在 Messaging API 设置中启用Use webhook。设置 webhook URL 为你的网关端点需要 HTTPShttps://gateway-host/line/webhook网关响应 LINE 的 webhook 验证GET和入站事件POST。如果你需要自定义路径请设置channels.line.webhookPath或channels.line.accounts..webhookPath并相应更新 URL。安全说明LINE 签名验证依赖于请求体基于原始请求体的 HMAC因此 OpenClaw 在验证前会严格执行请求体大小限制和超时限制。配置最小配置{ channels: { line: { enabled: true, channelAccessToken: LINE_CHANNEL_ACCESS_TOKEN, channelSecret: LINE_CHANNEL_SECRET, dmPolicy: pairing, }, }, }环境变量仅默认账号LINE_CHANNEL_ACCESS_TOKENLINE_CHANNEL_SECRET令牌/密钥文件{ channels: { line: { tokenFile: /path/to/line-token.txt, secretFile: /path/to/line-secret.txt, }, }, }tokenFile和secretFile必须指向普通文件拒绝符号链接。多账号{ channels: { line: { accounts: { marketing: { channelAccessToken: ..., channelSecret: ..., webhookPath: /line/marketing, }, }, }, }, }访问控制私聊默认采用配对模式。未知发送者会收到配对码在获得批准前其消息将被忽略。openclaw pairing list line openclaw pairing approve line用户ID白名单与策略channels.line.dmPolicypairing | allowlist | open | disabledchannels.line.allowFrom允许私聊的 LINE 用户 ID 列表channels.line.groupPolicyallowlist | open | disabledchannels.line.groupAllowFrom允许群聊的 LINE 用户 ID 列表群组级覆盖channels.line.groups.群组ID.allowFrom运行时注意如果channels.line完全缺失运行时对群组检查会回退到groupPolicyallowlist即使设置了channels.defaults.groupPolicy。LINE ID 区分大小写。有效 ID 格式用户U 32 个十六进制字符群组C 32 个十六进制字符房间R 32 个十六进制字符消息行为文本按 5000 字符分块。Markdown 格式会被去除代码块和表格在可能的情况下会转换为 Flex 卡片。流式响应会缓冲LINE 在代理工作时会收到完整的数据块并显示加载动画。媒体下载大小受channels.line.mediaMaxMb限制默认 10 MB。频道数据富消息使用channelData.line发送快捷回复、位置、Flex 卡片或模板消息。{ text: Here you go, channelData: { line: { quickReplies: [Status, Help], location: { title: Office, address: 123 Main St, latitude: 35.681236, longitude: 139.767125, }, flexMessage: { altText: Status card, contents: { /* Flex payload */ }, }, templateMessage: { type: confirm, text: Proceed?, confirmLabel: Yes, confirmData: yes, cancelLabel: No, cancelData: no, }, }, }, }LINE 插件还提供了一个/card命令用于 Flex 消息预设/card info Welcome Thanks for joining!故障排除Webhook 验证失败确保 webhook URL 为 HTTPS且channelSecret与 LINE 控制台中的一致。没有入站事件确认 webhook 路径与channels.line.webhookPath匹配并且网关能够从 LINE 访问。媒体下载错误如果媒体超过默认限制请增大channels.line.mediaMaxMb。

更多文章