OpenSwarm快速开始:5分钟从零搭建你的第一个AI开发团队
OpenSwarm快速开始:5分钟从零搭建你的第一个AI开发团队
OpenSwarm 是一个开源的自主 AI 开发团队编排器:它把多个 AI Agent 组织成一支"开发团队",自动完成写代码、审代码、跑测试的完整流水线,并支持通过 Discord 远程指挥、用 Linear 管理任务、通过 Web 仪表盘实时观察进度。本文将带你从零开始,在 5 分钟内完成安装、配置,并跑通你的第一个 AI 任务——这是你搭建 AI 开发团队的第一步,也是最快见效的一步。
认识 OpenSwarm:AI 开发团队长什么样?
在动手之前,先花 30 秒了解它的核心能力 🧠:
- Worker/Reviewer 成对协作 — 一个 Agent 负责写代码(Worker),另一个负责审查(Reviewer),多轮迭代直到通过,流水线实现见 src/agents/pairPipeline.ts
- 多模型适配 — 支持 OpenAI Codex/GPT、OpenRouter 任意模型、本地模型(Ollama、LM Studio)以及 Claude Code,可随时切换
- 自动任务调度 — 定时从 Linear 拉取任务,自动分配、执行、回报状态
- 认知记忆 — Agent 会在长期记忆中沉淀经验,越用越懂你的代码库(向量存储实现在 src/memory/)
- Web 仪表盘 — 端口 3847 上实时查看流水线阶段、累计花费与日志
- Discord 远程控制 — 在手机上就能派发任务、暂停/恢复、查看进度
整体架构可以概括为一条流水线:Worker → Reviewer → Tester → Documenter,由自动调度器驱动,详见 ARCHITECTURE.md。
一键安装:3 步装好 OpenSwarm
前置要求
- Node.js >= 22(运行
node -v检查,版本不够请先升级) - 至少一个 AI 模型来源,四选一即可:
- OpenRouter API Key(
OPENROUTER_API_KEY) - ChatGPT 订阅(走 Codex OAuth 登录,最省事)
- 本地模型服务(Ollama / LM Studio,无需任何账号)
- 已登录的
claudeCLI
- OpenRouter API Key(
安装命令
打开终端,执行:
npm install -g @intrect/openswarm
安装完成后,运行诊断命令,检查运行环境、模型来源与端口是否就绪:
openswarm doctor
如果 doctor 报告缺少某个模型来源,按提示补齐即可。需要手动接入时,可用 openswarm auth status 查看当前已配置的凭据。
5 分钟快速上手:跑通你的第一个 AI 任务
第 1 步:运行交互式初始化向导
openswarm init
向导只问 3 个问题,并且会自动检测你已有的登录状态,帮你写好全部配置:
- AI 模型来源 — 支持
codex-responses(ChatGPT OAuth,最易上手)、openrouter、gpt、lmstudio、local、claude等,可直接在向导内完成登录 - 任务后端 — 选择本地 SQLite 任务库(无需账号,推荐新手)或 Linear
- 通知渠道(可选)—
none/discord/slack/telegram/webhook
完成后,向导会自动生成 .env(密钥文件,权限 600)和 config.yaml(配置文件)。配置文件的完整结构可以参考仓库中的示例 config.example.yaml。
第 2 步:让 AI 审查你的代码
进入任意一个 Git 项目目录,执行:
openswarm review --path . --read-only
它会对当前改动做一次只读审查,不修改任何文件——非常适合新手先感受 AI 审查的产出。
第 3 步:打开 AI 聊天工作台
openswarm
默认进入 TUI 聊天界面,支持多标签页(Chat / Projects / Tasks / Stuck / Issues / Logs)与流式输出:
| 按键 | 作用 |
|---|---|
Tab |
切换标签页 |
Enter |
发送消息 |
Shift+Enter |
换行 |
i |
聚焦输入框 |
Esc |
退出输入聚焦 |
Ctrl+C |
退出 |
状态栏会实时显示:模型来源 · 当前模型 · 消息数 · 累计花费 💰。
启动守护进程:让 AI 团队"上岗"
完成初始化后,就可以启动完整的自主守护进程(Daemon):
openswarm start # 后台启动守护进程
openswarm status # 查看 pid、运行时长、日志路径
openswarm dash # 打开 Web 仪表盘(端口 3847)
openswarm stop # 停止守护进程
守护进程启动后,仪表盘上会实时展示每个任务的流水线阶段(Worker → Reviewer → Tester → Documenter)、队列深度、累计花费等指标;想控制成本时,用 openswarm cost --since 24h 查看按模型统计的消耗。
Discord 远程控制:随时随地指挥 AI 团队
如果你把通知渠道配置成了 Discord(向导会引导你填入 Bot Token 与频道 ID),就能在手机上指挥整支团队 ☕:
| 命令 | 作用 |
|---|---|
!dev <repo> "<任务>" |
对指定仓库派发一个开发任务 |
!tasks |
查看正在运行的任务 |
!cancel <taskId> |
取消运行中的任务 |
!auto start / !auto stop |
启动 / 停止自主模式 |
!pair start |
启动 Worker/Reviewer 协作会话 |
!status |
查看 Agent 与系统状态 |
!help |
完整命令参考 |
进阶:接入 Linear,实现全自动流水线
当你的任务量变多,可以把手动派发升级为全自动:
- 在仓库目录运行
openswarm auth login --provider linear完成 OAuth 登录 - 在
config.yaml中启用autonomous自动模式,设置调度周期(默认每 15 分钟一次心跳) - 守护进程会自动从 Linear 拉取
Todo状态的任务 → 按优先级筛选 → 派发 Worker/Reviewer 流水线 → 回写任务状态 → 通知 Discord
整个工作流的详细说明见 README.md 的 "How It Works" 章节,更多长期路线图可参考 docs/PLATFORM_ROADMAP.md。
常见问题排查
| 问题 | 解决方法 |
|---|---|
openswarm doctor 报错 |
按提示补装缺失依赖;本地模型需先启动 Ollama / LM Studio |
| 找不到可用的模型来源 | 运行 openswarm auth login --provider openrouter(或设置 OPENROUTER_API_KEY) |
| 仪表盘打不开 | 先确认守护进程在运行:openswarm status,再执行 openswarm dash |
| 想换模型来源 | openswarm provider 打开交互式切换器,运行中的守护进程会原地切换 |
总结
回到起点,你刚刚只用了 5 分钟就走完了 OpenSwarm 快速开始的全部核心路径:
npm install -g @intrect/openswarm一键安装openswarm init交互式配置openswarm review --path . --read-only跑通第一个 AI 审查openswarm start+openswarm dash让 AI 团队常驻上岗
从这一刻起,你拥有的不再是"一个 AI 助手",而是一个能写代码、审代码、汇报进度的 AI 开发团队。后续可以逐步解锁 Linear 自动派单、Discord 移动指挥与多模型成本路由——你的自动化之旅,才刚刚开始 🚀


