Google Workspace CLI (gws): Công cụ dòng lệnh thống nhất cho toàn bộ Google Workspace với tích hợp AI agent

Tóm tắt nhanh

• Google Workspace CLI (gws) là một công cụ dòng lệnh duy nhất quản lý Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin và mọi dịch vụ Google Workspace khác.
• Công cụ được xây dựng động từ Google Discovery Service nên tự động cập nhật khi Google thay đổi API mà không cần nâng cấp thủ công.
• Hỗ trợ hơn 100 AI agent skills, MCP server và tích hợp trực tiếp với Gemini CLI, giúp xây dựng automation thông minh cho LLM.
• Cài đặt chỉ một lệnh npm, output luôn là JSON có cấu trúc, hỗ trợ multi-account, dry-run và pagination tự động.
• Lý tưởng cho developer, quản trị viên hệ thống và người dùng muốn tự động hóa workflow mà không cần mở nhiều ứng dụng web.

Google Workspace CLI là gì?

Google Workspace CLI, thường được gọi tắt là gws, là công cụ dòng lệnh mã nguồn mở giúp tương tác với toàn bộ hệ sinh thái Google Workspace chỉ qua terminal. Không giống các công cụ riêng lẻ trước đây, gws thống nhất mọi dịch vụ như Drive, Gmail, Calendar, Sheets, Docs, Chat và Admin vào một giao diện duy nhất.

Điểm nổi bật nhất là cơ chế xây dựng động từ Google Discovery Service. Thay vì hard-code danh sách lệnh, gws đọc tài liệu Discovery của Google tại thời điểm chạy, tự động tạo ra toàn bộ cây lệnh. Nhờ đó, bất kỳ cập nhật API mới nào từ Google đều được hỗ trợ ngay lập tức mà người dùng không phải chờ bản cập nhật của CLI. Đây là lợi thế lớn so với các công cụ truyền thống có thể lỗi thời chỉ sau vài tháng.

Công cụ được viết bằng Rust, đảm bảo tốc độ cao và bảo mật tốt. Output luôn ở định dạng JSON có cấu trúc, rất phù hợp cho scripting, pipeline CI/CD và đặc biệt là tích hợp với các mô hình AI. Hiện tại phiên bản mới nhất là 0.4.4 (tháng 3/2026), nhưng nhờ tính năng dynamic, phiên bản không phải là yếu tố quyết định. Google Workspace CLI không phải sản phẩm chính thức của Google nhưng được phát triển bởi tổ chức googleworkspace trên GitHub và tuân thủ giấy phép Apache 2.0.

Lợi ích nổi bật khi sử dụng Google Workspace CLI

Sử dụng gws mang lại nhiều lợi ích thiết thực cho cả người dùng cá nhân và doanh nghiệp. Trước hết là sự tiện lợi: thay vì mở nhiều tab trình duyệt hoặc cài đặt nhiều CLI riêng, bạn chỉ cần một lệnh duy nhất để thực hiện mọi thao tác. Ví dụ, bạn có thể liệt kê file trên Drive, gửi email qua Gmail, tạo sự kiện Calendar hay cập nhật dữ liệu Sheets chỉ trong vài giây.

Thứ hai, tính tương thích với AI agent là điểm mạnh lớn nhất năm 2026. Với hơn 100 kỹ năng agent (agent skills) được đóng gói dưới dạng SKILL.md, gws biến terminal thành công cụ mạnh mẽ cho các mô hình ngôn ngữ lớn. Bạn có thể kết nối trực tiếp với Gemini CLI, Claude hoặc bất kỳ LLM nào hỗ trợ Model Context Protocol (MCP). Điều này mở ra khả năng tự động hóa thông minh như: AI tự động phân loại email, tạo báo cáo Sheets từ dữ liệu Drive, hoặc gửi thông báo Chat khi có file mới.

