机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

基罗团队

一个用于开发工作的持久工作区，它可以自我改进并在一次会话之外继续。

Kiro Crew 是一个开源开发工作空间，可以在本地或远程硬件上运行。它具有持久性、自我学习和自我进化的能力。你可以通过桌面应用程序、网页仪表板和命令行界面进行操作，或者通过 Slack 和 Discord 等连接工具继续相同的工作。你的多步骤任务可以无人值守地运行，定期任务按照你的时间表执行，心跳监控系统直到出现需要注意的情况。Kiro Crew 应用程序将这种体验针对特定工作进行定制，结合专用接口、代理、技能、日程安排、集成和后端服务。

快速开始 · 从源码构建 · 为什么选择 Kiro Crew · 功能 · 工作原理 · 安全性 · 安装 · 遥测 · 文档

快速开始

你可以选择如何运行 Kiro Crew：桌面应用程序（带自动更新）、在你的机器或远程主机上一行命令安装、用于持续运行服务器的 Docker 镜像，或者从源码构建。默认代理运行在 kiro-cli 上，你需要单独安装并登录。首次启动会检查此先决条件，如果缺失则会链接到官方安装指南。

应用下载

使用适用于 macOS 或 Windows x64 的稳定桌面包。在 Linux 上，请从下面的一行命令安装开始。安装指南 包含 Insider 和 Nightly 链接、Linux .deb / .rpm / AppImage 包、架构支持、平台要求和沙箱设置。

发布通道

稳定版为默认；Insider 跟随候选版本，Nightly 跟随 main。发布流程 包含当前触发器、版本形态、推广行为、发布节奏和更新通道语义。

一行命令安装

无需克隆仓库或构建前端，安装已签名的稳定 wheel 包：

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh

然后打开 http://localhost:5476。将 --version 传递以固定一个精确的发布版本——可固定的最小发布版本是 0.1.2，因为 0.1.0 和 0.1.1 早于清单签名，且没有已签名的清单可供解析：

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --version 0.6.0

安装指南 包含频道选择、管理 Python 与系统 Python、镜像、首次运行设置、升级和恢复。

Docker

对于始终在线的服务器，网关作为公共多架构镜像在 GHCR 上发布：

docker run -d --name kirocrew \
  -p 127.0.0.1:5476:5476 \
  -v kirocrew-home:/home/kirocrew \
  ghcr.io/kirodotdev/kirocrew:stable

请参阅 Docker 指南 了解首次登录、频道标签和容器安全模型。

从源码构建

macOS 和 Linux 需要 Python 3.12、Node.js 22.12（推荐 24 LTS）以及 npm。默认的 ACP 后端还需要 kiro-cli ：在网关主机上安装它，并在使用该后端之前运行 kiro-cli login。其他经过验证的 ACP 支架在 安装指南 中有各自的前置要求。Windows 支持通过本地源码安装；请遵循 Windows 指南，而不是下面的 shell 步骤。

# 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 gateway

为什么选择Kiro Crew

大多数代理会话在聊天结束时结束。Kiro Crew 在您控制的硬件上持续运行，并在对话之间继续工作。

持久性。 会话、内存、计划和任务检查点在网关重启后依然存在，且计划或被动的工作可以在无人值守的情况下继续进行。

自学。 错误更正和任务失败会成为持久的教训。偏好和项目背景会延续到新的会话中。

自我进化。 重复的模式会成为可重复使用的技能。记忆、经验教训和技能保持可见和可编辑，因此每个 Kiro Crew 都会越来越适应其所围绕的人和工作。

可以在你选择的地方运行。 你的 Mac、本地容器，或你控制的远程机器。

一个网关，多种界面。 可以直接在桌面应用或网络仪表板中工作，也可以从命令行界面以及像 Slack 和 Discord 这样的消息平台继续相同的工作。

Kiro Crew的功能

您还可以粘贴屏幕截图并询问错误的原因。Kiro Crew 将图像发送到活动的 Kiro 模型，并将诊断结果保存在对话历史中。

完整清单请见 功能 和 新功能。

工作原理

flowchart TD
    S["Desktop app · Web dashboard · CLI · Messaging channels"]
    G["Gateway<br/>access · sessions · memory · schedules · approvals · apps"]
    A["Agent sessions<br/>ACP runtime · selected harness · MCP tools · models"]
    S --> G --> A

网关将代理运行的地方与您工作的地方分开。每个对话或后台任务都是通过选定的 agent.acp_backend 驱动的逻辑代理会话；根据该框架和工作负载，会话使用专用进程或共享 ACP 运行时的句柄。状态、策略、审批、计划、内存和应用程序都保留在网关主机上。

请参阅 架构概述 了解组件边界，会话 了解生命周期和隔离，MCP 架构 了解工具暴露。

安全与控制

Kiro Crew 在可用的地方强制执行审批、操作系统隔离、敏感路径和凭证保护、拒绝操作规则、审计记录，以及可选的运行时边界策略/配置文件上限。仪表板默认绑定到回环地址；任何远程访问都需要经过身份验证的配置。

