Bỏ qua tới nội dung
Ông T.vn

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

11 phút đọcCập nhật
Switch: đồng đội AI trong Slack, Teams, Discord — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

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.

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.

Ứng dụng

sandbox-quantum/switch

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.

★ 4.5kPython
Xem repo trên GitHub

I.Switch làm được gì

A.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.

B.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.

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.

D.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.

E.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.

II.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.

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.

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

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

A.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.

B.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.

C.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.

D.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.

E.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:

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

Với OpenAI Codex CLI:

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

Với OpenCode:

Terminal
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.

F.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.

IV.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.

V.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.

A.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.

B.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

C.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.

D.Độ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.

VI.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.

A.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.

B.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.

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.

D.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.

E.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.

VII.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.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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ể.

Chuyển nhanh tới mục

  1. I.Switch làm được gì
    1. A.Mỗi kênh là một phòng cho cả người lẫn agent
    2. B.Agent nào, mô hình nào cũng được
    3. C.Đồng đội AI có vai trò riêng
    4. D.Tự dựng hoặc dùng bản đám mây
    5. E.Quản trị và kiểm soát
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Tải Switch Console
    2. B.Cài và mở ứng dụng
    3. C.Nói chuyện với switch-buddy
    4. D.Nối ứng dụng nhắn tin
    5. E.Cho agent của bạn đọc tài liệu qua MCP (tuỳ chọn)
    6. F.Tự dựng máy chủ riêng
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Lập trình viên làm tính năng cùng đồng nghiệp và agent
    2. B.Nhóm hỗ trợ khách hàng có agent trả lời theo tài liệu nội bộ
    3. C.Kênh tiếp nhận yêu cầu tính năng và báo lỗi
    4. D.Đội kỹ thuật xử lý sự cố ngoài giờ
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Cài nhầm bản cho máy
    2. B.Agent không phản hồi trong kênh
    3. C.Không nối được ứng dụng nhắn tin
    4. D.Tự dựng máy chủ bị vướng
    5. E.Agent dùng quá nhiều chi phí
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.