# Switch: đồng đội AI trong Slack, Teams, Discord — hướng dẫn cài đặt và dùng

> Switch là phần mềm mã nguồn mở biến mỗi kênh chat thành một phòng làm việc chung cho người và các agent AI, chạy được với nhiều agent và nhiều mô hình khác nhau. Bạn cài ứng dụng desktop Switch Console, mở lên rồi nói chuyện với trợ lý switch-buddy để tạo agent và phòng đầu tiên. Cài ứng dụng không khó; tự dựng máy chủ riêng thì cần kiến thức kỹ thuật hơn.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-20 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/switch-dong-doi-ai-trong-slack-teams-discord

Switch là một nền tảng mã nguồn mở giúp đưa các agent AI vào làm việc cùng đội của bạn ngay trong Slack, Microsoft Teams, Discord, Telegram và Mattermost. Mỗi kênh chat trở thành một "phòng" nơi người và agent AI cùng đọc chung một cuộc trò chuyện, cùng quyết định và cùng tài liệu. Bạn có thể tự dựng trên máy chủ của mình, hoặc dùng bản đám mây Switch Cloud do tác giả vận hành.

Vấn đề Switch giải quyết khá đời thường. Hiện nay mỗi người trong nhóm hay có một con AI riêng: người này dùng Claude Code, người kia dùng Codex. Những cuộc trao đổi đó nằm rời rạc trong máy từng người. Muốn nhờ đồng nghiệp xem lại, bạn phải copy dán, giải thích lại từ đầu. Switch kéo các agent đó vào chung một kênh để cả nhóm thấy toàn bộ quá trình.

Điểm đáng giá nhất: Switch không bán agent và không bán mô hình. Bạn giữ nguyên công cụ đang dùng, Switch chỉ là lớp kết nối chúng với đội ngũ và với ứng dụng nhắn tin có sẵn. Repo hiện có khoảng 4486 sao và 350 fork, ngôn ngữ chính là Python, và vẫn được cập nhật trong 3 tháng gần đây.

```repo
- repo | sandbox-quantum/switch
- kind | Ứng dụng
- desc | Switch đưa các agent AI (Claude Code, Codex, Cursor…) vào Slack, Teams, Discord, Telegram, Mattermost để cả nhóm cùng làm việc với AI trong một kênh.
- stars | 4.5k
- lang | Python
```

## Switch làm được gì

### Mỗi kênh là một phòng cho cả người lẫn agent
Agent tham gia cuộc trò chuyện ngay trong Slack, Teams, Discord, Telegram hay Mattermost. Cả nhóm không phải học công cụ mới hay chuyển chỗ làm việc. Nếu không muốn dùng ứng dụng nhắn tin, bạn vẫn có thể chat thẳng với agent trong Switch Console.

### Agent nào, mô hình nào cũng được
README nêu các ví dụ: agent Claude Code trên laptop của bạn, agent Codex trên máy đồng nghiệp, agent Antigravity, Cursor hoặc OpenCode trên máy chủ, hoặc agent tự viết bằng LangChain hay ADK. Chỉ cần agent nói được giao thức của Switch là tham gia được. Lợi ích thực tế: bạn đổi agent hay đổi nhà cung cấp mô hình mà không mất ngữ cảnh công việc.

### Đồng đội AI có vai trò riêng
Bạn gán cho mỗi agent một vai trò, hướng dẫn riêng và các "connector" (kết nối) tới Google Workspace, Atlassian, GitHub, Datadog và Airtable. Các phòng có thể liên kết với nhau theo cách đội bạn làm việc. Một agent chỉ nhìn thấy những phòng mà nó được thêm vào, nên thông tin không lan lung tung.

### Tự dựng hoặc dùng bản đám mây
Tự dựng thì dữ liệu nằm trên máy chủ của bạn. Dùng Switch Cloud thì tác giả vận hành giúp. README khẳng định cả hai cách đều giữ ngữ cảnh thuộc về công ty bạn.

