简要总结
LINE
这页说明书是教你如何让你的机器人朋友“OpenClaw”和“LINE”聊天软件做好朋友。就像给两个小朋友介绍认识一样,我们需要先安装一个叫“LINE插件”的小工具,然后去LINE的“开发者后台”拿两把钥匙(令牌和密钥),最后告诉LINE机器人住在哪里(设置网址)。这样,当有人在LINE上发消息,机器人就能收到并回复啦!
这页适合你想让机器人在LINE上和大家聊天的时候看,它会一步步教你做好所有准备。
五岁小孩版解释
第一步:安装小工具(插件)
要让OpenClaw和LINE说话,首先得安装一个叫“LINE插件”的小工具。这就像给你的机器人装上一个能听懂LINE语言的耳朵和嘴巴。
- 要做什么:安装插件。
怎么做:在你的电脑上,打开一个叫“终端”或“命令行”的窗口,输入下面这行命令,然后按回车键。
openclaw plugins install @openclaw/line
第二步:去LINE那里拿钥匙和门牌号
现在,我们要去LINE的“开发者后台”申请,告诉LINE我们要让一个机器人来帮忙。这就像去管理处登记一个新朋友。
- 要做什么:去LINE开发者网站创建一个“Messaging API频道”。
怎么做:打开浏览器,访问
https://developers.line.biz/console/,登录后创建一个“提供商”,然后在里面添加一个“Messaging API”类型的频道。 - 要做什么:找到两把重要的“钥匙”。 怎么做:在新建的频道设置里,找到“Channel access token”(频道访问令牌)和“Channel secret”(频道密钥),把它们先抄下来。它们就像机器人的用户名和密码,非常重要!
- 要做什么:打开“使用Webhook”的开关,并告诉LINE机器人住在哪。
怎么做:在频道的“Messaging API”设置里,找到“Use webhook”并打开它。然后在“Webhook URL”里填上你的机器人地址:
https://你的网关地址/line/webhook。要小心:这个地址必须是https开头的,不能是http。
第三步:告诉机器人钥匙放在哪
我们已经拿到了钥匙,现在要告诉机器人钥匙是什么,这样它才能用钥匙打开LINE的门。
- 要做什么:修改机器人的配置文件。
怎么做:你需要打开一个叫
config的文件,在里面找到channels部分,添加下面这样的内容。记得把LINE_CHANNEL_ACCESS_TOKEN和LINE_CHANNEL_SECRET换成你刚才抄下来的那两把真正的钥匙。
小提示:你也可以通过设置名叫channels: { line: { enabled: true, channelAccessToken: "你的真实令牌", channelSecret: "你的真实密钥", }, }LINE_CHANNEL_ACCESS_TOKEN和LINE_CHANNEL_SECRET的环境变量来告诉机器人钥匙,这样更安全。
第四步:决定谁能和机器人聊天
不是所有人都能随便和你的机器人聊天。我们可以定一些规矩。
- 直接聊天(私聊):默认是“配对”模式。就像一个不认识的小朋友想和你玩,他需要先告诉你一个暗号(配对码),你同意了才能一起玩。你可以用命令
openclaw pairing list line查看谁在申请,用openclaw pairing approve line <暗号>来同意。 - 群聊:可以设置成“白名单”(只允许名单里的人)、“开放”(所有人都可以)或者“关闭”(不允许)。
- 要记住:LINE的用户ID、群ID是区分大小写的,长得像这样:
U或C或R后面跟着32个字母数字。
第五步:机器人怎么说话和发东西
机器人说话和发东西也有一些小规则。
- 机器人一次说话不能太长,超过5000个字会被分成几段。
- 它发的图片、视频等文件不能太大,默认不能超过10MB。如果不够,可以修改
channels.line.mediaMaxMb这个设置让它变大。 - 机器人除了发文字,还能发一些很酷的“富消息”,比如快速回复按钮、地图位置、漂亮的卡片。这需要在发消息时,额外加一个叫
channelData.line的小包裹,里面装上这些特殊内容。
如果遇到问题怎么办?
- LINE总说验证失败:检查你的Webhook网址是不是
https开头,并且channelSecret(密钥)有没有填对。 - 收不到任何消息:检查
channels.line.webhookPath设置的路径,和你在LINE后台填的网址最后一部分是不是一样,并确保LINE能访问到你的机器人。 - 图片或视频下载失败:可能是文件太大了,试试把
channels.line.mediaMaxMb这个值调大一点。