Thứ ba, bảo mật và linh hoạt cao. Thông tin xác thực được mã hóa AES-256-GCM bằng keyring hệ thống. Hỗ trợ nhiều tài khoản, service account, impersonation và xuất token cho môi trường headless. Các tính năng nâng cao như dry-run (xem trước lệnh mà không thực thi), auto-pagination và schema introspection giúp developer kiểm soát chính xác mọi yêu cầu API.

Cuối cùng, gws tiết kiệm thời gian đáng kể. Nhiều quản trị viên hệ thống và developer báo cáo giảm từ hàng giờ xuống chỉ vài phút cho các tác vụ lặp lại như quản lý user Admin Directory hay xử lý hàng loạt file Drive.

Yêu cầu hệ thống trước khi cài đặt

Trước khi bắt đầu, bạn cần chuẩn bị một số điều kiện cơ bản để Google Workspace CLI hoạt động mượt mà. Đầu tiên là Node.js phiên bản 18 trở lên nếu cài qua npm (cách khuyến nghị). Nếu bạn thích binary native, chỉ cần tải về mà không cần Node.js.

Bạn cũng cần một tài khoản Google Workspace hoặc Google thông thường có quyền truy cập các dịch vụ cần dùng. Đối với xác thực OAuth, nên chuẩn bị Google Cloud project (công cụ gws auth setup sẽ tự tạo nếu bạn có gcloud CLI). Ngoài ra, nên cài gcloud SDK để quá trình setup diễn ra nhanh chóng. Không có yêu cầu phần cứng đặc biệt vì gws chạy nhẹ trên mọi nền tảng Windows, macOS và Linux.

Các cách cài đặt Google Workspace CLI chi tiết

Cài đặt Google Workspace CLI cực kỳ đơn giản và có nhiều lựa chọn phù hợp với môi trường của bạn.

Cách nhanh nhất và được khuyến nghị là sử dụng npm:

npm install -g @googleworkspace/cli

Lệnh này sẽ tải bản binary native phù hợp với hệ điều hành và kiến trúc máy của bạn, không yêu cầu Rust compiler.

Nếu bạn dùng Homebrew trên macOS hoặc Linux, có thể cài qua tap chính thức:

brew install googleworkspace/tap/gws

Người dùng Rust có thể build trực tiếp từ source:

cargo install --git https://github.com/googleworkspace/cli --locked

Ngoài ra, bạn có thể tải binary sẵn từ trang Releases trên GitHub hoặc dùng Nix flake cho môi trường reproducible. Sau khi cài, kiểm tra bằng lệnh:

gws --help

Nếu thấy danh sách tùy chọn, bạn đã cài đặt thành công.

Thiết lập xác thực và quản lý nhiều tài khoản

Xác thực là bước quan trọng nhất. Chạy lệnh một lần duy nhất:

gws auth setup

Công cụ sẽ tự động tạo Google Cloud project, kích hoạt các API cần thiết và hướng dẫn bạn thiết lập OAuth consent screen. Sau đó đăng nhập:

gws auth login

Bạn sẽ được chuyển hướng đến trình duyệt để cấp quyền. Thông tin xác thực được lưu an toàn trong thư mục ~/.config/gws/.

Để chuyển đổi giữa nhiều tài khoản, dùng cờ --account:

gws --account [email protected] drive files list

Hoặc thiết lập biến môi trường GOOGLE_WORKSPACE_CLI_ACCOUNT. Với môi trường CI/CD hoặc server headless, xuất token bằng:

gws auth export --unmasked > credentials.json

và sau đó thiết lập biến GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE.

Hướng dẫn sử dụng cơ bản các lệnh Google Workspace CLI

Cấu trúc lệnh của gws rất trực quan: gws [options]. Ví dụ liệt kê 5 file gần đây trên Drive:

gws drive files list --params '{"pageSize": 5}'

Tạo spreadsheet mới trên Sheets:

gws sheets spreadsheets create --json '{"properties": {"title": "Ngân sách Q1"}}'

Gửi tin nhắn Chat với dry-run để kiểm tra trước:

