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

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

11 phút đọcCập nhật

Bài này là một góc nhìn khác về sandbox-quantum/switch — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Switch: đồng đội AI trong Slack, Teams, Discord — hướng dẫn cài đặt và dùng →

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

Tóm tắt nhanh

Switch (sandbox-quantum/switch) là nền tảng 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à agent AI, dùng được với nhiều agent và nhiều mô hình. Bạn có thể cài ứng dụng desktop Switch Console rồi nói chuyện với trợ lý switch-buddy để dựng agent và phòng đầu tiên. Cài ứng dụng khá đơn giản; tự dựng server riêng thì cần thêm hiểu biết kỹ thuật.

Switch là một nền tảng mã nguồn mở giúp các agent AI làm việc cùng team của bạn ngay trong Slack, Microsoft Teams, Discord, Telegram và Mattermost. Thay vì một con bot để bạn hỏi từng câu, mỗi kênh chat trở thành một "phòng" nơi người và agent AI cùng đọc chung cuộc trò chuyện, quyết định và tài liệu.

Bạn nên xem repo này nếu team đã dùng một công cụ chat quen thuộc và đang có (hoặc muốn có) vài agent như Claude Code, Codex, Cursor, OpenCode. Hiện đa số người dùng agent riêng lẻ trên máy mình, kết quả nằm rải rác. Switch kéo chúng vào cùng một kênh để đồng nghiệp xem lại, bổ sung, hỏi thêm mà không phải copy dán hay giải thích lại từ đầu.

Điểm đáng giá nhất: Switch không bán agent hay mô hình. Bạn giữ nguyên agent đang dùng, Switch chỉ là lớp kết nối. Repo hiện có khoảng 4464 sao và 348 fork, vẫn được cập nhật trong vài 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 để làm việc chung với team; tự host được.

★ 4.5kPython
Xem repo trên GitHub

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

A.Mỗi kênh chat là một phòng cho người và agent

Agent tham gia cuộc trò chuyện trong Slack, Teams, Discord, Telegram hoặc Mattermost. Cả team làm việc từ cùng một nguồn: cuộc hội thoại, quyết định, tài liệu. Không ai phải học thêm công cụ mới hay chuyển sang nơi khác. Nếu không muốn dùng ứng dụng chat, bạn vẫn có thể nói chuyện trực tiếp với agent trong Switch Console.

B.Agent nào, mô hình nào cũng được

README nêu 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 server, 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 không bị khoá vào một hãng, đổi mô hình lúc nào cũng được mà không mất ngữ cảnh.

C.Agent như một đồng nghiệp có vai trò

Bạn gán cho mỗi agent một vai trò, hướng dẫn riêng và các connector (README liệt kê Google Workspace, Atlassian, GitHub, Datadog, Airtable). Bạn cũng có thể liên kết các phòng với nhau theo cách team làm việc. Một agent chỉ nhìn thấy những phòng mà nó thuộc về, nên dữ liệu không bị lộ lung tung.

D.Tự host hoặc dùng Switch Cloud

Bạn có thể chạy Switch trên server của mình, hoặc dùng Switch Cloud do nhóm tác giả vận hành. Theo README, dù chọn cách nào thì ngữ cảnh vẫn 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, trong phòng nào; đặt ngân sách sử dụng, bật tắt connector, kiểm soát quyền truy cập. Phần guardrail và báo cáo chi phí nằm ở các sản phẩm đi kèm là Switch Trust và Switch ROI.

F.Bốn mức dùng, từ nhẹ đến sâu

README gợi ý đi từng bước: mức 1 là đưa agent hằng ngày vào kênh chat; mức 2 là bắt đầu mã hoá cách làm việc (kênh tiếp nhận yêu cầu, kênh báo lỗi); mức 3 là cả quy trình chạy trên Switch (báo lỗi, tái hiện, sửa, review, triển khai); mức 4 là cả công ty vận hành cùng agent. Bạn không cần làm lớn ngay, mức 1 dùng được từ ngày đầu.

II.Cần chuẩn bị gì

Theo README, để bắt đầu bạn cần:

  • Một máy macOS (Apple Silicon hoặc Intel), Windows, hoặc Linux (x64 hoặc ARM64) để cài ứng dụng Switch Console.
  • Tuỳ chọn: dùng Switch Cloud, hoặc dùng server của riêng bạn.
  • Một ứng dụng chat mà team đang dùng nếu muốn agent vào đó (Slack, Teams, Discord, Telegram, Mattermost). Trợ lý switch-buddy sẽ giúp bạn kết nối.
  • Ít nhất một agent bạn đã dùng sẵn (như Claude Code, Codex…) để đưa vào phòng. Switch không kèm agent hay mô hình nào.

