Antfarm

基于 OpenClaw 的多智能体工作流管道。每个工作流均由一系列专业智能体（规划员、开发员、验证员、测试员、评审员）组成，这些智能体通过定时任务（cron jobs）轮询共享的 SQLite 数据库，实现自主执行。

所有 CLI 命令均使用完整路径，以避免 PATH 环境变量问题：

node ~/.openclaw/workspace/antfarm/dist/cli/cli.js 

下文简写说明：antfarm-cli 表示 node ~/.openclaw/workspace/antfarm/dist/cli/cli.js。

工作流

核心命令

# 安装全部工作流（创建智能体 + 启动仪表板）
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js install

# 彻底卸载（工作流、智能体、定时任务、数据库、仪表板）
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js uninstall [--force]

# 启动一次运行
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow run  "<含验收标准的详细任务描述>"

# 查询某次运行的状态
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow status "<任务描述或运行 ID 前缀>"

# 列出所有运行记录
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow runs

# 从失败步骤恢复运行
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow resume 

# 查看日志（默认显示最后 100 行，可选指定行数）
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js logs [lines]

# 仪表板
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js dashboard [start] [--port N]
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js dashboard stop

启动运行前的准备

任务字符串是你与各智能体之间的契约。模糊的任务描述将导致低质量输出。

任务字符串中必须包含以下内容：

1. 需构建或修复的内容（具体明确，不可笼统）
2. 关键的技术细节与约束条件
3. 验收标准（建议以复选框形式列出）

在正式运行前，请务必获得用户对规划方案及验收标准的确认。

工作原理

• 各智能体配置有定时任务（每 15 分钟执行一次，错峰触发），用于轮询待处理步骤
• 每个智能体认领其负责的步骤，完成工作后标记为已完成，从而推进至下一环节
• 上下文信息通过智能体输出中的 KEY: value 键值对在步骤间传递
• 无中心化协调器——所有智能体完全自治

强制触发智能体

如需跳过 15 分钟定时等待，可使用 cron 工具，设置 action: "run" 并指定该智能体的 job ID。可通过 cron list 命令查看所有定时任务——其名称格式为 antfarm//。

工作流管理

# 列出当前可用的工作流
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow list

# 单独安装/卸载指定工作流
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow install 
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow uninstall 
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow uninstall --all [--force]

创建自定义工作流

详见 {baseDir}/../../docs/creating-workflows.md，其中包含编写工作流 YAML、智能体 workspace、步骤模板以及验证循环的完整指南。

智能体步骤操作（由智能体定时任务调用，通常不手动执行）

node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step claim         # 认领待处理步骤
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step complete       # 完成步骤（输出内容通过 stdin 传入）
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step fail    # 标记步骤失败并触发重试
node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step stories         # 列出某次运行关联的所有 story