### Quản trị và kiểm soát
Quản trị viên quyết định ai được nói chuyện với agent nào, ở phòng nào, đặt hạn mức sử dụng và bật tắt connector. README cũng nhắc tới Switch Trust (rào chắn an toàn) và Switch ROI (báo cáo chi phí) như các phần đi kèm.

## Cần chuẩn bị gì

Tư liệu README nói khá ít về yêu cầu, nên mình chỉ liệt kê những gì có thật:

- **Hệ điều hành cho ứng dụng Switch Console:** macOS (chip Apple Silicon hoặc Intel), Windows, Linux x64 và Linux ARM64.
- **Agent mà bạn đã dùng sẵn:** ví dụ Claude Code, Codex, Cursor, OpenCode. Switch không đi kèm agent hay mô hình nào, nên bạn cần có sẵn tài khoản hoặc quyền dùng các công cụ đó.
- **Một ứng dụng nhắn tin** mà đội bạn đang dùng, nếu muốn agent vào Slack, Teams, Discord, Telegram hoặc Mattermost.
- **Chọn nơi chạy:** Switch Cloud hoặc máy chủ của bạn.

Về phiên bản Node, Python, cấu hình phần cứng hay GPU: README không nói. Một mã lỗi mẫu trong phần telemetry là `docker_daemon_down` gợi ý rằng Console có thể cần Docker khi chạy máy chủ cục bộ, nhưng đó chỉ là suy đoán của mình, README không khẳng định. Bạn nên xem tài liệu chính thức trước khi tự dựng.

```note
Switch không bán mô hình. Chi phí dùng agent (ví dụ gói Claude hay Codex của bạn) vẫn do bạn trả cho nhà cung cấp tương ứng. README không nêu giá của Switch Cloud, nên hãy kiểm tra trên trang dự án trước khi dùng.
```

## Cài đặt từng bước

```steps
- Tải Switch Console | Chọn đúng bản cho hệ điều hành của bạn trong trang release
- Cài và mở ứng dụng | Chạy trình cài đặt rồi mở Switch Console
- Nói chuyện với switch-buddy | Chọn Switch Cloud hoặc máy chủ riêng, rồi nhờ nó tạo agent và phòng
- Nối ứng dụng nhắn tin | Nhờ switch-buddy hướng dẫn kết nối Slack, Teams, Discord, Telegram hoặc Mattermost
- (Tuỳ chọn) Nối tài liệu bằng MCP | Cho agent của bạn đọc tài liệu Switch để hỏi đáp khi cần
```

### Tải Switch Console
README ghi cách cài là tải ứng dụng desktop, không có lệnh cài. Vào trang "latest release" của repo trên GitHub và chọn một trong các file sau:

- macOS: bản Apple Silicon (`switch-console-arm64.dmg`) hoặc bản Intel (`switch-console-x64.dmg`).
- Windows: `switch-console-x64.exe`.
- Linux x64: `switch-console-x86_64.AppImage` hoặc `switch-console-amd64.deb`.
- Linux ARM64: `switch-console-arm64.AppImage` hoặc `switch-console-arm64.deb`.

Chỗ người mới hay vấp: máy Mac đời mới (M1, M2, M3…) là Apple Silicon, máy Mac đời cũ chip Intel. Chọn nhầm bản có thể không chạy. Bạn xem trong mục "About This Mac" nếu không chắc.

### Cài và mở ứng dụng
Trên Windows, bấm đúp file `.exe` và làm theo trình cài đặt. Trên macOS, mở file `.dmg` rồi kéo ứng dụng vào thư mục Applications. Trên Linux, chạy file AppImage hoặc cài file DEB bằng trình quản lý gói của bản phân phối bạn dùng. README không đưa lệnh cụ thể cho phần này.

Lần đầu mở, ứng dụng sẽ báo về việc thu thập số liệu sử dụng ẩn danh (telemetry). Mục này có công tắc tắt, mình nói thêm ở phần cuối bài.