Về tự host: README chưa liệt kê yêu cầu phần cứng hay phiên bản phần mềm cụ thể. Tuy nhiên file .env.example trong repo có các biến như DB_HOST, DB_USER, DB_PASSWORD, JWT_SECRET_KEY, GATEWAY_ADMIN_EMAIL, GATEWAY_ADMIN_PASSWORD, nghĩa là server cần cơ sở dữ liệu và tài khoản quản trị. Ngoài ra README có nhắc mã lỗi docker_daemon_down trong phần telemetry, gợi ý rằng Console có thể dùng Docker khi chạy server cục bộ. Đây là suy đoán từ tư liệu, bạn nên kiểm tra lại trong tài liệu chính thức.

README và tư liệu chưa nêu rõ loại giấy phép của repo (có file LICENSE trong thư mục gốc, bạn nên mở ra đọc trước khi dùng cho công ty). Switch cũng không kèm agent hay mô hình, nên chi phí gọi mô hình tuỳ vào agent bạn đang dùng.

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

  1. Tải Switch ConsoleTải bản cài đặt đúng hệ điều hành từ trang releases
  2. Cài và mở ứng dụngChạy file vừa tải, mở Switch Console
  3. Chọn nơi chạyChọn Switch Cloud hoặc server của riêng bạn
  4. Nói với switch-buddyNhờ trợ lý tạo agent và phòng đầu tiên, kết nối app chat
  5. (Tuỳ chọn) Kết nối tài liệu qua MCPCho agent của bạn đọc docs của Switch để được hướng dẫn

A.Tải Switch Console

Switch Console là ứng dụng desktop. README cung cấp liên kết tải theo từng nền tảng trong mục Releases của repo:

  • macOS: bản Apple Silicon (file switch-console-arm64.dmg) hoặc Intel (switch-console-x64.dmg).
  • Windows: file cài đặt 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.

Không biết máy Mac mình là chip nào? Bấm biểu tượng quả táo, chọn About This Mac: nếu thấy chữ Apple M1/M2/M3… thì chọn Apple Silicon, nếu thấy Intel thì chọn Intel. Các bản desktop khác nằm ở trang latest release của repo.

B.Cài và mở ứng dụng

Mở file vừa tải và cài như mọi phần mềm khác. Lần chạy đầu, Console sẽ thông báo về việc thu thập dữ liệu sử dụng ẩn danh (telemetry). Mặc định tính năng này bật; bạn có thể tắt ngay ở thông báo này, hoặc sau đó vào Settings → General và tắt mục Share usage data.

C.Chọn Switch Cloud hay server riêng

Trong Console, bạn chọn dùng Switch Cloud (do tác giả vận hành) hoặc server của riêng bạn. Nếu mới thử, Switch Cloud là cách ít việc kỹ thuật nhất. Nếu công ty yêu cầu dữ liệu nằm trên hạ tầng của mình, hãy xem hướng dẫn Hosting remotely trong tài liệu chính thức.

D.Nói chuyện với switch-buddy

Sau khi mở Console, bạn trò chuyện với switch-buddy, trợ lý AI của Switch. Bạn chỉ cần nói mình muốn gì: nó sẽ tạo agent và phòng đầu tiên, giúp kết nối ứng dụng chat team đang dùng, và trả lời các câu hỏi về Switch. Ví dụ bạn có thể gõ:

text
Mình muốn tạo một agent hỗ trợ báo lỗi và một phòng để cả team dùng thử.

Đây chỉ là câu mẫu để bạn hình dung, không phải lệnh bắt buộc.

E.Tuỳ chọn: cho agent của bạn đọc tài liệu Switch qua MCP

Thay vì tự đọc tài liệu, bạn có thể nối agent đang dùng với máy chủ MCP của tài liệu Switch, rồi nhờ agent hướng dẫn từng bước. Địa chỉ là https://docs.switchagents.ai/mcp. Mở terminal (Terminal trên macOS/Linux, PowerShell hoặc Windows Terminal trên Windows) và chạy lệnh tương ứng với agent của bạn.

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, bạn làm theo các câu hỏi hiện ra và điền https://docs.switchagents.ai/mcp vào chỗ nhập địa chỉ MCP server. Sau đó hỏi agent: How do I get started with Switch?

F.Tự host server (nâng cao)

README chưa ghi lệnh cài server cụ thể. Bạn xem mục Hosting remotely trong tài liệu chính thức, cùng thư mục deploy/ và file .env.example trong repo để biết các biến cần điền. Lưu ý các biến như DB_PASSWORD, JWT_SECRET_KEY, GATEWAY_ADMIN_PASSWORD là bí mật, đừng đưa lên nơi công khai.

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

