Nextcloud Talk

首先，你的机器人朋友“OpenClaw”想和“Nextcloud Talk”聊天室里的朋友们聊天。但是，这个聊天室比较特别，需要一个额外的“插件”才能连接。你可以把插件想象成一个特别的翻译器，让机器人能听懂聊天室的话。

要开始玩，你需要做几件事：

1. 安装插件：这是第一步，就像给机器人戴上翻译耳机。你有两种方法可以拿到这个插件：

   • 从网上商店安装：在电脑的命令行里输入 openclaw plugins install @openclaw/nextcloud-talk。
   • 如果你是从代码仓库自己搭建的机器人，可以用这个命令：openclaw plugins install ./extensions/nextcloud-talk。

2. 在Nextcloud聊天室里创建机器人：现在，你需要去你的Nextcloud服务器上，为OpenClaw机器人创建一个身份。这就像在游乐场里给机器人办一张会员卡。你需要运行一个命令，命令里要填上机器人的名字、一个只有你和机器人知道的秘密（<shared-secret>），还有一个能让聊天室找到机器人的地址（<webhook-url>）。

3. 在聊天室里启用机器人：办好了会员卡，你还要去你想让机器人加入的那个聊天房间的设置里，把机器人“打开”，这样它才能进去。

4. 告诉机器人怎么去：最后，你需要告诉OpenClaw机器人聊天室在哪里，以及刚才那个秘密是什么。这需要修改机器人的设置文件。你需要找到两个地方填上信息：

   • channels.nextcloud-talk.baseUrl：这里填你的Nextcloud服务器的网址，比如 https://cloud.example.com。
   • channels.nextcloud-talk.botSecret：这里填刚才你创建机器人时用的那个秘密（<shared-secret>）。

5. 重启机器人：做完上面所有设置，记得要重启一下OpenClaw机器人，它才会开始工作哦！

要小心的事情和规则：

• 机器人不能先找人聊天：在私聊里，机器人不能主动去找别人说话。必须等别人先给机器人发消息，机器人才能回复。
• 聊天室要能找到机器人：你给的那个机器人地址（webhook-url），必须能让你的OpenClaw机器人被外面访问到。如果你的机器人在一个“墙”后面（比如代理后面），你可能需要设置 webhookPublicUrl 来告诉它真正的对外地址。
• 不能直接发图片和视频：机器人不能通过聊天室的接口直接发送图片或视频文件，只能发送它们的网址链接。
• 私聊和群聊有时候分不清：聊天室发给机器人的消息，有时候分不清是私聊还是群聊。如果你想准确区分，可以额外设置 apiUser 和 apiPassword 这两个信息。

关于和谁玩（权限控制）：

• 私聊（一对一聊天）：默认情况下，如果有陌生人想私聊机器人，机器人会给他一个“配对码”。你需要用命令 openclaw pairing list nextcloud-talk 看到这个码，然后用 openclaw pairing approve nextcloud-talk <配对码> 来批准，机器人才能和他聊天。
• 群聊（很多人一起聊天）：默认情况下，机器人不会加入任何群聊。你需要像例子那样，在设置文件里明确写出允许机器人加入的“房间令牌”（room-token），它才会进去。如果什么都不写，机器人就不会加任何群。

机器人能做什么？ 它能和人私聊，也能在允许的群里聊天。它能看到并发送“表情反应”（比如点赞）。但是，它不能参与话题的“回复串”（Threads），也不能直接发送图片视频（只能发链接），还不能使用聊天室里的“原生命令”。