KiroCrew: workspace AI bền bỉ cho lập trình — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về kirodotdev/KiroCrew — 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: KiroCrew: không gian làm việc AI chạy liên tục, tự học — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Kiro Crew là workspace phát triển phần mềm mã nguồn mở, giúp agent AI chạy liên tục, lưu phiên làm việc, lập lịch và tự cải thiện. Bạn có thể dùng ứng dụng desktop, dashboard web, CLI hoặc kênh nhắn tin. Cài bằng app, Docker, script một dòng hoặc build từ source; cách build cần Python 3.12+, Node.js 22.12+ và npm.
Kiro Crew là một workspace phát triển phần mềm dùng agent AI, có thể chạy liên tục trên máy của bạn hoặc một máy chủ từ xa. Nó giữ lại phiên làm việc, bộ nhớ, lịch chạy và checkpoint để công việc không kết thúc ngay khi bạn đóng cửa sổ chat.
Repo này phù hợp với lập trình viên, nhóm kỹ thuật và người muốn giao cho AI các tác vụ nhiều bước. Điểm đáng giá nhất là agent không chỉ trả lời một lần: nó có thể tiếp tục công việc, tự kiểm tra, thử lại khi lỗi, chạy theo lịch và biến những bài học lặp lại thành memory hoặc skill dùng về sau. Repo hiện có khoảng 4928 sao và 1030 fork, dùng giấy phép Apache-2.0.
kirodotdev/KiroCrew
Kiro Crew là workspace AI chạy liên tục, ghi nhớ công việc, tự học và tiếp tục tác vụ qua nhiều phiên.
I.Kiro Crew làm được gì
Giữ phiên làm việc lâu dài: Các cuộc trò chuyện có thể chạy song song, tách biệt và tiếp tục sau khi Gateway khởi động lại. Bạn có thể tìm lại phiên cũ và mang ngữ cảnh gần đây sang công việc mới.
Lưu bài học từ phản hồi và lỗi: Khi bạn sửa cách agent làm việc hoặc một tác vụ thất bại, Kiro Crew có thể biến điều đó thành bài học bền vững. Bài học có thể áp dụng cho toàn bộ workspace hoặc giới hạn trong một repo cụ thể.
Tạo skill dùng lại: Những quy trình lặp lại có thể được tổng hợp thành skill. Bạn vẫn có thể xem, chỉnh sửa hoặc xóa skill khi cách làm việc thay đổi.
Chạy tác vụ dài và có checkpoint: Bạn có thể đưa một kế hoạch migration hoặc một yêu cầu nhiều bước. Agent sẽ lập kế hoạch, thực hiện, kiểm tra kết quả, thử lại khi cần và tiếp tục từ checkpoint nếu bị gián đoạn.
Tự động hóa theo lịch: Một công việc có thể chạy theo lịch hoặc chạy bằng script, không nhất thiết lần nào cũng gọi model. Ví dụ, bạn có thể yêu cầu hệ thống mỗi ngày làm việc tổng hợp các việc mở cần xem xét.
Theo dõi hệ thống bằng heartbeat: Kiro Crew có thể tiếp tục giám sát cho đến khi cần bạn chú ý. Các sự kiện từ kênh nhắn tin hoặc webhook đã xác thực cũng có thể kích hoạt công việc.
Chia việc cho subagent: Agent chính có thể tạo các subagent tách biệt để nghiên cứu song song, sau đó đưa kết quả về và tổng hợp thành một câu trả lời.
Dùng từ nhiều giao diện: Bạn có thể làm việc trong app desktop, dashboard web, CLI hoặc các kênh kết nối như Slack và Discord. Agent runtime và trạng thái công việc vẫn nằm ở Gateway host.
Mở rộng bằng App, MCP và hook: Kiro Crew hỗ trợ các giao diện chuyên biệt, MCP server, skill dạng Markdown và hook. Bạn có thể thêm công cụ mà không phải sửa runtime lõi.
Quan sát được quá trình chạy: Dashboard cho xem tool call, tiến độ subagent, mức dùng context, yêu cầu phê duyệt, lịch, memory và log. Điều này hữu ích khi agent chạy lâu hoặc thực hiện thay đổi quan trọng.
Có nhiều lớp kiểm soát: Hệ thống kết hợp phê duyệt tool, sandbox của hệ điều hành khi có thể, kiểm tra đường dẫn nhạy cảm, che giấu thông tin xác thực, luật từ chối thao tác và audit event.
Phân tích ảnh chụp màn hình: Bạn có thể dán screenshot và hỏi nguyên nhân lỗi. Ảnh được gửi tới model Kiro đang hoạt động và giữ trong lịch sử cuộc trò chuyện.
II.Cần chuẩn bị gì
Nếu dùng app desktop, README cung cấp bản cho macOS, Windows và Linux. Windows có bộ cài native; Linux có các gói .deb, .rpm và AppImage cho x86_64 hoặc aarch64. Stable là kênh mặc định; Insider và Nightly dành cho người cần kênh phát hành khác.
Nếu build từ source trên macOS hoặc Linux, bạn cần Python 3.12 trở lên, Node.js 22.12 trở lên và npm. README khuyến nghị Node.js 24 LTS. Repo có khai báo gói Python tên kirocrew và yêu cầu Python tối thiểu 3.12.
Backend ACP mặc định cần kiro-cli. Bạn phải cài kiro-cli trên máy Gateway và chạy kiro-cli login trước khi dùng backend này. Các harness ACP khác có yêu cầu riêng trong install guide; README được cung cấp chưa liệt kê chi tiết các yêu cầu đó.
Bạn có thể chạy Kiro Crew cục bộ, trong container Docker hoặc trên máy từ xa do bạn kiểm soát. Với Docker, cần có Docker và dùng image public đa kiến trúc của dự án. README không nêu yêu cầu GPU, vì vậy không nên tự giả định rằng GPU là bắt buộc hoặc được hỗ trợ.
Kiro Crew không có hệ thống tài khoản riêng. Việc đăng nhập của kiro-cli dùng cho quyền truy cập model và README nói rõ thông tin đăng nhập đó không được Kiro Crew đọc hoặc gửi trong telemetry.
Kiro Crew có thể chạy tác vụ tự động và kết nối với công cụ bên ngoài. Hãy kiểm tra approval, quyền truy cập, đường dẫn nhạy cảm và credential trước khi giao việc dài hạn. Telemetry ẩn danh được bật mặc định nhưng có thể tắt trong Privacy hoặc bằng lệnh được README cung cấp.
III.Cài đặt từng bước
- Chọn cách chạyDùng app, script một dòng, Docker hoặc build từ source
- Chuẩn bị môi trườngCài Python, Node.js, npm và kiro-cli nếu build source
- Cài Kiro CrewChạy script, Docker hoặc các lệnh build tương ứng
- Khởi tạo cấu hìnhChạy setup để tạo cấu hình ban đầu
- Kiểm tra hệ thốngChạy doctor để phát hiện thiếu phụ thuộc hoặc lỗi cấu hình
- Khởi động GatewayChạy gateway rồi mở dashboard hoặc dùng CLI
A.Chọn cách cài phù hợp
Nếu bạn chỉ muốn dùng nhanh, app desktop hoặc script một dòng là hai lựa chọn đơn giản. App tự cập nhật theo kênh đã chọn. Script một dòng cài signed Stable wheel mà không cần clone repo hoặc build frontend.
Nếu cần chạy liên tục trên máy chủ, Docker phù hợp hơn. Nếu muốn sửa mã nguồn, phát triển tính năng hoặc kiểm soát môi trường Python, hãy build từ source.
README nói Windows được hỗ trợ bằng native source install và yêu cầu làm theo Windows guide thay vì các bước shell bên dưới. Vì tư liệu được cung cấp không chép nội dung Windows guide, bài này không tự thêm lệnh PowerShell ngoài những gì README đã ghi.
B.Cài bằng script một dòng
Mở terminal trên máy cần chạy Kiro Crew rồi chạy đúng lệnh sau:
curl -fsSL https://download.crew.kiro.dev/cli.sh | shLệnh này tải script CLI Stable đã ký và chạy trực tiếp. Sau khi cài xong, mở http://localhost:5476 trong trình duyệt.
Nếu cần ghim một bản phát hành cụ thể, truyền --version. README cho biết bản nhỏ nhất có thể ghim là 0.1.2 vì các bản cũ hơn không có signed manifest:
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --version 0.6.0Người mới thường nhầm rằng lệnh này đã cài luôn kiro-cli. README nói agent mặc định dùng kiro-cli, nhưng đây là phần cài và đăng nhập riêng. Nếu first launch báo thiếu prerequisite, hãy cài kiro-cli theo hướng dẫn chính thức rồi chạy kiro-cli login trên Gateway host.
C.Chạy bằng Docker
Trên máy đã cài Docker, chạy container Gateway như sau:
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stable-d chạy container nền. --name kirocrew đặt tên container. Tùy chọn -p chỉ bind cổng vào loopback của máy, còn volume kirocrew-home giữ dữ liệu trong thư mục home của Kiro Crew qua các lần khởi động lại.
Sau khi container chạy, mở http://localhost:5476. README yêu cầu xem Docker guide cho đăng nhập lần đầu, tag kênh phát hành, nâng cấp và mô hình bảo mật container. Không nên tự đổi cổng hoặc mở ra mạng ngoài nếu chưa cấu hình xác thực và kiểm soát truy cập.
D.Build từ source trên macOS hoặc Linux
Clone repo và vào đúng thư mục:
git clone https://github.com/kirodotdev/KiroCrew.git
cd KiroCrewSau đó build project và kích hoạt virtual environment:
make build
source .venv/bin/activatemake build thực hiện quy trình build được repo định nghĩa. Lệnh source kích hoạt môi trường Python vừa tạo trong terminal hiện tại. Nếu bạn mở terminal mới, môi trường này không tự động được kích hoạt lại.
Trước khi dùng backend ACP mặc định, cài và đăng nhập kiro-cli trên Gateway host. README không chép lệnh cài kiro-cli, nhưng nêu rõ lệnh đăng nhập cần chạy là:
kiro-cli loginE.Khởi tạo, kiểm tra và khởi động
Sau khi cài bằng wheel hoặc build từ source, chạy ba lệnh sau:
kirocrew setup
kirocrew doctor
kirocrew gatewaysetup tạo cấu hình ban đầu. doctor kiểm tra môi trường và các điều kiện cần thiết. gateway khởi động Gateway để dashboard, CLI và những bề mặt kết nối khác dùng chung phiên, memory, lịch và approval.
Nếu muốn Gateway tự chạy cùng máy, README cung cấp các lệnh cài service và xem trạng thái:
kirocrew service install
kirocrew service status
kirocrew logsĐể cấu hình, dùng các lệnh sau:
kirocrew config get
kirocrew config set <key> <value>
kirocrew config editCó thể đặt cổng bằng biến môi trường hoặc tham số Gateway:
KIROCREW_PORT=<n> kirocrew gateway --port <n>Trên Windows, cú pháp biến môi trường có thể khác shell Unix. README yêu cầu dùng Windows guide cho native source install, nên hãy theo đúng hướng dẫn đó thay vì áp dụng máy móc lệnh trên.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đầu tiên là chạy kirocrew doctor và xem báo cáo không còn lỗi chặn. Sau đó chạy kirocrew gateway, mở http://localhost:5476 và xác nhận dashboard hiển thị được.
Nếu dùng Docker, kiểm tra container kirocrew đang chạy và truy cập được cổng 5476. Nếu dùng app desktop, mở app và hoàn tất first-run onboarding. Lần chạy đầu sẽ kiểm tra kiro-cli; nếu backend mặc định thiếu công cụ hoặc chưa đăng nhập, app sẽ liên kết tới hướng dẫn thiết lập tương ứng.
Để kiểm tra log khi có vấn đề, chạy:
kirocrew logs
kirocrew logs -fkirocrew logs xem log hiện có. kirocrew logs -f theo dõi log tiếp tục trong lúc bạn thử thao tác. Một dấu hiệu tốt là bạn có thể tạo hoặc tiếp tục phiên, xem tiến độ tool call và khởi động lại Gateway mà trạng thái vẫn còn.
V.Dùng vào việc thật
A.Dev nhận một task nhiều bước
Một dev có kế hoạch migration cơ sở dữ liệu và không muốn ngồi theo dõi từng lệnh. Trong dashboard hoặc CLI, có thể giao yêu cầu theo kiểu: Implement this migration plan and stop if the tests fail.
Kiro Crew sẽ chia công việc thành các bước, thực hiện, kiểm tra và dừng khi điều kiện kiểm thử không đạt. Checkpoint giúp tiếp tục từ phần đã làm nếu phiên bị gián đoạn, thay vì bắt đầu lại toàn bộ.
B.Nhóm kỹ thuật muốn nghiên cứu nhiều lựa chọn
Một nhóm cần chọn giữa ba phương án triển khai. Người dùng có thể yêu cầu: Research these three options in parallel and recommend one.
Agent chính sẽ tạo các subagent tách biệt để nghiên cứu song song rồi tổng hợp trade-off. Kết quả phù hợp với công việc cần so sánh nhiều hướng, nhưng bạn vẫn nên kiểm tra các kết luận trước khi quyết định kỹ thuật.
C.Nhân viên văn phòng cần bản tổng hợp định kỳ
Một nhân viên muốn mỗi ngày làm việc biết những việc mở nào cần xem. Có thể tạo yêu cầu theo mẫu: Every weekday at 9, summarize the open work I should review.
Kiro Crew biến yêu cầu thành recurring job có timezone và gửi kết quả tới surface bạn chọn. Cách này hữu ích khi bạn muốn thông tin xuất hiện đều đặn mà không phải tự mở chat và nhắc lại.
D.Dev muốn agent nhớ quy ước của repo
Một nhóm thường xuyên sửa cùng một repo và nhiều lần phải nhắc agent về cách chạy test hoặc quy ước review. Sau khi sửa cách agent làm hoặc ghi nhận một lỗi, Kiro Crew có thể lưu bài học với repo_scope để bài học chỉ áp dụng cho repo đó.
Qua các lần làm việc sau, ngữ cảnh và lesson có thể được dùng lại. Khi quy ước thay đổi, bạn có thể xem, chỉnh sửa hoặc xóa lesson và skill thay vì để thông tin cũ tiếp tục ảnh hưởng.
Một phiên chat kết thúc, nhưng một workspace có memory và checkpoint thì công việc vẫn tiếp tục.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.kiro-cli chưa được cài hoặc chưa đăng nhập
Backend ACP mặc định cần kiro-cli trên Gateway host. Cài công cụ theo hướng dẫn chính thức, chạy kiro-cli login, rồi thử lại first launch hoặc Gateway. Nếu bạn dùng harness ACP khác, xem install guide vì yêu cầu có thể khác.
B.kirocrew doctor báo thiếu môi trường
Khi build source trên macOS hoặc Linux, kiểm tra Python có đạt từ 3.12, Node.js có đạt 22.12 và npm đã sẵn sàng. Chạy lại make build, kích hoạt .venv bằng source .venv/bin/activate, rồi chạy kirocrew doctor.
C.Mở dashboard nhưng không vào được
Kiểm tra Gateway đã chạy chưa bằng kirocrew gateway hoặc xem log bằng kirocrew logs. Nếu đã đặt cổng riêng, hãy mở đúng cổng và kiểm tra cấu hình KIROCREW_PORT hoặc tham số --port. README cho biết dashboard mặc định bind vào loopback, nên máy khác không thể truy cập nếu bạn chưa cấu hình remote exposure có xác thực.
D.Dữ liệu hoặc phiên làm việc biến mất sau khi chạy container
Khi dùng Docker, cần giữ volume kirocrew-home như trong lệnh mẫu. Volume giúp dữ liệu nằm ở /home/kirocrew không bị mất khi container được tạo lại. Với cài đặt thường, dữ liệu người dùng mặc định nằm dưới ~/.kiro/crew; biến KIROCREW_HOME có thể đổi vị trí này, nhưng một số thư mục vẫn ở dưới ~/.kiro.
E.Không muốn gửi telemetry ẩn danh
Kiro Crew gửi một heartbeat ẩn danh mỗi ngày khi được bật mặc định. Bạn có thể tắt trong Privacy screen, trong Settings > Privacy hoặc bằng:
kirocrew telemetry disableKiểm tra trạng thái bằng:
kirocrew telemetry statusREADME cũng cung cấp KIROCREW_TELEMETRY_DISABLED=1 cho heartbeat theo shell hoặc container và DO_NOT_TRACK=1 cho cả local metrics lẫn heartbeat. Telemetry không gửi prompt, câu trả lời model, nội dung file, đường dẫn, tên repo, credential, hostname, username hoặc IP address.
VII.Có nên dùng không
Kiro Crew đáng dùng nếu bạn cần một agent chạy lâu dài, có memory, lịch, checkpoint và nhiều giao diện. Nó đặc biệt hợp với dev muốn giao việc nhiều bước, nhóm cần tự động hóa định kỳ hoặc người muốn giữ một workspace AI trên máy mình kiểm soát. Khả năng quan sát execution và nhiều lớp approval cũng hữu ích khi công việc có tác động thật.
Giới hạn là thiết lập không nhẹ như một chatbot thông thường. Build source cần nhiều phụ thuộc; backend mặc định còn cần kiro-cli và đăng nhập riêng. Các quy trình remote, Docker, service, harness ACP khác và Windows native install đều cần đọc thêm các guide tương ứng.
Bạn nên chọn cách khác nếu chỉ cần hỏi đáp ngắn, không cần lưu trạng thái hoặc không muốn quản lý Gateway, service và quyền tool. Nếu cần tự động hóa, hãy bắt đầu bằng một tác vụ có phạm vi nhỏ, kiểm tra approval và log, sau đó mới bật lịch chạy hoặc quyền truy cập rộng hơn.
Câu hỏi thường gặp
Kiro Crew có miễn phí không?
Tư liệu cung cấp cho biết repo là mã nguồn mở và dùng giấy phép Apache-2.0. README không nêu chính sách giá, chi phí model hoặc chi phí máy chủ, nên chưa thể khẳng định toàn bộ quá trình sử dụng là miễn phí.
Có cần GPU để chạy Kiro Crew không?
README không nêu GPU là yêu cầu. Tư liệu chỉ nêu các cách chạy trên phần cứng của bạn, Docker hoặc máy từ xa, cùng yêu cầu môi trường khi build source.
Kiro Crew có chạy được trên Windows không?
Có. README cung cấp app desktop Windows x64 và nói Windows được hỗ trợ qua native source install. Khi build source trên Windows, README yêu cầu theo Windows guide thay vì các bước shell dành cho macOS và Linux.
Kiro Crew có cần tài khoản riêng không?
Kiro Crew không có hệ thống tài khoản riêng. Backend mặc định dùng `kiro-cli`, và bạn cần cài rồi chạy `kiro-cli login`; README nói thông tin đăng nhập đó không được Kiro Crew đọc hoặc gửi.
Dữ liệu và prompt có được gửi đi không?
README nói telemetry không gửi prompt, câu trả lời model, nội dung file, đường dẫn, tên repo, credential, biến môi trường, hostname, username hoặc IP address. Kiro Crew vẫn có thể gửi heartbeat ẩn danh mỗi ngày nếu bạn chưa tắt telemetry.
Có thể dùng Kiro Crew từ máy khác không?
Có thể chạy Gateway trên máy từ xa do bạn kiểm soát và làm việc qua desktop app, dashboard web, CLI hoặc kênh kết nối như Slack và Discord. Dashboard bind loopback mặc định; truy cập từ xa cần cấu hình xác thực.
Kiro Crew khác một phiên chat AI thông thường ở điểm nào?
Kiro Crew tập trung vào workspace bền bỉ: phiên, memory, lịch và checkpoint có thể tồn tại qua lúc Gateway khởi động lại. Nó còn hỗ trợ tác vụ dài, subagent, skill tự tiến hóa và công việc không cần người ngồi trước terminal.


