1. 项目定位与用途
OpenSwarm 是一个自主 AI 代理编排器，旨在自动化软件开发全流程。它通过 orchestrate 多个 Claude Code 或 OpenAI Codex CLI 实例作为协作智能体，实现从任务接收到代码交付的端到端自动化。系统提供 TUI 聊天界面与 Discord 机器人双重控制方式，支持手动触发任务或完全自主运行，核心目标是减少人工协调成本并提升开发效率。
项目档案命令行工具
unohee/OpenSwarm CLI 工具：安装、命令与使用场景
OpenSwarm 是一个自主 AI 代理编排系统，通过 orchestrate Claude Code 或 OpenAI Codex 实例自动化软件开发流程。它能够自动从 Linear 领取任务，执行编码、审查、测试和文档生成，并通过 Discord 进行实时控制。本页面提供项目介绍、安装配置指南、使用命令参考以及核心架构说明。
AI 总结
OpenSwarm 是一个自主 AI 代理编排器，通过 Claude Code CLI 或 OpenAI Codex CLI 驱动多智能体协作，自动完成从任务领取、编码、审查到文档生成的完整开发流程，并集成 Discord 控制与 Linear 项目管理。
中文项目介绍
OpenSwarm 是一个自主 AI 代理编排系统，旨在自动化软件开发全流程。它通过 orchestrate 多个 Claude Code 或 OpenAI Codex 实例作为协作智能体，实现从任务接收到代码交付的端到端自动化。系统提供 TUI 聊天界面与 Discord 机器人双重控制方式，支持手动触发任务或完全自主运行。
传统开发中，任务分配、编码、审查、测试和文档生成需要大量人工协调，效率低下且容易出错。OpenSwarm 通过自动化管道将这些环节串联，减少人工干预，同时利用长期记忆保持项目上下文一致性。
主要适用于使用 Linear 进行敏捷开发的软件团队。典型场景包括：自动处理 Linear 中的 bug 修复与功能需求；通过 Discord 聊天界面监控与干预 AI 代理工作；PR 自动改进与冲突解决；基于历史知识的代码库风险分析。也支持单次任务快速执行模式，适合临时性编码需求。
技术层面，系统采用适配器模式支持多模型提供商，通过 Worker-Reviewer-Tester-Documenter 配对管道执行任务，使用 LanceDB 向量数据库存储长期记忆，集成 Discord 进行实时控制，并与 Linear 和 GitHub 形成项目管理闭环。配置文件使用 Zod 验证，支持环境变量替换。
详细信息与使用说明
2. 解决的问题
传统开发流程中，任务分解、编码、审查、测试和文档生成需要大量人工协调，效率低下且上下文易丢失。OpenSwarm 通过标准化管道将各环节自动化串联，减少人工干预成本；同时利用 LanceDB 向量数据库保存代码库快照与决策历史，解决长期项目记忆问题，提升跨任务一致性。
3. 适用场景
主要适用于使用 Linear 进行敏捷开发的软件团队。典型场景包括：自动处理 Linear 中的 bug 修复与功能需求；通过 Discord 聊天界面监控与干预 AI 代理工作；PR 自动改进与冲突解决；基于历史知识的代码库风险分析。也支持单次任务快速执行模式，适合临时性编码需求。
4. 安装方式
安装需满足：Node.js >= 22、已认证的 Claude Code CLI（claude -p）或 OpenAI Codex CLI（codex exec）。全局安装命令为 npm install -g @intrect/openswarm。配置需复制 config.example.yaml 为 config.yaml，并设置环境变量 DISCORD_TOKEN、DISCORD_CHANNEL_ID、LINEAR_API_KEY、LINEAR_TEAM_ID。完整守护进程模式还需配置 GitHub 仓库列表与 PR 处理器参数。
5. 使用方式
基础使用：openswarm 启动 TUI 聊天界面；openswarm start 启动完整守护进程。单次任务：openswarm run "描述" -p 项目路径；openswarm exec "命令" --local --pipeline 本地执行完整管道。Discord 控制：发送 !provider codex 切换模型提供商。所有命令支持 --help 查看详细选项，退出码 0 成功、1 失败、2 超时。
6. 实现特点
系统核心采用适配器模式抽象 CLI 执行层，支持 Claude 与 Codex 动态切换；多代理配对管道实现 Worker→Reviewer→Tester→Documenter 协作流程；事件总线（EventHub）实现模块解耦；自主运行器结合调度器与决策引擎，从 Linear 自动领任务并更新状态；LanceDB 向量存储支持代码库语义检索与风险分析。配置文件使用 Zod 验证，支持环境变量替换。
思维导图
OpenSwarm
适配器层
Claude 适配器
Codex 适配器
进程注册表
代理层
Worker
Reviewer
Tester
Documenter
Auditor
配对管道
自动化层
自主运行器
调度器
PR 处理器
CI 监控
冲突解决
核心层
配置管理
事件总线
服务生命周期
追踪收集器
集成层
Discord 机器人
Linear 同步
GitHub 集成
LanceDB 知识库
常见问题
OpenSwarm 需要哪些前提条件？
需要 Node.js >= 22、已认证的 Claude Code CLI（claude -p）或 OpenAI Codex CLI（codex exec），以及 Discord Bot 令牌、Linear API 密钥等集成凭证。
如何启动 OpenSwarm？
全局安装后，运行 openswarm 启动 TUI 界面；配置好 config.yaml 和环境变量后，运行 openswarm start 启动完整守护进程；或使用 openswarm run "任务描述" 执行单次任务。
支持哪些 AI 模型提供商？
默认使用 Claude Code CLI，支持 claude-sonnet-4、claude-haiku-4.5 等模型；也可切换至 OpenAI Codex CLI，支持 o3、o4-mini 等模型。可通过 Discord 命令 !provider 实时切换。
如何与现有项目管理工具集成？
内置 Linear 集成可自动同步问题与更新状态；GitHub 集成用于 PR 监控与 CI 状态获取；Discord 机器人提供控制接口与进度通知。所有集成均通过配置文件与环境变量进行认证。
系统如何保持长期记忆？
使用 LanceDB 向量数据库存储代码库快照、决策历史与知识片段，支持语义检索。这使代理能够跨任务引用历史上下文，提升长期一致性并避免重复工作。