KiroCrew: Không gian làm việc AI liên tục — 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
KiroCrew là workspace phát triển mã nguồn mở, giúp agent AI tiếp tục làm việc giữa các phiên, ghi nhớ ngữ cảnh, chạy tác vụ dài và lập lịch tự động. Bạn có thể dùng qua ứng dụng desktop, dashboard web, CLI, Slack hoặc Discord. Cài nhanh bằng bộ cài, Docker hoặc build từ source; bản source cần Python 3.12+, Node.js 22.12+ và npm.
KiroCrew là một workspace phát triển mã nguồn mở để agent AI tiếp tục làm việc sau khi bạn đóng phiên trò chuyện. Công cụ chạy trên máy của bạn, container hoặc máy chủ từ xa mà bạn kiểm soát, đồng thời lưu phiên, bộ nhớ, lịch chạy và điểm kiểm tra của tác vụ.
KiroCrew phù hợp với lập trình viên, nhóm kỹ thuật và người làm văn phòng muốn giao các việc nhiều bước cho AI mà không phải ngồi chờ liên tục. Điểm đáng giá nhất là tác vụ có thể chạy nền, tiếp tục sau khi Gateway khởi động lại, và biến các lần sửa lỗi hoặc quy trình lặp lại thành bài học, kỹ năng dùng về sau.
kirodotdev/KiroCrew
KiroCrew là workspace AI chạy liên tục, lưu phiên làm việc, tự học, lập lịch và giao việc cho agent trên máy của bạn.
I.Kiro Crew làm được gì
A.Giữ nguyên công việc giữa các phiên
KiroCrew lưu phiên trò chuyện, bộ nhớ, lịch chạy và checkpoint. Bạn có thể mở lại công việc sau khi Gateway khởi động lại thay vì phải giải thích lại toàn bộ bối cảnh cho agent.
Các cuộc trò chuyện được tách biệt và có thể chạy đồng thời. Bạn cũng có thể tìm lại những phiên cũ để tiếp tục hoặc xem lại quyết định trước đó.
B.Tự học từ lần sửa 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, KiroCrew có thể biến thông tin đó thành lesson lâu dài. Lesson có thể áp dụng cho toàn bộ workspace hoặc chỉ giới hạn trong một repository bằng repo_scope.
Điều này hữu ích khi nhóm có quy ước riêng. Ví dụ, sau khi bạn nhắc agent luôn chạy kiểm thử trước khi tạo commit, quy tắc đó có thể được giữ lại cho những lần làm việc sau.
C.Tạo kỹ năng tái sử dụng
Những quy trình lặp đi lặp lại có thể được tổng hợp thành skill. Bạn có thể xem, chỉnh sửa hoặc xóa skill khi cách làm thay đổi.
Với công việc kỹ thuật, đây là cách biến một chuỗi hướng dẫn thủ công thành quy trình có thể gọi lại. KiroCrew giữ memory, lesson và skill ở trạng thái có thể quan sát, nên bạn vẫn kiểm soát được những gì agent đã học.
D.Chạy tác vụ dài có checkpoint
Bạn có thể giao một đặc tả công việc nhiều bước rồi rời máy. KiroCrew lập kế hoạch, thực thi, kiểm tra kết quả, thử lại khi thất bại và tiếp tục từ checkpoint.
Một yêu cầu như “thực hiện kế hoạch migration này và dừng nếu test thất bại” được xử lý theo từng điểm kiểm tra. Cách này phù hợp với nâng cấp code, xử lý dữ liệu hoặc chuỗi công việc cần xác nhận sau mỗi giai đoạn.
E.Lập lịch và tự động hóa không cần người ngồi chờ
KiroCrew chạy được agent theo lịch, script hoặc command cố định mà không nhất thiết phải gọi model. Nó cũng có thể theo dõi công việc đến khi hoàn tất, phản ứng với sự kiện nhắn tin hoặc webhook đã xác thực.
Ví dụ, bạn có thể giao việc tổng hợp các đầu việc mở vào mỗi ngày làm việc và gửi kết quả tới bề mặt bạn chọn. Lịch chạy có hỗ trợ timezone.
F.Chia việc cho nhiều subagent
Agent chính có thể tạo các subagent cô lập để xử lý song song rồi tổng hợp kết quả. Đây là lựa chọn phù hợp khi cần nghiên cứu nhiều phương án hoặc kiểm tra nhiều phần của một dự án cùng lúc.
Mỗi subagent có môi trường hội thoại riêng. Kết quả được đưa trở lại phiên chính để bạn so sánh và ra quyết định.
G.Làm việc qua nhiều giao diện
Bạn có thể dùng desktop app, dashboard web hoặc CLI. Cùng một runtime còn có thể tiếp tục công việc qua các kênh kết nối như Slack và Discord.
Gateway tách nơi agent chạy khỏi nơi bạn tương tác. Trạng thái, chính sách, quyền phê duyệt, lịch và memory vẫn nằm trên Gateway host.
H.Mở rộng bằng MCP, skill và hook
KiroCrew cho phép thêm MCP server, skill dạng Markdown và hook mà không phải sửa runtime lõi. Bạn có thể mở rộng công cụ cho từng nhóm việc hoặc từng ứng dụng.
Các App cài thêm có thể cung cấp giao diện riêng, Gateway API có phạm vi, event và lifecycle hook cho quy trình chuyên biệt.
I.Theo dõi được quá trình thực thi
Dashboard hiển thị tool call, tiến độ subagent, mức dùng context, yêu cầu phê duyệt, lịch, memory và log. Bạn có thể quan sát agent đang làm gì thay vì chỉ chờ một câu trả lời cuối cùng.
KiroCrew cũng cho phép dán ảnh chụp màn hình 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ử hội thoại.
J.Có lớp kiểm soát an toàn
KiroCrew kết hợp phê duyệt công cụ, cô lập ở cấp hệ điều hành khi có thể, kiểm tra đường dẫn nhạy cảm, che thông tin xác thực, luật từ chối thao tác, audit event và governance profile.
Dashboard mặc định bind vào loopback. Nếu muốn truy cập từ xa, bạn phải cấu hình xác thực phù hợp.
II.Cần chuẩn bị gì
Nếu dùng desktop app hoặc bộ cài có sẵn, README cung cấp các kênh tải cho macOS, Windows và Linux. Windows có bộ cài x64 và cũng được hỗ trợ qua native source install. Linux có gói .deb, .rpm và AppImage cho x86_64 hoặc aarch64.
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; README khuyến nghị Node.js 24 LTS.
- npm.
kiro-clinếu dùng ACP backend mặc định.- Đăng nhập
kiro-clitrên Gateway host trước khi dùng backend mặc định.
Các ACP harness khác có yêu cầu riêng trong install guide. README không nêu chi tiết toàn bộ các yêu cầu đó.
KiroCrew có thể chạy local, trong Docker hoặc trên máy chủ từ xa mà bạn kiểm soát. Bản Docker dùng image đa kiến trúc trên GHCR và cần Docker.
README không nói rằng bạn phải tự tạo API key riêng cho KiroCrew. Quyền truy cập model mặc định dùng việc cài và đăng nhập kiro-cli. Không nên tự thêm biến môi trường hoặc key khác nếu chưa xem tài liệu cấu hình chính thức trong repo.
Dữ liệu người dùng mặc định nằm trong ~/.kiro/crew. Có thể chuyển bằng KIROCREW_HOME, nhưng một số thư mục vẫn nằm dưới ~/.kiro.
III.Cài đặt từng bước
- Chọn cách chạyDùng app, one-line install, 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 KiroCrewChạy bộ cài phù hợp với máy
- Thiết lập lần đầuChạ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
- Khởi động GatewayMở dịch vụ rồi truy cập dashboard
A.Chọn cách cài phù hợp
Nếu bạn chỉ muốn dùng nhanh, one-line install cài signed Stable wheel mà không cần clone repo hoặc build frontend. Sau khi cài, mở http://localhost:5476.
Nếu cần server chạy liên tục, README cung cấp cách chạy Docker. Nếu muốn sửa mã nguồn hoặc phát triển KiroCrew, hãy build từ source.
Desktop app là lựa chọn dễ tiếp cận cho người dùng macOS, Windows và Linux. Kênh Stable là lựa chọn mặc định; Insider dành cho release candidate và Nightly theo main.
B.Cài bằng one-line install
Mở Terminal trên máy cần chạy Gateway rồi thực hiện:
curl -fsSL https://download.crew.kiro.dev/cli.sh | shLệnh này tải script cài bản Stable đã ký và chạy trực tiếp. Sau khi hoàn tất, mở địa chỉ sau trong trình duyệt:
http://localhost:5476Nếu cần ghim một bản phát hành cụ thể, truyền --version như sau:
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --version 0.6.0README cho biết bản có thể ghim tối thiểu là 0.1.2, vì các bản cũ hơn không có signed manifest để phân giải. Install guide là nơi quy định chi tiết về channel, Python quản lý hay Python hệ thống, mirror, nâng cấp và khôi phục.
C.Chạy bằng Docker
Trên máy đã có Docker, mở terminal và chạy:
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stableLệnh chạy container ở chế độ nền, đặt tên là kirocrew, chỉ mở cổng trên loopback của máy và lưu dữ liệu vào volume kirocrew-home. Volume giúp dữ liệu trong /home/kirocrew không mất khi container được thay mới.
Sau đó mở http://localhost:5476. README nói first-run login, channel tag, nâng cấp và mô hình bảo mật container được hướng dẫn riêng trong Docker guide. Vì vậy, nếu cần đưa dịch vụ ra mạng hoặc chạy lâu dài, hãy đọc các phần đó trước khi mở rộng quyền truy cập.
D.Build từ source trên macOS hoặc Linux
Trước hết, cài Python 3.12+, Node.js 22.12+ và npm. Nếu dùng backend ACP mặc định, cài kiro-cli trên Gateway host rồi đăng nhập:
kiro-cli loginMở terminal tại thư mục bạn muốn lưu mã nguồn, sau đó chạy đúng chuỗi lệnh trong README:
# 1. Clone and build Kiro Crew
git clone https://github.com/kirodotdev/KiroCrew.git
cd KiroCrew
make build
source .venv/bin/activate
# 2. Configure, verify, and start
kirocrew setup
kirocrew doctor
kirocrew gatewaygit clone tải mã nguồn về máy. cd KiroCrew chuyển terminal vào thư mục repo. make build build dự án và tạo môi trường cần thiết theo cấu hình của repo. source .venv/bin/activate kích hoạt virtual environment trong shell hiện tại.
Sau khi môi trường được kích hoạt, kirocrew setup thực hiện thiết lập ban đầu. kirocrew doctor kiểm tra tình trạng cài đặt. kirocrew gateway khởi động Gateway.
Nếu lệnh make hoặc các bước build gặp lỗi, không nên tự đoán tên package để cài thêm. Hãy xem install guide, pyproject.toml, Makefile và các script có sẵn trong repo để biết phụ thuộc chính xác.
E.Cài trên Windows
README xác nhận Windows được hỗ trợ qua native source install và có bộ cài desktop x64. Tuy nhiên, các lệnh shell build ở trên dành cho macOS và Linux. Với Windows, hãy dùng bộ cài Windows hoặc làm theo Windows guide trong repo thay vì áp dụng nguyên xi source .venv/bin/activate.
README không cung cấp trong phần tư liệu này toàn bộ lệnh native source install cho Windows. Vì vậy, không nên tự đổi lệnh sang PowerShell rồi cho rằng kết quả tương đương.
F.Chạy Gateway như dịch vụ
Khi đã cài và kiểm tra thành công, bạn có thể cài Gateway thành dịch vụ chạy cùng hệ thống:
kirocrew service install
kirocrew service status
kirocrew logsservice install cài dịch vụ, service status xem trạng thái và logs xem log. Cách này phù hợp với máy chủ hoặc máy làm việc cần KiroCrew hoạt động sau khi khởi động lại.
Có thể xem log trực tiếp khi xử lý lỗi:
kirocrew logs -fĐể xem hoặc sửa cấu hình chính:
kirocrew config get
kirocrew config set <key> <value>
kirocrew config editĐổi cổng bằng biến môi trường hoặc tùy chọn Gateway:
KIROCREW_PORT=<n>
kirocrew gateway --port <n>Không thay <key>, <value> hoặc <n> bằng nguyên văn. Bạn cần thay bằng khóa cấu hình, giá trị và số cổng thật theo nhu cầu. README nói config spec là nguồn chính thức cho tên khóa và thứ tự ưu tiên.
IV.Kiểm tra đã chạy được chưa
Với one-line install hoặc Docker, mở http://localhost:5476. Nếu dashboard hiện ra, Gateway đã lắng nghe trên cổng mặc định.
Với bản source, chuỗi kiểm tra cơ bản là:
kirocrew setup
kirocrew doctor
kirocrew gatewaydoctor không báo lỗi phụ thuộc nghiêm trọng là dấu hiệu môi trường đã được nhận diện. Sau khi Gateway chạy, kiểm tra dashboard và thử tạo một phiên agent.
Nếu dùng ACP backend mặc định, xác nhận kiro-cli đã được cài trên Gateway host và đã chạy:
kiro-cli loginKhi muốn kiểm tra dịch vụ và log:
kirocrew service status
kirocrew logsNếu cần biết trạng thái telemetry và các công tắc liên quan, chạy:
kirocrew telemetry statusV.Dùng vào việc thật
A.Chủ shop muốn có báo cáo công việc mỗi ngày
Chủ shop có thể giao cho KiroCrew một tác vụ định kỳ để tổng hợp các đầu việc mở cần xem xét. README đưa ra mẫu yêu cầu: “Every weekday at 9, summarize the open work I should review”.
Bạn có thể gửi yêu cầu tương tự bằng ngôn ngữ tự nhiên, chỉ rõ múi giờ và nơi muốn nhận kết quả. KiroCrew biến yêu cầu thành recurring job và gửi kết quả tới bề mặt bạn chọn, nếu các kênh đó đã được kết nối.
Kết quả thực tế là một bản tóm tắt lặp lại theo lịch, giúp chủ shop biết việc nào cần xử lý mà không phải tự mở từng phiên.
B.Nhân viên văn phòng muốn giao việc nhiều bước
Nhân viên có thể đưa cho agent một task spec, ví dụ: “Lập kế hoạch xử lý các đầu việc còn mở, thực hiện từng bước, kiểm tra kết quả sau mỗi bước và dừng nếu bước kiểm tra thất bại”.
KiroCrew lập kế hoạch, chạy từng bước, xác nhận kết quả và lưu checkpoint. Nếu Gateway khởi động lại, tác vụ có thể tiếp tục từ trạng thái đã lưu thay vì bắt đầu lại.
Cách dùng này phù hợp với các quy trình cần theo dõi tiến độ như chuẩn bị báo cáo, kiểm tra nhiều tài liệu hoặc chạy một chuỗi lệnh có điều kiện dừng.
C.Lập trình viên muốn thực hiện migration an toàn hơn
Dev có thể giao yêu cầu: “Implement this migration plan and stop if the tests fail”. KiroCrew xử lý theo checkpoint và có bước validation trong quá trình thực hiện.
Nếu test thất bại, yêu cầu dừng giúp hạn chế việc agent tiếp tục sửa nhiều phần khi nền tảng đang có lỗi. Bạn có thể xem tool call, tiến độ, approval, context usage và log trên dashboard để biết agent đã làm gì.
KiroCrew không thay thế review của dev. Những thay đổi có tác động lớn vẫn nên được kiểm tra và phê duyệt.
D.Nhóm kỹ thuật nghiên cứu nhiều phương án
Khi cần so sánh ba cách triển khai, bạn có thể yêu cầu: “Research these three options in parallel and recommend one”. KiroCrew tạo các subagent cô lập để xử lý song song rồi tổng hợp trade-off trong phiên chính.
Kết quả giúp nhóm có bản so sánh nhanh hơn. Tuy vậy, quyết định cuối cùng vẫn cần dựa trên tiêu chí kỹ thuật, chi phí và dữ liệu mà bạn cung cấp cho agent.
Giá trị lớn nhất của KiroCrew là biến một phiên chat ngắn thành một workspace có trí nhớ, lịch chạy và checkpoint.
Ông T
E.Dev muốn biến quy trình lặp lại thành skill
Nếu thường xuyên phải làm cùng một chuỗi thao tác, bạn có thể để KiroCrew tổng hợp pattern thành skill tái sử dụng. Sau đó xem lại, chỉnh sửa hoặc xóa skill khi quy trình thay đổi.
Ví dụ, một nhóm có thể xây dựng skill cho quy trình kiểm tra code trước khi bàn giao. Lesson có thể áp dụng toàn cục hoặc giới hạn theo repository bằng repo_scope, giúp quy tắc của dự án này không ảnh hưởng dự án khác.
VI.Lỗi hay gặp và cách xử lý
A.Thiếu Python, Node.js hoặc npm
Lỗi build source thường xảy ra khi phiên bản môi trường thấp hơn yêu cầu. Trên macOS và Linux, README yêu cầu Python 3.12+, Node.js 22.12+ và npm; hãy kiểm tra đúng các phiên bản này trước khi chạy make build.
Không nên tự đoán package hoặc cờ lệnh để sửa lỗi. Hãy chạy kirocrew doctor sau khi hoàn tất môi trường.
B.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. Nếu thiếu hoặc chưa đăng nhập, cài theo hướng dẫn chính thức của Kiro rồi chạy:
kiro-cli loginNếu bạn dùng ACP harness khác, xem yêu cầu riêng trong install guide vì mỗi harness có thể cần phụ thuộc khác nhau.
C.Mở dashboard nhưng không kết nối được
Trước hết, kiểm tra Gateway có đang chạy hay không:
kirocrew doctor
kirocrew logsKiểm tra lại http://localhost:5476 và cổng bạn đã cấu hình. Nếu dùng KIROCREW_PORT hoặc --port, hãy chắc chắn trình duyệt truy cập đúng cổng đó.
D.Container chạy nhưng dữ liệu không giữ lại
Khi chạy Docker, cần giữ volume kirocrew-home trong lệnh chạy. Volume này ánh xạ vào /home/kirocrew, nơi container lưu dữ liệu của KiroCrew.
Nếu bạn thay container mà không giữ volume, dữ liệu phiên và cấu hình có thể không còn như trước. Với môi trường lâu dài, hãy đọc Docker guide về nâng cấp và mô hình bảo mật.
E.Muốn truy cập từ máy khác nhưng bị chặn
Dashboard mặc định chỉ bind vào loopback. Đây là hành vi bảo vệ mặc định, không phải lỗi kết nối.
Nếu cần truy cập từ xa, phải cấu hình authenticated access theo remote host guide và security architecture. Không nên mở cổng ra mạng mà không có xác thực.
F.Không muốn gửi telemetry ẩn danh
KiroCrew bật heartbeat ẩn danh mỗi ngày theo mặc định. Bạn có thể tắt bằng Privacy screen, trong Settings hoặc từ terminal:
kirocrew telemetry disable
export KIROCREW_TELEMETRY_DISABLED=1
export DO_NOT_TRACK=1
kirocrew telemetry statuskirocrew telemetry disable tắt local metrics và heartbeat rồi lưu vào cấu hình. KIROCREW_TELEMETRY_DISABLED áp dụng cho heartbeat theo shell hoặc container. DO_NOT_TRACK tắt cả local metrics và heartbeat.
README nói telemetry không gửi prompt, câu trả lời của model, nội dung file, đường dẫn file, tên repo, branch, credential, biến môi trường, hostname, username hoặc IP. Dù vậy, hãy đọc Privacy screen và kiểm tra cấu hình trước khi chạy trên dữ liệu nhạy cảm.
VII.Có nên dùng không
KiroCrew đáng dùng nếu bạn muốn agent AI làm việc lâu dài thay vì chỉ trả lời trong một phiên. Các điểm mạnh gồm session bền vững, memory, lesson, skill, tác vụ có checkpoint, lịch chạy, subagent, nhiều giao diện và dashboard theo dõi được quá trình.
Công cụ cũng phù hợp với người muốn tự kiểm soát nơi agent chạy. Bạn có thể chạy local, trong container hoặc trên máy chủ của mình, đồng thời có nhiều lớp phê duyệt và kiểm soát bảo mật.
Giới hạn là việc cài source cần nhiều thành phần: Python 3.12+, Node.js, npm và có thể cần kiro-cli. Một số ACP harness, cấu hình remote, Docker security và Windows native install cần đọc thêm tài liệu riêng. KiroCrew cũng không thay thế việc review của con người cho các thao tác ảnh hưởng tới code, dữ liệu hoặc hệ thống.
Nếu bạn chỉ cần hỏi đáp ngắn, không cần lưu trạng thái, lịch chạy hay tác vụ nền, một công cụ chat hoặc coding assistant đơn giản sẽ nhẹ hơn. Nếu cần agent chạy liên tục, có bộ nhớ, checkpoint, lịch và quyền kiểm soát trên hạ tầng của mình, KiroCrew là lựa chọn đáng cân nhắc.
Repo hiện có khoảng 4928 sao và 1030 fork. Giấy phép là Apache-2.0. README cho biết dự án vẫn được cập nhật và có nhiều đường cài đặt, nhưng bạn nên chọn Stable cho nhu cầu thông thường và xem tài liệu bảo mật trước khi cho agent thao tác trên hệ thống thật.
Câu hỏi thường gặp
KiroCrew có miễn phí không?
Repo được phát hành theo giấy phép Apache-2.0. README không nêu đầy đủ chi phí của model, `kiro-cli`, hạ tầng hoặc các dịch vụ kết nối, nên chưa thể kết luận toàn bộ quá trình sử dụng không phát sinh phí.
KiroCrew có cần GPU không?
Tư liệu được cung cấp không nói KiroCrew bắt buộc phải có GPU. README mô tả công cụ chạy trên phần cứng local, container hoặc máy chủ từ xa, còn yêu cầu phần cứng cụ thể chưa được nêu.
KiroCrew có chạy được trên Windows không?
Có. README cung cấp desktop app Windows x64 và xác nhận Windows được hỗ trợ qua native source install. Các lệnh build shell trong README dành cho macOS và Linux; Windows cần theo Windows guide.
Có cần cài và đăng nhập kiro-cli không?
Có nếu bạn dùng ACP backend mặc định. README yêu cầu cài `kiro-cli` trên Gateway host và chạy `kiro-cli login` trước khi dùng backend này; các ACP harness khác có thể có yêu cầu riêng.
Dữ liệu và prompt có được gửi ra ngoài không?
README nói heartbeat telemetry không gửi prompt, phản hồi model, nội dung file, đường dẫn, tên repo, credential, biến môi trường, hostname, username hoặc IP. Tuy nhiên, agent vẫn có thể gửi dữ liệu cần thiết tới model hoặc dịch vụ bạn kết nối; hãy đọc security model trước khi dùng dữ liệu nhạy cảm.
Có thể dùng KiroCrew qua Docker không?
Có. README cung cấp image đa kiến trúc trên GHCR và lệnh `docker run` với volume `kirocrew-home`. First-run login, tag channel, nâng cấp và bảo mật container được hướng dẫn riêng trong Docker guide.
KiroCrew khác một phiên chat AI thông thường ở điểm nào?
KiroCrew giữ session, memory, schedule và checkpoint sau khi phiên chat kết thúc hoặc Gateway khởi động lại. Nó còn hỗ trợ tác vụ dài, recurring job, subagent, skill, MCP và nhiều giao diện như dashboard, CLI, Slack và Discord.