### Nói chuyện với switch-buddy
Đây là bước chính. Trong Console, bạn chọn Switch Cloud hoặc máy chủ riêng của bạn, rồi nói với switch-buddy (trợ lý AI của Switch) điều bạn muốn. Theo README, nó sẽ tạo agent và phòng đầu tiên, giúp bạn nối ứng dụng nhắn tin đội bạn đang dùng, và trả lời mọi câu hỏi về Switch. Bạn cứ gõ yêu cầu bằng ngôn ngữ thường, không cần cú pháp đặc biệt.

Nếu bạn mới làm quen, README cũng gợi ý đọc trang "Getting started" trong tài liệu chính thức.

### Nối ứng dụng nhắn tin
README không liệt kê từng thao tác nối Slack hay Teams. Cách làm theo README là nhờ switch-buddy hướng dẫn trong Console. Hãy để ý lúc nối: bạn thường cần quyền quản trị ở không gian làm việc của ứng dụng nhắn tin. Nếu bạn không phải admin, hãy nhờ người có quyền.

### Cho agent của bạn đọc tài liệu qua MCP (tuỳ chọn)
Tài liệu Switch được phục vụ qua MCP tại `https://docs.switchagents.ai/mcp`. Bạn nối agent vào đó rồi hỏi nó "How do I get started with Switch?" để được dẫn từng bước. Mở terminal (PowerShell trên Windows hoặc Terminal trên Mac) rồi chạy một trong các lệnh sau.

Với Claude Code:

```bash
claude mcp add switch-docs --transport http https://docs.switchagents.ai/mcp
```

Với OpenAI Codex CLI:

```bash
codex mcp add switch-docs --url https://docs.switchagents.ai/mcp
```

Với OpenCode:

```bash
opencode mcp add
```

Với OpenCode, lệnh trên sẽ hỏi từng bước; khi được hỏi địa chỉ máy chủ MCP, bạn điền `https://docs.switchagents.ai/mcp`. Các lệnh này chỉ chạy được khi bạn đã cài sẵn Claude Code, Codex CLI hoặc OpenCode tương ứng.

### Tự dựng máy chủ riêng
README không có lệnh cài máy chủ. Nó chỉ chỉ sang trang "Hosting remotely" trong tài liệu chính thức. Trong repo có thư mục `deploy/` và file `.env.example` chứa các biến cấu hình, ví dụ cổng, thông tin cơ sở dữ liệu và tài khoản quản trị. Nhưng README chưa ghi cách dùng chúng, nên mình không đoán lệnh. Hãy đọc tài liệu chính thức rồi mới làm.

## Kiểm tra đã chạy được chưa

README không mô tả màn hình "thành công" cụ thể. Dựa trên các bước nó mô tả, bạn có thể tự kiểm tra như sau:

- Switch Console mở được và cho bạn chọn giữa Switch Cloud với máy chủ riêng.
- Bạn chat được với switch-buddy và nó trả lời câu hỏi về Switch.
- Sau khi nhờ switch-buddy, bạn thấy agent và phòng đầu tiên xuất hiện trong Console.
- Nếu đã nối ứng dụng nhắn tin: vào kênh tương ứng, gọi agent và thấy nó trả lời ngay trong kênh.
- Với phần MCP: hỏi agent của bạn "How do I get started with Switch?" và thấy nó trả lời dựa trên tài liệu.

## Dùng vào việc thật

Các tình huống dưới đây bám theo ví dụ trong README. Cách thiết lập chi tiết bạn hãy nhờ switch-buddy làm cùng.

### Lập trình viên làm tính năng cùng đồng nghiệp và agent
Bạn đang dùng Claude Code để làm một tính năng. Thay vì làm riêng trong máy, bạn mở một kênh cho tính năng đó, đưa agent và đồng nghiệp vào. Khi cần người khác xem lại, họ đọc ngay toàn bộ quá trình trong kênh, không cần bạn dán lại hay giải thích. Câu gợi ý nói với switch-buddy:

```text
Tạo một phòng cho tính năng đăng nhập, thêm agent Claude Code của mình và hai đồng nghiệp vào.
```

Kết quả: một kênh có đủ người, agent và lịch sử công việc.