README không nêu một lệnh kiểm tra riêng, nhưng dấu hiệu thành công khá rõ khi bạn đi đúng quy trình:

  • Switch Console mở được và bạn nói chuyện được với switch-buddy.
  • switch-buddy tạo được agent và phòng đầu tiên cho bạn.
  • Sau khi kết nối ứng dụng chat, agent xuất hiện và trả lời trong kênh đã chọn.
  • Nếu làm phần MCP: chạy lại lệnh claude mcp add hoặc lệnh tương ứng không báo lỗi, và agent trả lời được câu hỏi về Switch dựa trên tài liệu.

Nếu mọi thứ chạy qua Switch Cloud mà bạn vẫn chưa thấy agent trong kênh chat, hãy hỏi thẳng switch-buddy, vì README nói nó trả lời được mọi câu hỏi về Switch.

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

Các tình huống dưới đây bám theo những ví dụ README đã mô tả ở các mức dùng, mình diễn giải lại cho gần đời thường.

A.Làm việc chung với agent coding trong một kênh

Bối cảnh: bạn là lập trình viên, đang dùng Claude Code để làm một tính năng, còn đồng nghiệp muốn xem bạn và agent đã làm gì.

Cách làm: mở một kênh cho tính năng đó, đưa agent của bạn và đồng nghiệp vào cùng. Khi cần review, bạn mời thêm người vào kênh.

Kết quả: toàn bộ lịch sử đã nằm sẵn trong kênh, không phải copy dán hay giải thích lại.

Agent không còn là công cụ riêng của một người, mà là thành viên của cả kênh.

Ông T

B.Một agent chuyên về một mảng hệ thống

Bối cảnh: team có một hệ thống phức tạp, chỉ một người hiểu rõ. Người đó dựng một agent Codex đã nắm một phần hệ thống.

Cách làm: đưa agent vào phòng chung, đồng nghiệp hỏi trực tiếp, ví dụ: Phần thanh toán gọi dịch vụ nào trước?

Kết quả: câu hỏi lặp lại được agent trả lời, người chuyên môn đỡ bị ngắt quãng. Bạn vẫn nên kiểm tra câu trả lời với người hiểu hệ thống khi việc quan trọng.

C.Kênh tiếp nhận yêu cầu và báo lỗi

Bối cảnh: nhân viên vận hành hoặc quản lý sản phẩm nhận nhiều yêu cầu tính năng và báo lỗi, ghi chép lộn xộn.

Cách làm: theo README ở mức 2, dựng một kênh yêu cầu tính năng, nơi agent phân loại, hỏi thêm những câu bạn sẽ hỏi, rồi ghi vào Jira, Confluence hoặc Notion; và một kênh báo lỗi, nơi agent tái hiện nếu được, thu log, phiên bản, rồi tạo ticket hoặc cho người báo biết còn thiếu gì. Để làm được, bạn cần bật connector tương ứng (Atlassian, v.v.) trong phần quản trị.

Kết quả: yêu cầu vào đã có cấu trúc, người xử lý đỡ phải hỏi lại.

D.Hỗ trợ xử lý sự cố ngay trong chat

Bối cảnh: một team kỹ thuật nhận cảnh báo hệ thống.

Cách làm: README mô tả cảnh một người báo thanh toán lỗi, một agent mở kênh sự cố, lấy tỉ lệ lỗi và tìm ra lần triển khai gây ra, trong khi agent thứ hai vẽ biểu đồ. Việc này dùng connector như Datadog và GitHub.

Kết quả: cả team cùng thấy diễn biến trong Slack, Discord hoặc Mattermost thay vì chuyền nhau ảnh chụp màn hình. Mức này đòi hỏi bạn thiết lập khá kỹ, không phải việc ngày đầu.

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

Tư liệu không liệt kê lỗi cụ thể, 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, kèm cách xử lý an toàn.

A.Tải nhầm bản cài cho máy

Triệu chứng: ứng dụng không mở được. Cách xử lý: kiểm tra lại chip (Apple Silicon hay Intel), hoặc Linux x64 hay ARM64, rồi tải đúng file ở trang releases.

B.Console báo lỗi liên quan đến Docker

README có nhắc mã lỗi docker_daemon_down trong danh sách ví dụ của telemetry. Nếu bạn chạy server cục bộ qua Console và gặp lỗi tương tự, hãy kiểm tra Docker đã được cài và đang chạy chưa. Đây là suy luận từ tên mã lỗi, bạn nên đối chiếu tài liệu chính thức.

C.Agent không thấy trong kênh chat

Thường do chưa kết nối ứng dụng chat hoặc chưa thêm agent vào đúng phòng. Hãy nhờ switch-buddy kiểm tra, và nhớ rằng agent chỉ thấy các phòng mà nó đã là thành viên.

D.Agent không dùng được connector

Quản trị viên là người bật tắt connector. Nếu agent không truy cập được Jira, GitHub… hãy kiểm tra connector đã được bật cho workspace chưa, và agent có quyền trong phòng đó không.

