OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

LINE

这页说明书是教你如何让你的机器人朋友“OpenClaw”和“LINE”聊天软件做好朋友。就像给两个小朋友介绍认识一样,我们需要先安装一个叫“LINE插件”的小工具,然后去LINE的“开发者后台”拿两把钥匙(令牌和密钥),最后告诉LINE机器人住在哪里(设置网址)。这样,当有人在LINE上发消息,机器人就能收到并回复啦!

这页适合你想让机器人在LINE上和大家聊天的时候看,它会一步步教你做好所有准备。

五岁小孩版解释

第一步:安装小工具(插件)

要让OpenClaw和LINE说话,首先得安装一个叫“LINE插件”的小工具。这就像给你的机器人装上一个能听懂LINE语言的耳朵和嘴巴。

  1. 要做什么:安装插件。 怎么做:在你的电脑上,打开一个叫“终端”或“命令行”的窗口,输入下面这行命令,然后按回车键。 openclaw plugins install @openclaw/line

第二步:去LINE那里拿钥匙和门牌号

现在,我们要去LINE的“开发者后台”申请,告诉LINE我们要让一个机器人来帮忙。这就像去管理处登记一个新朋友。

  1. 要做什么:去LINE开发者网站创建一个“Messaging API频道”。 怎么做:打开浏览器,访问 https://developers.line.biz/console/,登录后创建一个“提供商”,然后在里面添加一个“Messaging API”类型的频道。
  2. 要做什么:找到两把重要的“钥匙”。 怎么做:在新建的频道设置里,找到“Channel access token”(频道访问令牌)和“Channel secret”(频道密钥),把它们先抄下来。它们就像机器人的用户名和密码,非常重要!
  3. 要做什么:打开“使用Webhook”的开关,并告诉LINE机器人住在哪。 怎么做:在频道的“Messaging API”设置里,找到“Use webhook”并打开它。然后在“Webhook URL”里填上你的机器人地址:https://你的网关地址/line/webhook要小心:这个地址必须是https开头的,不能是http

第三步:告诉机器人钥匙放在哪

我们已经拿到了钥匙,现在要告诉机器人钥匙是什么,这样它才能用钥匙打开LINE的门。

  1. 要做什么:修改机器人的配置文件。 怎么做:你需要打开一个叫config的文件,在里面找到channels部分,添加下面这样的内容。记得把LINE_CHANNEL_ACCESS_TOKENLINE_CHANNEL_SECRET换成你刚才抄下来的那两把真正的钥匙。
    channels: {
      line: {
        enabled: true,
        channelAccessToken: "你的真实令牌",
        channelSecret: "你的真实密钥",
      },
    }
    
    小提示:你也可以通过设置名叫LINE_CHANNEL_ACCESS_TOKENLINE_CHANNEL_SECRET的环境变量来告诉机器人钥匙,这样更安全。

第四步:决定谁能和机器人聊天

不是所有人都能随便和你的机器人聊天。我们可以定一些规矩。

  • 直接聊天(私聊):默认是“配对”模式。就像一个不认识的小朋友想和你玩,他需要先告诉你一个暗号(配对码),你同意了才能一起玩。你可以用命令 openclaw pairing list line 查看谁在申请,用 openclaw pairing approve line <暗号> 来同意。
  • 群聊:可以设置成“白名单”(只允许名单里的人)、“开放”(所有人都可以)或者“关闭”(不允许)。
  • 要记住:LINE的用户ID、群ID是区分大小写的,长得像这样:UCR后面跟着32个字母数字。

第五步:机器人怎么说话和发东西

机器人说话和发东西也有一些小规则。

  • 机器人一次说话不能太长,超过5000个字会被分成几段。
  • 它发的图片、视频等文件不能太大,默认不能超过10MB。如果不够,可以修改channels.line.mediaMaxMb这个设置让它变大。
  • 机器人除了发文字,还能发一些很酷的“富消息”,比如快速回复按钮、地图位置、漂亮的卡片。这需要在发消息时,额外加一个叫channelData.line的小包裹,里面装上这些特殊内容。

如果遇到问题怎么办?

  • LINE总说验证失败:检查你的Webhook网址是不是https开头,并且channelSecret(密钥)有没有填对。
  • 收不到任何消息:检查channels.line.webhookPath设置的路径,和你在LINE后台填的网址最后一部分是不是一样,并确保LINE能访问到你的机器人。
  • 图片或视频下载失败:可能是文件太大了,试试把channels.line.mediaMaxMb这个值调大一点。