kwant：自托管 AI 机器人团队

项目简介

kwant 是一个自托管的多机器人协作平台：一支各司其职的 AI 机器人团队在同一个空间里共享聊天，用 @mention 把工作交接给彼此，并按计划或在你离开时自行完成任务。它用 Rust（Tokio、Axum、SQLite）编写，内置 React 网页界面，打包成单个二进制文件。可以运行在 Mac、Linux 上，也可以部署在服务器上，复用你已有的 Claude、Codex 或 Grok CLI，或使用自己的 API Key。

主要功能

• 团队而非单个聊天窗口：每个机器人有自己的角色、语气（soul）和模型；机器人之间可以 @mention 交接工作，团队负责人可以组织简短讨论并只发一条总结。频道中由 kwant 按规则挑选合适的机器人回复，并在回复下方说明理由。
• 「完成」必须经过核对：工作以卡片形式出现在 Mission board 上，每次交接一张卡。只有 kwant 自己运行了检查（例如测试或文件检查），卡片才会变成 Verified，并保留凭据；机器人附带的文件只是可查看的证据，本身不算证明。
• 带来源的事实：机器人给出的网络事实需附上可打开到具体引文的链接，kwant 会逐字核对引文是否在页面上，不符则拒绝。
• 空间（Spaces）：可为工作、副业和家庭建立独立空间，每个空间有自己的机器人、团队、频道、例行任务、账号、审批规则和招聘规则。
• 多账号支持：每个引擎可配置多个账号，包括 Claude、Codex、Grok CLI 登录，Anthropic、OpenAI、xAI 密钥，以及自建的 OpenAI 或 Anthropic 兼容服务；可设置默认账号与优先级，额度用尽时自动切换到下一个并在聊天中说明。
• 你不在时也能工作：按计划运行的例行任务（可让机器人创建，并提供撤销按钮）、机器人自行安排的跟进，以及显示待办、已完成和失败的 Inbox。
• 可控的自主性：普通工作不打断；在「仅在风险时询问」模式下，git push、网络调用、未知命令或机器人目录之外的改动会弹出审批卡，显示确切命令，可选择允许一次、始终允许或拒绝。支付相关操作在任何模式下都会询问。
• 每个机器人的规则：可设置每个机器人适合做什么、不该接手什么，以及它的浏览器可以打开哪些网站，被屏蔽的站点始终优先。
• 收尾与信件：kwant 读取聊天，若能提供还会只读访问 IMAP 邮箱和 GitHub issue / PR，找出你开了头却没完成的事；拍下账单或表格后，它会提取发件人、诉求和截止日期并起草回复，但从不代你发送。
• Parallel Universe：用本地容器测试和标注日期的价格估算，比较最多三种应用部署方案；每个数字都标注为已验证、估算或推测，不涉及云账号和实际支出。
• 无遥测：kwant 不向开发者发送任何数据，界面也不从其他服务器加载内容；唯一需要你自行下载的是首次启动时的 Laya 路由（可用 --no-laya 关闭）。
• 其他：每个机器人的记忆与技能（新技能需你批准）、机器人提议招募新成员、从 Claude Code subagent / SKILL.md / 角色卡 / JSON 导入机器人、跨空间聊天搜索、MCP 工具服务器、机器人共享浏览器、可选的 Bitwarden 密码存储，以及本地或虚拟机电脑模式。

安装与使用

macOS 提供通用应用（同时支持 Apple silicon 与 Intel，macOS 11 及以上）：打开 kwant_universal.dmg，把 kwant 拖入「应用程序」即可。应用与 kwnt serve 使用同一个数据目录 ~/.kwnt，关闭窗口后仍驻留在菜单栏。

Linux（beta，x86_64）提供 .deb（Ubuntu 22.04+ / Debian 12）和 AppImage，两者都能在应用内自我更新：

sudo apt install ./kwant_amd64.deb

其他发行版可对 AppImage 执行 chmod +x 后直接运行。也可以把二进制或 Docker 部署在服务器上。

注意事项

• macOS 应用尚未经过 Apple 公证，首次打开会被系统拦截：先点「完成」，再到「系统设置 → 隐私与安全性」中点击「仍要打开」并输入密码；macOS 14 及更早版本也可在「应用程序」中右键选择「打开」。
• Linux 版本目前为 beta。
• 项目采用 AGPL-3.0 许可证。

本作品整理自 GitHub 开源项目 alexsergivan/kwant，原作者 @alexsergivan，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。