在更改或扩大这些控制之前，请阅读规范的安全模型和安全架构。保护凭证，审查高影响动作，并使用SECURITY.md进行私密漏洞报告。

安装、配置和操作

安装指南 包含了所有安装路径、首次运行步骤、可选依赖项、升级、卸载和恢复程序。用户数据默认存放在 ~/.kiro/crew 下，并随 KIROCREW_HOME 移动；配置键和优先级在 配置规范 中为标准。

对于新的源代码或 wheel 安装：

kirocrew setup
kirocrew doctor
kirocrew gateway

在需要时将网关作为开机自启动服务运行：

kirocrew service install
kirocrew service status
kirocrew logs

服务端口、systemd/launchd 行为、容器以及远程主机访问在 安装指南、Docker 指南 和 远程主机指南 中有说明。

主要配置请使用 kirocrew config get、kirocrew config set <key> <value> 和 kirocrew config edit。使用 KIROCREW_PORT 或 kirocrew gateway --port <n> 设置进程端口。先从 kirocrew doctor 开始排查问题，然后检查 kirocrew logs（或 kirocrew logs -f）。日志来源、等级、诊断包和恢复步骤请参阅 故障排除指南。

匿名使用数据收集

Kiro Crew 每天发送 一次匿名心跳，以便维护者可以查看有多少副本正在运行，以及哪些版本、Python 小版本和安装路径仍需要支持。在从官方应用目录成功安装或更新后，它还会发送一次每个应用的匿名收据。两个信号默认启用，但首次发送前会等待首次运行隐私说明的显示；它们使用相同的控制设置。

要关闭它，请在仪表板中切换 设置 → 隐私 → 发送匿名使用心跳（首次运行引导的最后一步也显示相同开关）。或者在终端中操作：

kirocrew telemetry disable        # persists to config.json
export KIROCREW_TELEMETRY_DISABLED=1   # or per-shell / per-container
kirocrew telemetry status         # print exactly what would be sent

切换开关和 kirocrew telemetry disable 写入相同的设置，因此任意一个都会在重启和升级后保持。KIROCREW_TELEMETRY_DISABLED 会覆盖两者——当它被设置时，仪表盘切换开关会被禁用并显示说明。

正好这五个字段会被发送，每天最多一次，且不会发送其他内容：

官方应用的安装收据是独立的，并基于事件。 在成功进行官方目录安装或更新后，Kiro Crew 会向同一遥测主机上的 /b/1/install/<app-slug>?t=<token>&k=<fresh|update>&v=<release> 发送一次 GET。slug 是公共目录标识符。t 是 HMAC-SHA256 的前 32 个十六进制字符，该 HMAC 由独立的本地收据秘钥对 app-install:<slug> 进行加密；该秘钥从不离开机器，因此不同应用的令牌无法相互关联，也无法与心跳安装 ID 关联。k 区分全新安装和更新，v 是与心跳相同的仅版本号 Kiro Crew 版本锁定。

收据仅对捆绑的或版本提供的官方目录条目发放。来自用户配置的注册表、本地目录安装和自注册应用的不会发出任何收据，因此私人应用名称永远不会离开机器。如果收据专用秘钥无法持久存储，则跳过收据。

此列表过去有九个字段。发布渠道、操作系统、CPU 架构和治理状态已被移除——单独每一个都比较粗糙，但是实例 ID 是稳定的，因此这些属性都描述了同一副本，结合起来使得任何一个安装所混入的群体比单独字段显示的要窄得多。

我们将其报告为日活跃 Crews而非“用户”：Kiro Crew 没有自己的账户系统，而 kiro-cli 用于模型访问的 Kiro 登录信息从不被读取或发送。无法将副本与个人匹配，所以一个人在三台机器上运行 Kiro Crew 会计为三个 Crews。

绝不发送： 你的提示、模型响应、文件内容、文件路径、仓库或分支名称、凭证、环境变量、主机名、用户名或 IP 地址。接收的 CDN 配置了不记录客户端 IP 地址——日志传输不包含该字段，因此根本不会存储 IP。

在 CI 中自动关闭，并且每当 KIROCREW_HOME 指向 ~/.kiro/crew 以外的任何地方时（开发实例和 pod 从不计入）。

企业管理员可以完全禁用它。 安全策略中的 capabilities.telemetry 条目会阻止两个出站信号，而不管本地设置如何，然后仪表板切换开关会显示这一点，而不是提供不会生效的更改选项：

{"version": 1, "boot": {"fail_closed": true},
 "capabilities": {"telemetry": {"enabled": false}}}

请参阅 docs/system-specs/modules/governance.md。

这与 telemetry.enabled 分开，后者控制仅限本地的性能指标，这些指标永远不会离开你的计算机。请参阅 docs/system-specs/modules/metrics.md。

文档与贡献

欢迎贡献。请遵循 CONTRIBUTING.md 进行设置、变更范围验证、提交格式和拉取请求工作流程。使用 GitHub Issues 报告漏洞和功能请求；通过 SECURITY.md 私下报告安全漏洞。

许可证

Kiro Crew 根据 Apache 许可证 2.0 获得许可。有关归属信息，请参见 NOTICE。