设置

安装插件，注册机器人和 Teams 应用，将 Teams 指向可访问的端点，并验证结果。

捆绑插件¶

Microsoft Teams 在当前 OpenClaw 版本中作为捆绑插件随附提供；在正常的打包构建中无需单独安装。

在较旧的构建版本或不包含捆绑 Teams 的自定义安装中，请直接安装 npm 包：

openclaw plugins install @openclaw/msteams

使用裸包（bare package）以跟随当前官方发布标签。仅在需要可重现安装时才固定到确切版本。

本地检出（从 git 仓库运行时）：

openclaw plugins install ./path/to/local/msteams-plugin

详情：插件

快速设置¶

@microsoft/teams.cli 通过一条命令完成机器人注册、清单创建和凭据生成。

1. 安装并登录

npm install -g @microsoft/teams.cli@preview
teams login
teams status   # verify you're logged in and see your tenant info

2. 启动隧道（Teams 无法访问 localhost）

如有需要，请安装并认证 devtunnel CLI（入门指南）。

# One-time setup (persistent URL across sessions):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 18789 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot
# Your endpoint: https://<tunnel-id>.devtunnels.ms/api/messages

备选方案：ngrok http 18789 或 tailscale funnel 18789（URL 可能随会话变化）。如果与你配置的 Gateway 端口不同，请使用该端口。配置反向代理时，仅暴露所需的 webhook 路径。

先前的端口 3978 默认仍可通过 Gateway 自有的兼容性监听器访问。在验证消息可以通过 Gateway 端口投递后，设置 channels.msteams.legacyWebhook: false 以关闭旧端口。

3. 创建应用

teams app create \
  --name "OpenClaw" \
  --endpoint "https://<your-tunnel-url>/api/messages"

这会创建一个 Entra ID（Azure AD）应用程序，生成客户端密码，构建并上传 Teams 应用清单（含图标），并注册一个 Teams 托管的机器人（无需 Azure 订阅）。输出内容包括 CLIENT_ID、CLIENT_SECRET、TENANT_ID 以及 Teams App ID；它还会提供直接将应用安装到 Teams 中的选项。

4. 配置 OpenClaw，使用输出中的凭据：

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<CLIENT_ID>",
      appPassword: "<CLIENT_SECRET>",
      tenantId: "<TENANT_ID>",
      webhook: { path: "/api/messages" },
    },
  },
}

或者直接使用环境变量：MSTEAMS_APP_ID、MSTEAMS_APP_PASSWORD、MSTEAMS_TENANT_ID。

5. 在 Teams 中安装应用

teams app create 会提示你安装应用；选择“在 Teams 中安装”。之后如需获取安装链接：

teams app get <teamsAppId> --install-link

6. 验证一切正常

teams app doctor <teamsAppId>

运行诊断，涵盖机器人注册、AAD 应用配置、清单有效性和 SSO 设置。

对于生产环境，请考虑使用联合身份验证（证书或托管身份），而不是客户端密码。

目标¶

• 通过 Teams 私聊、群聊或频道与 OpenClaw 对话。
• 保持路由确定性：回复始终返回到消息到达的频道。
• 默认采用安全的频道行为（除非另行配置，否则需要提及）。

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      appPassword: "<APP_PASSWORD>",
      tenantId: "<TENANT_ID>",
      webhook: { path: "/api/messages" },
    },
  },
}

本地开发（隧道）¶

Teams 无法访问 localhost。请使用持久开发隧道，以便 URL 在多次会话中保持稳定：

# One-time setup:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 18789 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot

替代方案：ngrok http 18789 或 tailscale funnel 18789（URL 可能每次会话都会变化）。如果不同，请使用你配置的网关端口。配置反向代理时，仅暴露所需的 webhook 路径。

如果隧道 URL 发生变化，请更新端点：

teams app update <teamsAppId> --endpoint "https://<new-url>/api/messages"

测试机器人¶

运行诊断：

teams app doctor <teamsAppId>

一次性检查机器人注册、AAD 应用、清单和 SSO 配置。

发送测试消息：

1. 安装 Teams 应用（安装链接来自 teams app get <id> --install-link）。
2. 在 Teams 中找到该机器人并发送一条私信。
3. 检查网关日志中的传入活动。