Tích hợp kênh Microsoft Teams (add-teams)
Skill tự động hoá toàn bộ quá trình kết nối bot NanoClaw với kênh, nhóm chat và tin nhắn riêng trên Microsoft Teams.
Skill này làm gì
Thêm adapter Microsoft Teams vào dự án NanoClaw: sao chép mã adapter cùng test đăng ký từ nhánh channels, thêm dòng import tự đăng ký vào barrel kênh, cài gói @chat-adapter/teams ghim đúng phiên bản, rồi build và chạy test tích hợp.
Phần credential dùng Microsoft Teams CLI (cài global bằng npm): đăng nhập Microsoft 365 → đăng ký ứng dụng Entra → tạo client secret → đăng ký bot do Teams quản lý → tải gói ứng dụng lên Developer Portal → trả về link cài đặt. Không cần Azure subscription. Các giá trị được ghi vào .env theo nguyên tắc không ghi đè, sau đó skill chủ động tạo cuộc trò chuyện 1:1 giữa bot và chủ sở hữu để trợ lý nhắn tin trước.
Mọi bước đều idempotent nên chạy lại an toàn; tài liệu còn kèm lộ trình thủ công qua Azure Portal cho tenant bị chặn Developer Portal và phần xử lý sự cố rất chi tiết.
Phù hợp với ai
- Người tự host NanoClaw và muốn dùng trợ lý AI ngay trong Microsoft Teams của công ty
- Ai muốn né 7 bước thao tác tay trên Azure Portal, chỉ cần một lệnh CLI
- Người có tenant Microsoft 365 Business/EDU/developer và có thể mở URL HTTPS công khai (Cloudflare Tunnel, VPS reverse proxy)
Tài khoản Teams cá nhân miễn phí không hỗ trợ sideload ứng dụng tuỳ chỉnh nên không dùng được.
Ví dụ sử dụng
- Trợ lý cho kênh nhóm: cài bot vào kênh của team, @mention để hỏi và nhận trả lời theo thread; thêm quyền RSC để bot đọc mọi tin nhắn mà không cần mention.
- Trợ lý cá nhân qua DM: ngay sau khi cài, bot chủ động nhắn tin đầu tiên cho chủ sở hữu, không cần bước khởi tạo thủ công.
- Đổi địa chỉ tunnel: khi URL Cloudflare thay đổi, chỉ cần
teams app update <app-id> --endpoint https://domain-moi/webhook/teamsthay vì chạy lại toàn bộ skill.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục .claude/skills/add-teams từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-teams/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-teams ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và clone kho NanoClaw:
git clone https://github.com/nanocoai/nanoclaw.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r nanoclaw/.claude/skills/add-teams ~/.claude/skills/- Nếu bạn đã làm việc trực tiếp trong kho NanoClaw thì skill đã sẵn sàng, không cần sao chép.
- Chuẩn bị: tài khoản Microsoft 365 Business/EDU/developer có quyền tải app tuỳ chỉnh, cùng Node.js/npm và pnpm.
- Bật tunnel HTTPS trước:
cloudflared tunnel --url http://localhost:3000và lưu lại địa chỉhttps://... - Chạy Claude Code tại thư mục gốc NanoClaw và yêu cầu: "Dùng skill add-teams để thêm kênh Teams" (hoặc chọn Teams trong luồng
/setup). - Nhập URL tunnel, đặt tên bot, rồi đăng nhập Microsoft 365 bằng trình duyệt hoặc device code.
- Mở link cài đặt được in ra để thêm ứng dụng vào Teams; sau khi dịch vụ khởi động lại, kiểm tra tin nhắn DM đầu tiên từ bot.
- Nếu gặp lỗi, xem mục Troubleshooting trong SKILL.md (chặn sideloading,
AUTH_REQUIRED, lỗi 401...).