E.Lộ khoá khi tự host

File .env.example có nhiều biến bí mật. Hãy sao chép thành file cấu hình của bạn, điền giá trị mạnh, và không đưa file chứa mật khẩu lên kho mã công khai.

VII.Có nên dùng không

Điểm mạnh: ý tưởng rõ (đưa agent vào nơi team đã làm việc), không bắt bạn bỏ agent hay ứng dụng chat đang dùng, hỗ trợ nhiều nền tảng chat, mã nguồn mở và cho phép tự host, có kiểm soát quyền và ngân sách. Cài ứng dụng Console khá đơn giản và có switch-buddy dẫn đường.

Giới hạn: Switch không cung cấp agent hay mô hình, bạn phải có sẵn. README chưa ghi lệnh tự host ngay trong trang chính, nên triển khai server riêng cần người có kinh nghiệm. Giấy phép chưa được nêu rõ trong tư liệu, bạn cần đọc file LICENSE. Telemetry của Console mặc định bật (có thể tắt), còn của server mặc định tắt. Các mức 3 và 4 đòi hỏi đầu tư thiết kế quy trình, không phải cắm là chạy.

Nên chọn cách khác nếu bạn chỉ làm việc một mình và chỉ cần một agent hỏi đáp đơn giản; khi đó dùng thẳng agent đó là đủ. Còn nếu team đã có thói quen làm việc trong Slack, Teams, Discord và muốn nhiều người cùng làm việc với agent, Switch rất đáng thử ở mức 1 trước.

4.2/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 nằm công khai trên GitHub và bạn có thể tự host. README không nêu giá của Switch Cloud nên mình chưa có thông tin về chi phí. Agent và mô hình bạn dùng cùng Switch có thể phát sinh chi phí riêng tuỳ nhà cung cấp.

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

Có. README cung cấp file cài đặt cho Windows (switch-console-x64.exe), cùng bản cho macOS và Linux (x64 và ARM64).

Switch có kèm sẵn agent hay mô hình AI không?

Không. README nói rõ Switch không cung cấp agent hay mô hình. Bạn dùng Claude Code, Codex, Antigravity, Cursor, OpenCode hoặc agent tự xây, và Switch giúp chúng làm việc với team.

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

README nói dù dùng Switch Cloud hay tự host thì dữ liệu ở nơi bạn đặt và ngữ cảnh thuộc về công ty bạn. Agent chỉ thấy những phòng nó thuộc về. Telemetry của Console có thể tắt, và README liệt kê rõ những gì không thu thập như mã nguồn, prompt, khoá API. Bạn vẫn nên tự đánh giá theo chính sách bảo mật của công ty.

Switch khác gì một con bot chat AI thông thường?

Bot thường chỉ trả lời từng câu hỏi của từng người. Switch biến mỗi kênh thành phòng chung nơi người và nhiều agent cùng làm việc với ngữ cảnh chung, có vai trò, connector và phân quyền.

Switch hỗ trợ những ứng dụng chat nào?

Slack, Microsoft Teams, Discord, Telegram và Mattermost. Bạn cũng có thể nói chuyện với agent trực tiếp trong Switch Console mà không cần ứng dụng chat.

Có thu thập dữ liệu người dùng không?

Switch Console thu thập số liệu sử dụng ẩn danh theo kiểu opt-out (mặc định bật), tắt được ở thông báo lần đầu hoặc trong Settings → General. Server Switch Core chỉ gửi telemetry khi đặt TELEMETRY_ENABLED=true và mặc định tắt.

Chuyển nhanh tới mục

  1. I.Switch làm được gì
    1. A.Mỗi kênh chat là một phòng cho người và agent
    2. B.Agent nào, mô hình nào cũng được
    3. C.Agent như một đồng nghiệp có vai trò
    4. D.Tự host hoặc dùng Switch Cloud
    5. E.Quản trị và kiểm soát
    6. F.Bốn mức dùng, từ nhẹ đến sâu
  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.Chọn Switch Cloud hay server riêng
    4. D.Nói chuyện với switch-buddy
    5. E.Tuỳ chọn: cho agent của bạn đọc tài liệu Switch qua MCP
    6. F.Tự host server (nâng cao)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Làm việc chung với agent coding trong một kênh
    2. B.Một agent chuyên về một mảng hệ thống
    3. C.Kênh tiếp nhận yêu cầu và báo lỗi
    4. D.Hỗ trợ xử lý sự cố ngay trong chat
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Tải nhầm bản cài cho máy
    2. B.Console báo lỗi liên quan đến Docker
    3. C.Agent không thấy trong kênh chat
    4. D.Agent không dùng được connector
    5. E.Lộ khoá khi tự host
  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ỏ.