Antfarm

无需组建专业开发团队，无需投入复杂的基础设施搭建，只需一条命令，就能在OpenClaw中拥有一支分工明确、协同高效的AI智能体团队——这就是Antfarm的核心价值。

Antfarm为用户预设了规划者、开发者、验证者、测试者、审查者等多种专业AI智能体角色，它们能够遵循固定流程协同工作，确保每一项任务都能实现可靠、可重复的落地效果，无论是功能开发、安全审计还是bug修复，都能一键启动、自动推进，大幅降低人工投入成本。

快速安装：两条方式，零门槛上手

Antfarm的安装过程极简，无需复杂配置，两种方式任选其一，全程仅需几步操作即可完成：

curl -fsSL https://raw.githubusercontent.com/snarktank/antfarm/v0.4.1/scripts/install.sh | bash

如果已经在使用OpenClaw智能体，更可以直接向其发送指令，省去手动输入命令的步骤：

"install github.com/snarktank/antfarm"

安装完成后，运行 antfarm workflow list 命令，即可查看所有可用的智能体工作流，随时准备启动任务。

⚠️ 重要提醒

1. 不在npm上：Antfarm仅支持从GitHub安装，并非npm注册表中的同名包，请勿误装。
2. 环境要求：需安装Node.js ≥ 22版本。若运行时出现「node:sqlite」相关错误，请确认使用的是纯Node.js 22+版本，而非Bun的Node封装器。

核心能力：3种预设工作流，覆盖高频开发需求

Antfarm内置3种实用工作流，每种工作流都配备了专属的AI智能体团队，无需额外配置，输入任务需求即可自动执行全流程，解决开发中的高频痛点。

1. feature-dev（7个智能体）：从需求到PR，全程自动化

适用场景：新增功能开发，比如给项目添加用户认证、数据统计等功能。

核心流程：提交功能请求后，规划者会先将任务拆解为多个可执行的小任务（故事点），随后每个故事点会依次经过「搭建环境→开发实现→验证功能→测试验收→提交PR→代码审查」的全流程，其中任何步骤失败都会自动重试，未通过代码审查的内容绝不会发布，确保功能可靠可用。

流程拆解：plan → setup → implement → verify → test → PR → review

2. security-audit（7个智能体）：漏洞扫描+修复，兼顾安全与兼容

适用场景：项目安全审计，快速发现并修复代码中的安全漏洞，避免安全风险。

核心流程：只需指向目标代码仓库，智能体团队会先扫描仓库中的所有安全漏洞，按漏洞严重性排序后，逐一进行修补；所有漏洞修复完成后，会再次进行全面审计，确保漏洞彻底修复，同时生成回归测试，避免修复过程中引入新的问题，最终输出包含安全修复的PR。

流程拆解：scan → prioritize → setup → fix → verify → test → PR

3. bug-fix（6个智能体）：错误报告一键提交，修复零看护

适用场景：项目bug修复，无需人工跟踪修复进度，全程自动化推进。

核心流程：粘贴错误报告后，分类者会先重现问题、定位问题范围，调查者深入挖掘问题的根本原因，修复者针对性编写补丁，验证者确认bug彻底修复后，直接提交PR，全程无需人工干预，实现“提交bug后，等待修复完成”的零看护体验。

流程拆解：triage → investigate → setup → fix → verify → PR

为何Antfarm能实现高效可靠的协同？

不同于普通的AI智能体工具，Antfarm的核心优势在于“确定性”和“协同性”，其可靠运行的背后，离不开四大核心设计：

• 确定性工作流：所有任务都遵循固定的步骤和顺序，无论重复执行多少次，流程都保持一致，避免智能体遗漏关键步骤（比如测试、审查），确保结果可复现。
• 智能体互相验证：采用“分工不交叉”的原则，开发者不负责自身开发内容的验证，由独立的验证者根据预设验收标准，逐一检查每个任务成果，避免“自审自过”的问题。
• 全新上下文机制：每个智能体执行任务时，都会获得干净的会话环境，没有上下文窗口膨胀的问题，也不会受到历史消息的干扰，有效减少AI幻觉，提升任务准确率。
• 自动重试与升级：若某一步骤执行失败，系统会自动重试；当重试次数耗尽仍未成功时，会及时向用户反馈，避免静默失败导致任务停滞，确保流程顺畅推进。

工作原理：极简设计，零外部依赖

Antfarm采用“极简设计”理念，无需依赖任何复杂的外部服务，仅通过三大核心组件实现多智能体协同，轻量化且易部署，只要OpenClaw能运行的环境，Antfarm就能正常使用。

核心工作流程（3步实现）

