Hướng Dẫn Config Office 365 Connector cho OpenClaw

Tổng quan

Office365-Connector cho phép OpenClaw tích hợp với Microsoft 365 để:

• ✅ Đọc, soạn thảo, gửi email
• ✅ Kiểm tra lịch họp, đặt lịch mới
• ✅ Quản lý danh bạ và công việc
• ✅ Tóm tắt briefing sáng tự động
• ✅ Phân loại email (email triage)

Bước chuẩn bị: Admin tạo Azure App

Bước 1: Tạo App Registration

Admin đăng nhập vào portal.azure.com bằng tài khoản có quyền Admin:

1. Vào Microsoft Entra ID (bên trái menu)
2. Chọn App registrations
3. Nhấn + New registration (góc trên trái)
4. Điền thông tin:
   • Name: OpenClaw-Office365
   • Supported account types: Chọn Accounts in this organizational directory only
   • Redirect URI: Chọn Web → nhập http://<ip hoặc domain chạy openclaw>:8080/callback
5. Nhấn Register
6. Ghi lại 2 ID quan trọng:
   • Application (Client) ID (hiển thị trên trang Overview)
   • Directory (Tenant) ID (hiển thị trên trang Overview)

Bước 2: Tạo Client Secret

Vẫn trong app OpenClaw-Office365 vừa tạo:

1. Vào tab Certificates & secrets (bên trái menu)
2. Chọn Client secrets
3. Nhấn + New client secret
4. Điền:
   • Description: openclaw-secret
   • Expires: Chọn 24 months
5. Nhấn Add
6. ⚠️ NGAY LẬP TỨC: Sao chép giá trị Value (secret chỉ hiển thị 1 lần duy nhất!)

Bước 3: Cấp API Permissions

Vẫn trong app OpenClaw-Office365:

1. Vào tab API permissions

2. Nhấn + Add a permission

3. Chọn Microsoft Graph

4. Chọn Delegated permissions

5. Tìm và chọn các permission sau:

   • ✓ Mail.Read — đọc email
   • ✓ Mail.Send — gửi email
   • ✓ Mail.ReadWrite — xóa/di chuyển email
   • ✓ Calendars.ReadWrite — đọc & đặt lịch
   • ✓ Contacts.ReadWrite — đọc danh bạ
   • ✓ User.Read — thông tin tài khoản
   • ✓ OnlineMeetings.ReadWrite — (tùy chọn) tạo/quản lý Teams meeting

6. Nhấn Add permissions

7. Quay lại trang API permissions

8. Nhấn Grant admin consent for [tên tổ chức của bạn]

9. Xác nhận Yes khi được hỏi

Sau bước này, tất cả permission sẽ có dấu ✅ xanh ở cột Status.

Bước 4: (Tùy chọn) Giới hạn scope cho user cụ thể

Nếu chỉ muốn một vài user được phép dùng (không phải toàn bộ organization):

1. Vào Enterprise applications (bên trái menu)
2. Tìm app OpenClaw-Office365
3. Vào Properties
4. Bật toggle Assignment required → Save
5. Vào Users and groups (bên trái menu)
6. Nhấn + Add user/group
7. Chọn user được phép dùng → nhấn Assign

Bước 5: Giao thông tin cho member

Admin cung cấp 3 thông tin này cho member:

Client ID: ________________________________
Tenant ID: ________________________________
Client Secret: ________________________________