### Nhóm hỗ trợ khách hàng có agent trả lời theo tài liệu nội bộ
Một công ty nhỏ có bộ runbook (tài liệu hướng dẫn xử lý) cho đội hỗ trợ. Họ lập một kênh hỗ trợ, đặt một agent vai trò hỗ trợ, và nhân viên mới hỏi thẳng agent đó. README mô tả kịch bản agent trả lời từ runbook, và khi phát hiện runbook sai thì sửa ở kênh đang quản lý tài liệu đó. Bạn nên cho người duyệt các thay đổi này, đừng để agent tự sửa không kiểm soát.

> Switch không bắt cả đội chuyển sang công cụ mới. Nó đem agent đến nơi đội bạn đã làm việc sẵn.
>
> — Ông T

### Kênh tiếp nhận yêu cầu tính năng và báo lỗi
Chủ sản phẩm lập một kênh nhận yêu cầu. Một agent phân loại những gì gửi vào, hỏi lại những câu mà bạn vẫn hay hỏi, rồi ghi vào Jira, Confluence hoặc Notion. Với kênh báo lỗi, agent cố tái hiện lỗi, thu thập log và phiên bản, rồi hoặc tạo phiếu hoặc cho người báo biết còn thiếu gì. Đây là mức "Level 2" trong README. Bạn nên bắt đầu từ mức này sau khi quen với mức 1.

### Đội kỹ thuật xử lý sự cố ngoài giờ
README có ví dụ sự cố thanh toán: có người báo checkout lỗi, một agent mở kênh sự cố, lấy tỷ lệ lỗi và tìm ra bản triển khai gây lỗi, trong khi agent thứ hai vẽ biểu đồ. Cảnh báo tới kênh trực, người đang trực nhận việc, và cuối cùng agent viết lại những gì đã xảy ra vào kho kiến thức của đội. Để làm được, bạn cần bật connector như Datadog hoặc GitHub, và đây là việc nên có người phụ trách kỹ thuật.

## Lỗi hay gặp và cách xử lý

README không có mục xử lý lỗi, nên các mục dưới đây là những tình huống rất dễ gặp với loại công cụ này.

### Cài nhầm bản cho máy
Triệu chứng: ứng dụng không mở hoặc báo không tương thích. Cách xử lý: kiểm tra máy là Intel hay Apple Silicon, hoặc Linux x64 hay ARM64, rồi tải lại đúng file ở trang release.

### Agent không phản hồi trong kênh
Triệu chứng: bạn gọi agent mà im lặng. Hãy kiểm tra agent đã được thêm vào đúng phòng chưa (agent chỉ thấy những phòng nó thuộc về), và agent gốc (ví dụ Claude Code) có đang chạy, còn đăng nhập hay không. Nếu vẫn không được, hỏi switch-buddy hoặc xem tài liệu chính thức.

### Không nối được ứng dụng nhắn tin
Thường do thiếu quyền ở Slack, Teams hay Discord. Nhờ quản trị viên không gian làm việc cấp quyền hoặc tự thực hiện bước kết nối. Đừng gửi mật khẩu hay token qua kênh chat công khai.

### Tự dựng máy chủ bị vướng
Nếu bạn chọn máy chủ riêng, các vấn đề như cổng bị chiếm, kết nối cơ sở dữ liệu, thiếu biến cấu hình là phổ biến. File `.env.example` trong repo liệt kê các biến cần điền, gồm cả mật khẩu và khoá bí mật. Hãy tự đặt giá trị mạnh cho các biến này, không dùng giá trị mặc định, không đưa file `.env` lên GitHub. Nếu chưa quen, hãy dùng Switch Cloud trước.

### Agent dùng quá nhiều chi phí
Vì agent chạy bằng tài khoản mô hình của bạn, dùng nhiều thì tốn nhiều. README nói quản trị viên có thể đặt hạn mức sử dụng. Hãy đặt hạn mức ngay từ đầu và theo dõi.

## Có nên dùng không

**Điểm mạnh:**