1. 定义：用YAML文件定义智能体角色、工作空间和验收标准，明确每个智能体的职责的核心任务，避免分工歧义。
2. 安装：一条命令即可完成所有配置，包括智能体工作空间搭建、cron轮询设置、子智能体权限分配，无需Docker、队列或其他外部服务。
3. 运行：智能体将独立轮询任务，认领自身负责的步骤，完成后将上下文传递给下一个智能体；SQLite负责跟踪任务状态，cron确保流程持续运行，无需人工值守。

两大核心设计亮点

• 极简架构：仅依赖YAML（配置）+ SQLite（状态跟踪）+ cron（任务调度），没有Redis、Kafka、容器编排器等复杂组件，是一款纯TypeScript CLI工具，零外部依赖。
• 基于Ralph循环：每个智能体都在全新上下文的会话中运行，任务记忆通过git历史记录和进度文件持久化，沿用与Ralph相同的自主循环模式，同时扩展到多智能体协同场景。

快速示例：手把手体验功能开发全流程

以“添加用户认证功能（OAuth）”为例，通过3条简单命令，即可启动feature-dev工作流，全程查看任务进度：

$ antfarm workflow install feature-dev
✓ Installed workflow: feature-dev

$ antfarm workflow run feature-dev "添加用户认证功能 (OAuth)"
Run: a1fdf573
Workflow: feature-dev
Status: running

$ antfarm workflow status "OAuth"
Run: a1fdf573
Workflow: feature-dev
Steps:
  [done   ] plan (planner)
  [done   ] setup (setup)
  [running] implement (developer)  Stories: 3/7 done
  [pending] verify (verifier)
  [pending] test (tester)
  [pending] pr (developer)
  [pending] review (reviewer)

从安装工作流、启动任务，到查看进度，全程无需复杂操作，通过命令行即可清晰掌握每个智能体的工作状态，等待流程结束后，就能获得经过测试和审查的功能PR。

自定义工作流：按需搭建，灵活适配需求

Antfarm内置的工作流仅为起点，用户可以根据自身业务需求，用纯YAML和Markdown定义专属的智能体、步骤、重试逻辑和验证关卡——只要会写提示词，就能搭建符合自身需求的工作流。

以下是一个简单的自定义工作流示例（可直接参考修改）：

id: my-workflow
name: 我的自定义工作流
agents:
  - id: researcher
    name: 研究员
    workspace:
      files:
        AGENTS.md: agents/researcher/AGENTS.md

steps:
  - id: research
    agent: researcher
    input: |
      研究 {{task}} 并报告发现。
      回复格式：STATUS: done 以及 FINDINGS: ...
    expects: "STATUS: done"

关于自定义工作流的详细操作指南，可查看文档：docs/creating-workflows.md。

安全性：多重保障，放心使用

Antfarm作为能在用户机器上运行代码的智能体工具，对安全性高度重视，通过四大措施，保障使用过程中的安全可靠：

• 仅限精选仓库：仅从官方「snarktank/antfarm」仓库安装工作流，不支持任意远程源，避免恶意代码注入。
• 提示注入审查：所有工作流在合并到官方仓库前，都会经过严格审查，重点排查提示注入攻击和恶意智能体文件，杜绝安全隐患。
• 社区贡献审核：欢迎社区用户提交自定义工作流，但所有提交在发布前都会经过细致的安全审查，确保社区贡献的安全性。
• 默认透明：所有工作流均由纯YAML和Markdown编写，用户可在安装前直接查看文件内容，清晰了解每个智能体的具体操作，做到心中有数。

仪表盘：实时监控，掌握任务动态

为了方便用户跟踪任务进度，Antfarm提供了Web仪表盘功能，可实时监控工作流运行情况、查看步骤进度和智能体输出，操作命令简单易懂：

antfarm dashboard              # 在 3333 端口启动仪表盘
antfarm dashboard stop         # 停止仪表盘
antfarm dashboard status       # 检查仪表盘运行状态

常用命令汇总：快速查询，高效操作

整理了Antfarm核心命令，按功能分类，方便日常查询使用，无需记忆复杂语法：

1. 生命周期管理（安装/卸载）

2. 工作流操作（核心功能）

3. 日常管理（仪表盘/日志）

系统要求：提前准备，避免运行失败

使用Antfarm前，请确保环境满足以下要求，避免出现运行错误：

• Node.js 版本 ≥ 22（必须满足，否则会出现sqlite相关错误）；
• OpenClaw 版本 ≥ v2026.2.9+（需运行在主机上，Antfarm依赖其cron工具进行工作流编排；若版本较低，Antfarm会自动回退到OpenClaw CLI，但建议通过 npm update -g openclaw 升级到最新版本）；
• 若需要使用“提交PR”功能，需提前安装 gh CLI（GitHub官方命令行工具）。