Lark CLI: Hướng dẫn tích hợp AI Agents vào Lark
Tìm hiểu Lark CLI, Lark Skills và cách cài đặt, xác thực, cấp quyền để AI Agent thao tác với Docs, Calendar, Base, Tasks cùng các công cụ Lark.
Mục lục
Một AI Agent có thể phân tích yêu cầu, lập kế hoạch và tạo nội dung. Tuy nhiên, để trực tiếp kiểm tra lịch, đọc tài liệu, cập nhật dữ liệu hoặc tạo nhiệm vụ trên Lark, agent cần thêm công cụ thực thi và hướng dẫn sử dụng công cụ đúng cách.
Lark CLI cung cấp giao diện dòng lệnh để AI Agent tương tác với các dịch vụ trên Lark. Lark Skills giúp agent hiểu nên dùng nhóm lệnh nào, cần đọc tài liệu gì và phải tuân thủ nguyên tắc an toàn nào trước khi hành động. Bài viết này hướng dẫn toàn bộ quy trình từ cài đặt, cấu hình, xác thực đến thực hiện tác vụ đầu tiên, đồng thời làm rõ những điểm cần kiểm soát khi đưa AI Agent vào môi trường làm việc của doanh nghiệp.
Lark CLI là gì?
Lark CLI là công cụ dòng lệnh mã nguồn mở chính thức do đội ngũ Lark phát triển và duy trì. Công cụ được thiết kế cho cả con người lẫn AI Agent, cho phép tương tác với nhiều miền nghiệp vụ trên Lark thông qua câu lệnh có cấu trúc.
Tùy theo quyền được cấp, Lark CLI có thể hỗ trợ các nhóm tác vụ như:
-
Đọc, gửi và tìm kiếm tin nhắn trên Lark Messenger.
-
Tạo, đọc và cập nhật Lark Docs.
-
Quản lý tệp, thư mục, quyền và bình luận trên Lark Drive.
-
Truy vấn hoặc cập nhật dữ liệu trong Lark Base và Lark Sheets.
-
Kiểm tra lịch, tạo sự kiện và tìm thời gian họp phù hợp.
-
Tạo, cập nhật và theo dõi nhiệm vụ.
-
Thao tác với Wiki, Mail, Minutes, Approval, OKR và các dịch vụ liên quan.
-
Gọi trực tiếp các endpoint của Lark Open Platform khi chưa có lệnh dựng sẵn.
Danh sách khả năng hiện hành được công bố tại repository chính thức của Lark CLI. Do công cụ được cập nhật thường xuyên, số lượng lệnh, Skills và miền nghiệp vụ có thể thay đổi theo phiên bản.
Về mặt vận hành, Lark CLI đóng vai trò như “đôi tay” của AI Agent. Agent tiếp nhận mục tiêu bằng ngôn ngữ tự nhiên, chọn công cụ phù hợp, gọi câu lệnh và sử dụng kết quả trả về để hoàn thành công việc.
Cách triển khai này đặc biệt phù hợp khi doanh nghiệp đã tổ chức giao tiếp, tài liệu, lịch, nhiệm vụ và dữ liệu trên một nền tảng làm việc số hợp nhất. Agent có thể làm việc gần hơn với dữ liệu vận hành thay vì xử lý thông tin trong một cửa sổ chat tách biệt.
Lark Skills là gì?
Lark Skills là các gói hướng dẫn chuyên biệt giúp AI Agent sử dụng Lark CLI theo đúng miền nghiệp vụ.
Mỗi Skill thường xác định:
-
Khi nào Skill cần được kích hoạt.
-
Những tác vụ nằm trong phạm vi xử lý.
-
Những tác vụ phải chuyển sang Skill khác.
-
Câu lệnh hoặc tài liệu tham chiếu cần đọc.
-
Cách lựa chọn danh tính người dùng hoặc bot.
-
Quy tắc về phân quyền, xác nhận và thao tác có rủi ro.
-
Cách xử lý lỗi hoặc trường hợp thiếu quyền.
Ví dụ, khi nhận yêu cầu kiểm tra lịch làm việc, agent có thể kích hoạt
lark-calendar. Với yêu cầu tạo tài liệu, agent chuyển sang lark-doc. Nếu công việc liên quan Lark Base, lark-base cung cấp hướng dẫn phù hợp với bảng, trường dữ liệu, bản ghi, view và workflow.Một số Lark Skills thường gặp gồm:
| Skill | Phạm vi sử dụng tiêu biểu |
| lark-shared | Cấu hình, đăng nhập, danh tính, quyền và quy tắc an toàn dùng chung |
| lark-calendar | Lịch, sự kiện, lịch trống, phòng họp và người tham dự |
| lark-im | Tin nhắn, nhóm chat, tệp, hình ảnh và tương tác trong Messenger |
| lark-doc | Tạo, đọc, cập nhật và tìm kiếm tài liệu |
| lark-drive | Tệp, thư mục, quyền truy cập và bình luận |
| lark-base | Bảng, trường, bản ghi, view, dashboard và workflow |
| lark-sheets | Đọc, ghi, tìm kiếm và xuất dữ liệu bảng tính |
| lark-task | Nhiệm vụ, danh sách việc, nhiệm vụ con và nhắc hạn |
| lark-wiki | Không gian tri thức, node và tài liệu Wiki |
| lark-openapi-explorer | Tìm API chính thức khi chức năng cần dùng chưa được CLI đóng gói |
Skill không trực tiếp thực hiện công việc. Nội dung Skill hướng dẫn agent cách sử dụng công cụ, còn Lark CLI gửi yêu cầu tới Lark và nhận kết quả trả về.
Cơ chế này giúp giảm tình trạng agent tự đoán tên lệnh, tham số hoặc phạm vi quyền. Đây là yếu tố quan trọng khi AI được kết nối với dữ liệu và quy trình thật. Việc xây dựng môi trường cho AI Agent với Lark vì thế cần đồng thời quan tâm tới công cụ, dữ liệu, Skills, quyền truy cập và điểm kiểm duyệt của con người.
AI Agent có thể làm gì với Lark CLI?
Khả năng của agent phụ thuộc vào Lark Skills đã cài, quyền được cấp và cách doanh nghiệp thiết kế luồng công việc. Một số hướng ứng dụng thực tế gồm:
Tổng hợp lịch và nhiệm vụ trong ngày
Agent có thể kiểm tra lịch, lấy danh sách nhiệm vụ chưa hoàn thành, sắp xếp theo thời gian hoặc mức độ ưu tiên rồi tạo bản tóm tắt đầu ngày.
Nếu được thiết kế thêm bước xác nhận, agent có thể hỗ trợ đề xuất thời gian họp, tạo sự kiện hoặc gửi lời mời tới người liên quan.
Chuẩn bị và cập nhật tài liệu
Agent có thể đọc tài liệu đầu vào, tạo bản nháp báo cáo, cập nhật nội dung vào Lark Docs hoặc sắp xếp tài liệu trong Drive và Wiki.
Với các tổ chức đã chuẩn hóa tri thức trên Lark, agent có thể tham chiếu tài liệu phù hợp với quyền truy cập. Những bài toán tập trung vào hỏi đáp và khai thác kho tri thức cũng có thể tham khảo Lark Knowledge AI.
Theo dõi dữ liệu vận hành trên Lark Base
Agent có thể đọc trạng thái dự án, yêu cầu nội bộ, cơ hội bán hàng hoặc dữ liệu tuyển dụng được lưu trong Lark Base. Sau đó, agent tổng hợp bản ghi, phát hiện thông tin còn thiếu hoặc chuẩn bị đề xuất xử lý.
Các thao tác ghi dữ liệu cần được giới hạn rõ. Ví dụ, agent có thể chuẩn bị nội dung cập nhật và chờ người phụ trách xác nhận trước khi ghi vào bảng.
Chuyển thông tin thành công việc
Một cuộc trao đổi trong Messenger có thể chứa quyết định, deadline và người phụ trách. Agent có thể tóm tắt nội dung, tạo danh sách đầu việc hoặc chuẩn bị nhiệm vụ trên Lark Task.
Trong tình huống này, giá trị của agent nằm ở việc duy trì mạch thông tin từ trao đổi sang hành động, hạn chế bỏ sót đầu việc sau cuộc họp hoặc thảo luận liên phòng ban.
Kết nối Lark với hệ thống khác
Khi cần tích hợp CRM, ERP, HRM hoặc ứng dụng nội bộ, Lark CLI có thể kết hợp với khả năng mở của Lark Open Platform. Agent từ đó có thêm công cụ để tham gia vào quy trình liên hệ thống, trong phạm vi ứng dụng và quyền đã được cấu hình.
Hướng dẫn cài đặt Lark CLI và Lark Skills cho AI Agent
Lark thiết kế quy trình cài đặt để AI Agent có thể hỗ trợ phần lớn các bước. Thay vì tự nhập và xử lý từng câu lệnh, người dùng có thể gửi một yêu cầu hoàn chỉnh cho Codex, Claude Code, Cursor, Trae hoặc công cụ AI Agent tương thích.
Bước 1: Gửi yêu cầu cài đặt cho AI Agent
Sao chép toàn bộ nội dung sau và gửi cho AI Agent:
Hãy cài đặt Lark CLI bằng lệnh: npm install -g @larksuite/cli Sau đó cài đặt các Lark Skills liên quan bằng lệnh: npx skills add https://github.com/larksuite/cli -y -g Sau khi cài đặt xong, hãy gửi cho tôi đường dẫn cấu hình ứng dụng và hướng dẫn tôi hoàn tất từng bước.Agent sẽ thực hiện hai công việc:
-
Cài đặt Lark CLI ở phạm vi toàn cục.
-
Cài bộ Lark Skills để nhận diện và xử lý các tác vụ liên quan Lark.
Lark CLI cần Node.js cùng
npm hoặc npx trên máy. Nếu hệ thống chưa có các thành phần này, agent có thể yêu cầu cài đặt trước khi tiếp tục.Bước 2: Hoàn tất cấu hình ứng dụng Lark
Sau khi cài đặt, agent sẽ bắt đầu quá trình cấu hình ứng dụng và trả về một đường dẫn. Mở đường dẫn đó trên trình duyệt, đăng nhập Lark và hoàn tất các bước được hiển thị.
Có thể chủ động bắt đầu quá trình cấu hình bằng lệnh:
lark-cli config initỞ bước này, cần lưu ý:
-
Giữ nguyên đường dẫn cấu hình do CLI tạo ra.
-
Không sao chép App Secret, access token hoặc thông tin xác thực vào tài liệu dùng chung.
-
Chỉ cấp những quyền phù hợp với công việc dự kiến giao cho agent.
-
Kiểm tra kỹ danh tính và phạm vi ứng dụng trước khi xác nhận.
Sau khi cấu hình hoàn tất, khởi động lại công cụ AI Agent. Việc khởi động lại giúp Codex, Claude Code, Cursor, Trae hoặc môi trường tương ứng nạp đầy đủ danh sách Lark Skills vừa cài.
Bước 3: Chọn chế độ sử dụng Lark CLI
Lark CLI hỗ trợ hai cách sử dụng, tùy loại dữ liệu và tác vụ mà agent cần xử lý.
Cách 1: Sử dụng mà chưa cấp quyền truy cập dữ liệu cá nhân
Agent vẫn có thể sử dụng các khả năng của ứng dụng hoặc bot đã được cấu hình, chẳng hạn tạo tài liệu hoặc gửi tin nhắn trong phạm vi được cấp.
Ở chế độ này, agent không thể truy cập dữ liệu cá nhân như:
-
Lịch cá nhân.
-
Tin nhắn cá nhân.
-
Hộp thư.
-
Tài liệu và tài nguyên riêng chưa được chia sẻ.
-
Các dữ liệu chỉ khả dụng dưới danh tính người dùng.
Cách này phù hợp để thử nghiệm các tác vụ ứng dụng hoặc bot trước khi mở quyền truy cập sâu hơn.
Cách 2: Cho phép agent hoạt động dưới danh tính người dùng
Khi agent cần kiểm tra lịch, đọc tin nhắn, truy cập tài liệu cá nhân hoặc thực hiện tác vụ thay mặt người dùng, cần hoàn tất bước cấp quyền một lần.
Chạy lệnh:
lark-cli auth loginLark CLI sẽ trả về đường dẫn xác thực. Mở đường dẫn, đăng nhập Lark và xác nhận phạm vi quyền.
Sau khi hoàn tất, kiểm tra trạng thái bằng:
lark-cli auth statusNếu chưa đăng nhập từ đầu, Lark CLI cũng có thể yêu cầu xác thực vào thời điểm agent cần truy cập dữ liệu cá nhân.
Bước 4: Chỉ cấp quyền cho miền nghiệp vụ cần sử dụng
Với agent có phạm vi công việc cụ thể, nên giới hạn quyền theo từng domain thay vì cấp quyền rộng ngay từ đầu.
Ví dụ, agent chỉ phụ trách Calendar và Task có thể đăng nhập với phạm vi:
lark-cli auth login --domain calendar,taskKhi một câu lệnh cần thêm quyền, Lark CLI sẽ trả thông tin về scope còn thiếu. Có thể kiểm tra quyền hiện tại bằng:
lark-cli auth checkNếu cần cấp chính xác một scope được thông báo trong lỗi:
lark-cli auth login --scope "<missing_scope>"Với tác vụ chạy dưới danh tính ứng dụng hoặc bot, quyền tương ứng còn phải được bật trong Lark Developer Console.
Bước 5: Kiểm tra Lark Skills đã được nạp
Sau khi khởi động lại AI Agent, chạy:
lark-cli skills listLệnh này hiển thị danh sách Lark Skills đi kèm CLI. Để đọc hướng dẫn của một Skill cụ thể, sử dụng:
lark-cli skills read lark-calendarHoặc:
lark-cli skills read lark-docAgent cần đọc Skill phù hợp trước khi thực hiện tác vụ. Ví dụ:
-
Kiểm tra lịch:
lark-calendar. -
Tạo hoặc sửa tài liệu:
lark-doc. -
Làm việc với bảng dữ liệu:
lark-base. -
Tạo và cập nhật nhiệm vụ:
lark-task. -
Xử lý cấu hình, danh tính và quyền:
lark-shared.
Bước 6: Thử một yêu cầu bằng ngôn ngữ tự nhiên
Sau khi cài đặt và xác thực, có thể gửi yêu cầu trực tiếp cho agent:
Kiểm tra lịch làm việc hôm nay và tóm tắt các cuộc họp theo thứ tự thời gian.Agent sẽ nhận diện
lark-calendar, đọc hướng dẫn của Skill và gọi câu lệnh phù hợp. Lệnh cơ bản để xem lịch là:lark-cli calendar +agendaNên bắt đầu bằng một tác vụ chỉ đọc như kiểm tra lịch. Sau khi xác minh danh tính, quyền truy cập và chất lượng kết quả, phạm vi có thể mở rộng sang tạo tài liệu, cập nhật dữ liệu hoặc gửi tin nhắn.
Các lệnh cấu hình và xác thực thường dùng
| Nhu cầu | Câu lệnh |
| Xem tổng quan câu lệnh | lark-cli help |
| Khởi tạo cấu hình ứng dụng | lark-cli config init |
| Đăng nhập dưới danh tính người dùng | lark-cli auth login |
| Kiểm tra trạng thái đăng nhập | lark-cli auth status |
| Xin quyền theo domain | lark-cli auth login --domain <domain> |
| Kiểm tra quyền hiện tại | lark-cli auth check |
| Đăng xuất | lark-cli auth logout |
Nếu đang sử dụng plugin Lark chính thức trong OpenClaw, có thể không cần cài Lark CLI riêng. Plugin này sử dụng Lark CLI ở lớp bên dưới; phạm vi khả dụng phụ thuộc phiên bản plugin và cấu hình hiện tại.
Câu hỏi thường gặp về Lark CLI và Lark Skills
Lark CLI có phải công cụ chính thức của Lark không?
Có. Lark CLI là công cụ mã nguồn mở được duy trì trong repository chính thức của đội ngũ Lark. Công cụ phục vụ cả người dùng kỹ thuật và AI Agent.
Có cần biết lập trình để sử dụng Lark CLI không?
Người dùng cần quen với terminal và câu lệnh cơ bản để cài đặt, kiểm tra và xử lý lỗi. Khi Lark Skills được cấu hình đúng, AI Agent có thể hỗ trợ phần lớn quá trình lựa chọn và gọi lệnh. Bộ phận IT vẫn cần tham gia khi triển khai quyền, ứng dụng hoặc tích hợp hệ thống.
Lark Skills có thay thế Lark CLI không?
Không. Skills cung cấp hướng dẫn cho agent, còn Lark CLI thực hiện thao tác. Hai thành phần bổ trợ cho nhau.
Lark CLI có thể sử dụng với những AI Agent nào?
Lark CLI được thiết kế để làm việc với các agent có khả năng gọi lệnh và đọc Skill, gồm nhiều môi trường AI coding agent hoặc agent chạy cục bộ. Khả năng tích hợp cụ thể phụ thuộc vào cách nền tảng đó nạp Skills, quản lý terminal và yêu cầu xác nhận.
Nên cho AI Agent hoạt động dưới quyền người dùng hay bot?
Danh tính người dùng phù hợp với trợ lý cá nhân cần truy cập lịch, tài liệu hoặc dữ liệu của chính người đó. Bot phù hợp hơn với tác vụ ứng dụng hoặc hỗ trợ nhóm trong phạm vi tài nguyên được cấp. Quyết định cần dựa trên đối tượng sử dụng, dữ liệu và rủi ro của từng luồng công việc.
Lark CLI có an toàn để sử dụng trong doanh nghiệp không?
Công cụ có các biện pháp kiểm soát, nhưng mức độ an toàn còn phụ thuộc vào phạm vi quyền, danh tính, dữ liệu, cách agent tiếp nhận yêu cầu và cơ chế xác nhận của con người. Nên bắt đầu bằng tác vụ chỉ đọc, quyền tối thiểu và một phạm vi thử nghiệm nhỏ.
Tổng kết
Lark CLI cung cấp công cụ thực thi để AI Agent tương tác với lịch, tài liệu, dữ liệu, tin nhắn và các dịch vụ khác trên Lark. Lark Skills giúp agent chọn đúng nhóm công cụ, đọc đúng hướng dẫn và tuân thủ các nguyên tắc an toàn trước khi hành động.
Quy trình phù hợp nên bắt đầu từ một tác vụ chỉ đọc, cài đặt và xác thực đúng danh tính, giới hạn quyền theo nhu cầu, sau đó mới mở rộng sang thao tác tạo hoặc cập nhật dữ liệu. Khi được đặt trong một môi trường có dữ liệu rõ, quy trình rõ và người chịu trách nhiệm rõ, Lark CLI có thể trở thành cầu nối thực tế giữa AI Agent và công việc hằng ngày trên Lark.
Rikkei Digital là đối tác chính thức đầu tiên và Platinum Partner của Lark Suite tại Việt Nam, cung cấp dịch vụ tư vấn, triển khai, tích hợp, đào tạo và hỗ trợ doanh nghiệp ứng dụng Lark Suite vào vận hành. Với nhu cầu đưa AI Agent vào Lark, Rikkei Digital có thể hỗ trợ đánh giá bài toán, thiết kế phạm vi quyền, tích hợp hệ thống và xây dựng lộ trình thử nghiệm sát với dữ liệu, quy trình cùng yêu cầu bảo mật thực tế.
Doanh nghiệp có thể để lại thông tin tại form bên dưới để nhận tư vấn về lộ trình triển khai Lark và AI Agent phù hợp.
