OC
OpenClaw 中文解释版

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

简要总结

Synology Chat

这页说明书在教你,怎么让一个叫 OpenClaw 的机器人朋友,和你的 Synology Chat(可以把它想成是家里的一个聊天小房间)一起玩。你需要先给机器人安装一个特别的“插件”,就像给玩具装上新电池。然后,你要在聊天房间里设置两个“小机关”(一个叫“传入”,一个叫“传出”),再把它们连到机器人身上。这样,机器人就能在聊天房间里和你说话,还能帮你送信啦!当你需要让机器人和这个聊天房间做好朋友的时候,就看这一页。

五岁小孩版解释

首先,你需要知道,要让 OpenClaw 机器人和 Synology Chat 聊天室说话,需要一个特别的“插件”。插件就像是一个能让机器人听懂新语言的翻译器,它不是机器人自己就有的,需要你帮忙装上去。

第一步:安装插件 这一步是给机器人装上“Synology Chat 翻译器”。

  1. 你要在电脑上找到这个插件的文件。
  2. 然后,在电脑的命令行(一个可以打字告诉电脑做什么的地方)里,输入这个命令:openclaw plugins install ./extensions/synology-chat。这就像对机器人说:“请安装这个翻译器吧!”

第二步:在 Synology Chat 里设置“小机关” 这一步是在你的聊天房间里,准备两个连接机器人的“小机关”,一个负责听,一个负责说。

  1. 打开你的 Synology Chat,找到“集成”或“设置”的地方。
  2. 创建一个“传入 Webhook”(incoming webhook)。这就像是一个“收信小喇叭”,机器人可以通过它把话送进聊天室。创建好后,把它的地址(URL)记下来。
  3. 再创建一个“传出 Webhook”(outgoing webhook)。这就像是一个“听话小耳朵”,聊天室可以通过它把听到的话告诉机器人。创建时,你会得到一个“秘密令牌”(secret token),也要记好。

第三步:把“小耳朵”连到机器人身上 这一步是告诉聊天室的“听话小耳朵”,应该去哪里找机器人。

  1. 你需要把“传出 Webhook”的地址,设置成你的 OpenClaw 机器人所在的地方。通常地址是 https://你的机器人地址/webhook/synology
  2. 如果你给这个连接路径起了别的名字(channels.synology-chat.webhookPath),就要用你起的名字。

第四步:告诉机器人怎么连接 这一步是打开机器人的设置本子,把刚才记下的信息填进去。

  1. 你需要配置一个叫 channels.synology-chat 的地方。
  2. 在里面,要打开开关(enabled: true),填上“秘密令牌”(token)和“收信小喇叭”的地址(incomingUrl)。
  3. 这里要小心:token 是你的秘密,不能告诉别人哦!
  4. 你还可以设置谁能和机器人说悄悄话(dmPolicyallowedUserIds),以及机器人说话的速度(rateLimitPerMinute)。
  5. 设置好后,记得让机器人重新启动一下,然后你就可以在 Synology Chat 里和机器人发消息试试啦!

其他重要的提醒

  • 安全第一:那个 token 秘密令牌一定要保管好。还有一个设置叫 allowInsecureSsl,最好一直让它保持 false,除非你非常确定你连接的是自己家里一个安全的设备。
  • 谁能和机器人玩:建议你用 dmPolicy: "allowlist" 这个模式,然后在 allowedUserIds 里列出允许的用户 ID。这样只有名单上的好朋友才能和机器人说悄悄话。如果这个名单是空的,机器人会不知道怎么办,所以要么填上名单,要么把模式改成 dmPolicy: "open"(允许所有人)。
  • 机器人怎么找人:当你想让机器人主动给 Synology Chat 里的某人发消息时,你需要用那个人的用户 ID 数字来告诉他。比如命令是:openclaw message send --channel synology-chat --target 123456 --text “你好呀”
  • 多个聊天房间:如果你的机器人想和不止一个 Synology Chat 房间(或者同一个房间用不同身份)说话,你可以在 accounts 下面为每个房间单独设置,就像给每个房间准备一张不同的名片。