kirodotdev/KiroCrew · 上手攻略
- 仓库：kirodotdev/KiroCrew
- 链接：https://github.com/kirodotdev/KiroCrew
- 分类：ai
- 作者：Tom
- 更新：2026-08-19
是什么
KiroCrew 是一个持久化 AI 开发工作空间，核心理念是"工作不随对话结束而消失"。它让 AI Agent 具备记忆、自我学习和自我进化能力，支持从桌面应用、Web Dashboard、CLI 到 Slack/Discord/Telegram 等消息渠道的多端接入。
架构上分为三层：
- Surface 层（入口）：桌面 App、Web Dashboard、CLI、Slack / Discord / Telegram / Teams / Webex / WeCom / WeChat
- Gateway 层（核心）：长期运行的本地进程，管理会话、记忆、定时任务、审批、策略
- Agent 层（执行）：通过 kiro-cli 驱动 LLM，支持 MCP 工具、子 Agent、checkpointed 任务
解决什么问题
传统 AI Coding Agent 每次对话都是独立的，关闭对话后记忆清零、任务中断。KiroCrew 解决了：
- 会话无法持久：对话结束后 Agent 不记得之前的上下文；KiroCrew 的会话、记忆、检查点均可跨会话恢复
- 无法自我改进：用户纠正 Agent 的错误无法被 Agent 记住；KiroCrew 可将纠正和失败转化为持久 lesson
- 缺乏长期任务支持：Agent 无法运行需要数小时/数天的后台任务；KiroCrew 支持 checkpointed 任务执行与断点恢复
- 无法定时触发：没有 cron 能力，Agent 只能被动等待用户指令；KiroCrew 支持定时任务和主动 nudging
快速安装
Linux 一行命令（推荐）
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh
安装完成后，打开浏览器访问 http://localhost:5476 即可使用 Web Dashboard。首次启动会自动下载 Qwen3-Embedding-0.6B GGUF 模型（约 610MB）用于语义记忆。
桌面包（可选，叠加在一行命令安装上）
# Debian/Ubuntu
sudo apt install ./KiroCrew-x86_64.deb
# Fedora/RHEL/Amazon Linux 2023
sudo dnf install ./KiroCrew-x86_64.rpm
# 通用 AppImage（需 FUSE，无 root）
./KiroCrew-x86_64.AppImage
⚠️ Linux 桌面包需要 glibc 2.34+（Ubuntu 22.04+、Debian 12+、Fedora 36+）。旧系统请用上面的一行命令安装。
Docker（服务器/始终在线场景）
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stable
macOS
下载 DMG 安装包（支持 Apple Silicon + Intel）： - Stable: https://download.crew.kiro.dev/desktop/stable/latest/KiroCrew.dmg - Insider: https://download.crew.kiro.dev/desktop/insider/latest/KiroCrew.dmg
Windows
截至 2026-08，Windows 无桌面包安装程序，需从源码安装，参考 windows-install.md。
前置依赖
| 依赖 | 作用 | 版本要求 |
|---|---|---|
| Python | Gateway 后端 | ≥ 3.10（一行命令安装会自动处理） |
| Node.js | Dashboard 构建 | 20 或 ≥ 22（仅源码构建需要） |
| kiro-cli | LLM 驱动 | 必须安装并登录 |
安装 kiro-cli 并登录：
kiro-cli login
核心用法
Web Dashboard（主界面）
安装后访问 http://localhost:5476，支持： - 多标签并行对话 - 文件浏览与编辑 - 任务状态与审批 - 记忆与知识库 - 定时任务 - Apps 管理
CLI 命令
# 对话模式
kirocrew chat
# 运行任务（指定 TASK.md）
kirocrew run TASK.md
# 定时任务管理
kirocrew cron
# 派生子 Agent
kirocrew spawn run "research X and recommend one"
# 健康检查
kirocrew doctor
工作模式
| 模式 | 用途 | 入口 |
|---|---|---|
| 定时任务 | 每日报表、巡检、定期维护 | kirocrew cron 或自然语言 |
| 主动触发 | 自动重试失败任务、目标循环 | AutoNudge / goal-loop skills |
| 事件驱动 | CI 告警、Webhook、消息渠道事件 | Webhook / 消息事件 |
| 任务执行器 | 有明确步骤的项目，支持 checkpoint | kirocrew run TASK.md |
| 子 Agent | 并行独立工作流 | kirocrew spawn run "..." |
消息渠道接入
支持 Slack、Discord、Telegram、Teams、Webex、WeCom、WeChat。连接后在对应平台即可继续对话，Gateway 自动路由消息。
MCP 工具
内置三个 MCP Server： - kirocrew-core：任务、子 Agent、记忆、审批 - kirocrew-cron：定时任务调度 - kirocrew-computer：桌面自动化
典型适用场景
- 个人 AI 开发助手：在本地持久运行，学习项目上下文，每次打开都记得之前的对话
- 定时 AI 工作流：每日定时生成报告、自动巡检服务器、周期性数据汇总
- 团队共享 Agent：通过 Slack/Discord 让团队成员都能调用同一个持久 Agent
- 长期后台任务：代码迁移、数据处理等需要数小时的任务，Agent 自动执行并在失败时 checkpoint 恢复
- 多项目并行：不同项目有不同的记忆上下文，Agent 不会混淆
坑与注意
- kiro-cli 必须独立安装：KiroCrew 本身不包含 LLM 驱动，需要单独安装 kiro-cli 并登录才能使用。
- 首次启动下载 embedding 模型：约 610MB，需联网；如需镜像或离线安装，用
KIROCREW_EMBED_MODEL_URL或KIROCREW_EMBED_MODEL_PATH配置。 - Linux AppImage 需要 FUSE 和额外沙箱步骤：Ubuntu 23.10+ 有 unprivileged user namespace 限制，AppImage 需额外手动配置 AppArmor；有 root 权限时优先用 .deb/.rpm。
- Windows 支持有限：暂无桌面安装包，只能从源码安装（pip + Python），对 Windows 用户不够友好。
- 数据存储在本地：所有会话、记忆、任务状态默认存在
~/.kiro/crew（或KIROCREW_HOME指定目录），清理该目录会丢失所有记忆。 - Agent 运行时安全边界：Gateway 通过 tool approvals、OS sandboxing、sensitive-path checks 等多层机制保护系统，但 AI Agent 仍具有真实工具访问权限，配置不当可能造成风险。
- Nightly 频道是独立安装：Nightly 和 Stable/Insider 是不同应用名，Nightly 不会覆盖 Stable，可以并行安装。
与同类对比
| 工具 | 定位 | 优点 | 缺点 |
|---|---|---|---|
| KiroCrew | 持久化 AI 工作空间 | 记忆跨会话、消息渠道多、自学习、checkpoint 任务 | 依赖 kiro-cli、LLM 提供商需自己配置 |
| OpenClaw | 多 Agent 协调平台 | 支持 cron/子 Agent/多端接入、Discord 深度集成 | 专注 Agent 协调，非独立工作空间 |
| Open Interpreter | 本地代码执行 Agent | 直接在本地跑代码、轻量 | 无持久化、无消息渠道集成 |
| Cursor Agent | IDE 内嵌 Agent | 上下文精准、代码能力极强 | 局限于 Cursor、会话边界明显 |
| Claude Code | CLI Agent | 代码能力强、生态成熟 | 无持久化、无消息渠道 |
| Roo Code | VS Code Agent | 免费、灵活 | 无服务器端持久化 |
| Kiro | AI Agent 提供商 | 官方出品 KiroCrew 配套模型 | 部分功能依赖 Kiro 生态 |
一句话总结：如果你的痛点是"每次对话 Agent 都是新的"，KiroCrew 是目前将持久化记忆、自我学习、消息渠道接入做得最完整的开源方案；如果你已经有 OpenClaw 等 Agent 协调平台，KiroCrew 更适合做个人开发助手的持久层。
一句话推荐结论
AI 开发助手的"记忆与持续性"层——让 Agent 跨会话记住你的项目、在错误中自我改进、真正接管需要长时间运行的后台任务，是从"聊天玩具"到"生产力工具"的关键一步。
原始链接：https://github.com/kirodotdev/KiroCrew
最新稳定版：stable channel（版本号由 installer 管理，建议 kirocrew doctor 查看）
系统要求：Linux (glibc 2.34+)、macOS、Windows (源码安装)、Python ≥ 3.10、kiro-cli (独立安装)
发布通道：Stable（默认）· Insider · Nightly