gws chat spaces messages create --params '{"parent": "spaces/abc"}' --json '{"text": "Hoàn tất triển khai"}' --dry-run

Để xem schema yêu cầu của bất kỳ phương thức nào:

gws schema drive.files.list

Tính năng –page-all cho phép stream toàn bộ kết quả dưới dạng NDJSON, rất hữu ích khi xử lý dữ liệu lớn:

gws drive files list --page-all | jq -r '.files[].name'

Bạn có thể kết hợp với jq để xử lý JSON một cách mạnh mẽ.

Tích hợp AI agent skills và MCP server

Đây là phần làm nên sức hút lớn của Google Workspace CLI năm 2026. Để cài đặt bộ kỹ năng agent:

npx skills add https://github.com/googleworkspace/cli

Hoặc chỉ cài kỹ năng cụ thể cho Drive:

npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive

Các kỹ năng này tương thích hoàn hảo với OpenClaw và có thể symlink vào thư mục agent.

Để biến gws thành công cụ cho bất kỳ LLM nào, khởi động MCP server:

gws mcp -s drive,gmail,calendar

Sau đó cấu hình trong client (Claude Desktop, Cursor, VS Code…) bằng đoạn JSON đơn giản. Bạn cũng có thể cài extension trực tiếp cho Gemini CLI:

gemini extensions install https://github.com/googleworkspace/cli

Kết quả là AI agent của bạn có thể tự động đọc Gmail, tạo file Docs, cập nhật Calendar hoặc quản lý user Admin mà không cần code phức tạp.

Tính năng nâng cao và tối ưu hiệu suất

Ngoài các lệnh cơ bản, gws cung cấp nhiều tùy chọn chuyên sâu. Upload file multipart:

gws drive files create --json '{"name": "bao-cao.pdf"}' --upload ./bao-cao.pdf

Sử dụng Model Armor để lọc nội dung nhạy cảm:

gws gmail users messages get --sanitize "projects/my-project/locations/global/templates/default"

Các cờ pagination --page-limit, --page-delay giúp kiểm soát tốc độ khi làm việc với dữ liệu lớn. Chế độ --verbose hiển thị chi tiết request/response để debug dễ dàng.

Mẹo sử dụng và khắc phục sự cố phổ biến

Một số mẹo thực tế: luôn dùng –dry-run khi thử nghiệm lệnh mới. Nếu gặp lỗi 403, thêm tài khoản test vào OAuth consent screen. Với lỗi “Google hasn’t verified this app”, chọn Advanced > Go to gws (unsafe) là bình thường trong giai đoạn phát triển. Khi API chưa kích hoạt, gws sẽ đưa ra link enable_url trực tiếp trong thông báo lỗi.

Để tăng tốc, đặt biến môi trường GOOGLE_WORKSPACE_CLI_TOKEN khi chạy trong container hoặc server. Luôn cập nhật gws định kỳ dù cơ chế dynamic đã giảm thiểu rủi ro.

Google Workspace CLI (gws) không chỉ là một công cụ dòng lệnh mà còn là cầu nối mạnh mẽ giữa con người, script và AI agent trong hệ sinh thái Google Workspace. Với khả năng dynamic, JSON output sạch sẽ, tích hợp sâu AI và cài đặt cực kỳ đơn giản, gws đang trở thành lựa chọn hàng đầu cho developer, quản trị viên và bất kỳ ai muốn tự động hóa công việc văn phòng.

Bạn có thể bắt đầu ngay hôm nay bằng lệnh npm install -g @googleworkspace/cli và khám phá toàn bộ tiềm năng của Google Workspace qua terminal. Tham khảo repository chính thức https://github.com/googleworkspace/cli để cập nhật kỹ năng agent mới nhất và đóng góp vào dự án open source này. Google Workspace CLI đang định hình lại cách chúng ta tương tác với công cụ làm việc hàng ngày – hiệu quả hơn, nhanh hơn và thông minh hơn bao giờ hết.