- Giữ nguyên công cụ chat và agent bạn đang dùng, không bắt đổi thói quen.
- Hỗ trợ nhiều agent và nhiều mô hình, đổi nhà cung cấp mà không mất ngữ cảnh.
- Có cả bản tự dựng và bản đám mây, mã nguồn mở.
- Có phân quyền, hạn mức và theo dõi chi phí cho đội.
- Cài ứng dụng đơn giản, lại có trợ lý switch-buddy dẫn từng bước.

**Giới hạn cần biết:**

- Switch không có agent hay mô hình đi kèm, bạn phải có sẵn.
- Tài liệu cài máy chủ nằm ở trang riêng, README chưa ghi lệnh cụ thể.
- Repo ghi mô tả của tác giả là agent "ở mức tổ chức", nhưng chính README thừa nhận còn nhiều thứ đang định hình. Hãy xem đây là dự án đang phát triển.
- Telemetry của Console mặc định bật (opt-out). README nói dữ liệu gửi đi chỉ là số liệu ẩn danh từ một danh sách cố định, như tên sự kiện, phiên bản, hệ điều hành, và không gồm mã nguồn, prompt, khoá API hay tên dự án. Bạn tắt được bằng công tắc "Share usage data" ở lần chạy đầu hoặc trong Settings → General. Máy chủ Switch Core chỉ gửi telemetry khi `TELEMETRY_ENABLED=true`, mặc định tắt.
- Giấy phép: tư liệu cung cấp không ghi rõ loại giấy phép. Repo có file LICENSE, nếu định dùng cho doanh nghiệp bạn nên đọc kỹ file đó.

**Khi nào chọn cách khác:** nếu bạn chỉ làm một mình và chỉ cần hỏi đáp với AI, dùng thẳng công cụ AI quen thuộc sẽ đơn giản hơn. Switch đáng thử khi có từ hai người trở lên cần làm việc chung với agent và muốn mọi thứ nằm trong một kênh. Hãy bắt đầu nhỏ: một kênh, một agent, rồi mở rộng dần.

## Câu hỏi thường gặp

### Switch có miễn phí không?

Mã nguồn mở và README cho phép tự dựng trên máy chủ của bạn. Tư liệu không nêu giá của Switch Cloud, nên bạn cần xem trên trang dự án. Ngoài ra, agent và mô hình bạn dùng vẫn tính phí theo nhà cung cấp riêng của chúng.

### Switch chạy được trên Windows không?

Được. README có bản cài đặt Windows (file .exe) cho ứng dụng Switch Console. Ngoài ra còn có bản macOS (Apple Silicon và Intel) và Linux (x64, ARM64).

### Cần GPU hoặc cấu hình mạnh không?

Tư liệu không nêu yêu cầu phần cứng hay GPU. Switch là lớp kết nối agent với đội ngũ và không cung cấp mô hình, nên phần nặng nằm ở agent hoặc mô hình bạn dùng.

### Switch hỗ trợ những ứng dụng nhắn tin nào?

Slack, Microsoft Teams, Discord, Telegram và Mattermost. Bạn cũng có thể chat với agent ngay trong Switch Console mà không cần ứng dụng nhắn tin.

### Dữ liệu của tôi có an toàn không?

README nói dù dùng Switch Cloud hay tự dựng, dữ liệu vẫn nằm ở nơi bạn chọn, và agent chỉ thấy những phòng nó thuộc về. Telemetry của Console là ẩn danh, mặc định bật và có thể tắt, README liệt kê rõ những gì không bao giờ được thu thập. Bạn vẫn nên tự đánh giá theo quy định của công ty.

### Switch khác gì một con bot AI trong Slack?

Theo README, Switch không chỉ là một bot để bạn hỏi đáp. Nó biến mỗi kênh thành phòng chung cho người và nhiều agent cùng làm việc, có vai trò, connector và phân quyền riêng. Nó cũng không đi kèm agent hay mô hình cố định nào.

### Cài Switch có khó không?

Cài ứng dụng Switch Console thì đơn giản: tải file cho hệ điều hành rồi mở lên, sau đó nói chuyện với switch-buddy. Tự dựng máy chủ khó hơn, và README chỉ sang tài liệu chính thức chứ chưa ghi lệnh cụ thể.
