Microsoft Teams

这页说明书教你如何把 OpenClaw 连接到 Microsoft Teams，让它成为你的聊天机器人。

首先，你需要安装一个叫“插件”的小工具。你可以把它想成是给 OpenClaw 的一个新玩具，让它能和 Teams 说话。安装方法很简单，在电脑的命令行里输入一行命令就可以了。

安装好插件后，最重要的一步是去微软的 Azure 网站创建一个“机器人”。这就像给你的 OpenClaw 在微软那里注册一个身份，拿到身份证（App ID）、密码（App Password）和家庭地址（Tenant ID）。记住这三个东西，后面要用。

接下来，你要告诉 OpenClaw 这些信息。你需要在一个叫 openclaw.json 的配置文件里，写下机器人的身份证、密码和家庭地址。这样 OpenClaw 就知道怎么和 Teams 打招呼了。

为了让 Teams 能找到你的 OpenClaw，你需要一个公开的网址。如果你的电脑只是自己用（本地开发），可以用 ngrok 或 Tailscale Funnel 这样的工具生成一个临时网址，就像给你的电脑开一扇临时的窗户。

然后，你需要为 Teams 制作一个“应用程序包”。这就像做一个安装包，里面告诉 Teams：“嘿，这里有一个机器人，请安装它！”这个包需要包含一个清单文件（manifest.json）和两张小图片。清单文件里要写上机器人的身份证，并说清楚它可以在私聊、群聊和频道里工作。

最后，在 Teams 里上传这个安装包，安装好，就可以开始和你的 OpenClaw 机器人聊天啦！

重要的事情和要小心的地方：

1. 关于聊天权限：默认情况下，OpenClaw 只会在你私聊它时回复。如果你想在群聊或频道里@它，需要在配置文件里特别允许。可以设置一个允许名单，只让指定的人或群聊能叫它。
2. 关于发送文件：在私聊里，机器人可以轻松发文件给你。但在群聊或频道里发文件，就需要更复杂的设置，包括一个 SharePoint 网站的 ID 和额外的权限。
3. 关于图片和附件：在私聊里，机器人可以收到你发的图片和文件。但在群聊或频道里，它默认“看”不到图片和文件的内容，需要你额外开启微软 Graph API 的权限才行。
4. 关于回复样式：Teams 有两种聊天样式（像帖子的“Posts”和像串聊的“Threads”）。你需要根据频道的样式，在配置里告诉机器人用哪种方式回复，不然回复可能会出现在奇怪的位置。
5. 更新应用程序：如果你改了机器人的设置（比如增加了新权限），必须提高清单文件里的版本号，重新打包，并在 Teams 里重新上传安装。安装后，一定要完全退出 Teams 软件再重新打开，这样新设置才会生效。

记住，在 Teams 的网址里找团队（Team）和频道（Channel）的 ID 时，要看网址中间的那串代码，不要看网址最后面 groupId= 后面的东西，那是错的。