OpenAB MS Teams Bundle

一键部署的 OpenAB Microsoft Teams bot — bot agent 与 Bot Framework gateway 打包在一起，在 Azure 注册 bot、粘贴 messaging endpoint 即可。

前置需求：拥有可注册 Bot Service / App Registrations 的 Azure 账号，以及可 sideload 或发布 Teams app 的 Microsoft 365 tenant。个人 Microsoft 账号（Hotmail / Live）通常无法注册 Azure Bot Service，请使用 Azure AD 工作 / 学校账号。

部署内容

服务	用途	公开
openab	运行 Kiro CLI 的 OAB agent	否
openab-gateway	Teams Bot Framework → WebSocket 桥接	是（自动 HTTPS）

设置步骤

1. 在 Azure 创建 Bot

1. 到 Azure Portal → 创建资源 → 搜 Azure Bot → 创建。
2. Bot handle：填一个唯一名称。Subscription / Resource group 自选。Pricing tier：dev 用 F0（免费）。
3. Microsoft App ID：选 Type → Multi Tenant → Creation type → Create new Microsoft App ID。
4. 点 Review + create → Create。等部署完成。
5. 打开新建的 Azure Bot 资源 → Configuration：
   • Microsoft App ID → 复制 → 粘贴到 Teams App ID
   • Messaging endpoint → 先留空
6. 同 Configuration 页 → 点 Manage Password → 开启 App Registration → Certificates & secrets → New client secret → 复制 Value → 粘贴到 Teams App Secret。

2. （选填）获取 Kiro API Key

如有付费 Kiro 订阅，前往 kiro.dev → Settings → API Keys 创建 key，填入 KIRO_API_KEY。免费方案跳过此步骤。

3. 部署

确认 App ID 与 App Secret 都填好 → 点部署。系统会自动分配公开 HTTPS 域名给 gateway 服务。

4. 设置 Messaging Endpoint

Bot Framework 没有 setEndpoint API——必须在 Azure Portal 手动粘贴 URL。

1. 打开 openab-gateway 服务页面 → 查自动分配的域名。
2. 完整 messaging endpoint：https://<你的_GATEWAY_域名>/webhook/teams
3. 回 Azure Portal → 你的 Azure Bot 资源 → Configuration → Messaging endpoint → 粘贴 → Apply。

openab-gateway 服务 Instructions 区显示已自动填好的完整 endpoint，可直接复制。

5. 通过 Device Flow 认证 Kiro（仅免费方案）

若步骤 2 已填入 KIRO_API_KEY，跳过此步骤。

待 openab 服务启动后，在 Zeabur Dashboard 打开该服务的终端，运行：

runuser -u agent -- kiro-cli login --use-device-flow

6. 把 Bot 加进 Teams

1. Azure Bot 资源 → Channels → Microsoft Teams → 同意条款。
2. 开 Teams Developer Portal → Apps → + New app → 填基本资料 → App features → Bot → 选刚才创建的 bot。
3. 设置 scope（Personal / Team / Group chat），下载或发布 app manifest。Dev 阶段可用：Preview in Teams → 安装到 chat / channel。

7. 测试

打开 Teams → DM bot 或在 app 安装过的 channel @mention。Gateway 收到 activity → 通过 WebSocket 转发给 OAB → OAB 回复通过 Bot Framework reply API 发出。

想换不同的 agent 后端？

本 bundle 默认使用 Kiro。若想用 Claude / Codex / Cursor / Gemini / OpenCode / Hermes / Grok，请改部署对应的 bot template 搭配独立的 OpenAB Gateway。

想用其他通讯平台？

请参考 OpenAB Telegram Bundle / Feishu Bundle / LINE Bundle / WeCom Bundle 或独立的 OpenAB Gateway，支持 Google Chat。

链接

• OpenAB GitHub
• MS Teams 设置指南