# Coordinator：OpenClaw 多智能体工作流的自动化协调调度器

> Coordinator 是一个基于 Shell 的自动化协调调度器，专为 OpenClaw 多智能体工作流设计。它能够轮询代理状态、检测状态变更、自动提交 Git、发送阻塞告警、管理定时提醒，并处理工作流接力。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-28T08:45:50.000Z
- 最近活动: 2026-05-28T08:57:43.245Z
- 热度: 157.8
- 关键词: OpenClaw, 多智能体, 工作流调度, Shell 脚本, 自动化, Git 集成, 状态监控
- 页面链接: https://www.zingnex.cn/forum/thread/coordinator-openclaw
- Canonical: https://www.zingnex.cn/forum/thread/coordinator-openclaw
- Markdown 来源: ingested_event

---

## 原作者与来源

- **原作者/维护者**：puerkafei
- **来源平台**：GitHub
- **原始标题**：auto-coordinator
- **原始链接**：https://github.com/puerkafei/auto-coordinator
- **发布时间**：2026-05-28

---

## 背景与动机

在多智能体协作工作流中，一个核心挑战是如何有效地协调多个代理的执行。当多个代理（如 zhugeliang、caozhi、simayi、opencode 等）同时运行时，需要一种机制来：

1. 监控各代理的实时状态
2. 检测状态变化并做出响应
3. 在代理之间自动传递任务
4. 处理阻塞和异常情况
5. 管理定时任务和提醒

Coordinator 正是为解决这些问题而设计的轻量级调度器，它通过 Shell 脚本实现，无需复杂的依赖，即可与 OpenClaw 生态无缝集成。

---

## 核心功能详解

### 1. 代理状态轮询

Coordinator 通过 OpenClaw CLI 定期轮询多个代理的状态：

```bash
./coordinator.sh poll
```

支持的代理包括：
- zhugeliang
- caozhi
- simayi
- opencode

轮询结果以 JSON 格式返回，便于后续处理和分析。

### 2. 状态变更检测

使用 SHA-256 哈希比较来检测 `status.json` 的变化：

```bash
./coordinator.sh watch
```

这种机制能够精确识别文件内容的任何变化，避免不必要的处理，同时确保不会错过重要的状态更新。

### 3. 自动 Git 提交与推送

当检测到状态变化时，Coordinator 会自动执行 Git 提交和推送：

- 自动识别变更文件
- 生成提交信息
- 推送到配置的远程分支

这确保了工作流状态的持久化和团队成员之间的同步。

### 4. 阻塞通知机制

当检测到代理阻塞或异常时，Coordinator 会通过多种渠道发送告警：

- **主代理通知**：通过 `openclaw agent --agent main`
- **Webhook**：可配置的 HTTP 回调
- **Telegram 备用**：作为备用通知渠道

这种多通道告警机制确保了关键问题能够被及时发现和处理。

### 5. 定时提醒管理

Coordinator 支持灵活的定时提醒设置：

| 格式 | 示例 | 说明 |
|------|------|------|
| 绝对时间 | `14:30` | 每天指定时间触发 |
| 相对时间 | `+10min` | 从现在起 10 分钟后触发 |
| ISO 8601 | `2026-05-28T14:30:00Z` | 精确时间戳 |

### 6. 工作流接力

这是 Coordinator 的核心特性之一。当一个代理完成任务后，可以自动将工作传递给下一个代理：

```
Agent A → Agent B → Agent C
```

为了防止意外的任务跳跃，系统内置了防跳跃验证机制，确保任务按预定顺序流转。

### 7. 状态验证

Coordinator 会对 `status.json` 进行严格的验证：

- JSON 语法检查
- 必需字段验证
- 数据类型校验

这确保了状态文件的完整性和可靠性。

### 8. Cron 集成

内置的 `init-cron` 命令可以生成推荐的 crontab 配置：

```bash
./coordinator.sh init-cron
```

这使得将 Coordinator 集成到系统的定时任务中变得非常简单。

---

## 技术架构

### 依赖要求

| 依赖 | 用途 |
|------|------|
| Bash 4+ | 运行时 Shell |
| sha256sum (coreutils) | 状态哈希比较 |
| python3 | JSON 处理与验证 |
| openclaw CLI | OpenClaw 代理集成 |
| curl | Telegram / webhook 备用通知 |
| jq | 可选 — 推荐用于 JSON 解析 |

### 配置文件

Coordinator 使用 `coordinator.conf` 进行配置：

```bash
# 复制示例配置
cp coordinator.conf.example coordinator.conf

# 编辑配置
vim coordinator.conf
```

可配置项包括：
- 代理列表
- 轮询间隔
- Git 远程仓库
- 通知渠道设置
- 定时任务规则

---

## 使用场景示例

### 场景一：完整检查

执行完整的轮询和监控：

```bash
./coordinator.sh all
```

这会依次执行 `poll` 和 `watch` 命令。

### 场景二：持续监控

仅监控状态文件变化：

```bash
./coordinator.sh watch
```

适用于需要长时间运行的监控场景。

### 场景三：定时任务设置

生成 crontab 配置：

```bash
./coordinator.sh init-cron
```

然后将输出添加到系统的 crontab 中。

---

## 项目结构

```
.
├── README.md          # 项目文档
├── coordinator.sh     # 主脚本
├── coordinator.conf   # 配置文件
├── relay.conf         # 接力配置
└── work-log.md        # 工作日志
```

---

## 版本信息

当前版本：**v2026.05.28.2**

版本号遵循语义化版本规范，便于追踪变更和兼容性管理。

---

## 总结与启示

Coordinator 展示了一种轻量级但功能强大的多智能体协调方案。它的设计哲学值得借鉴：

1. **简单性**：使用 Shell 脚本实现，无需复杂的运行时环境
2. **可靠性**：通过哈希比较和多重验证确保状态准确性
3. **灵活性**：支持多种通知渠道和定时任务格式
4. **可扩展性**：模块化的设计便于添加新的代理和功能

对于正在构建多智能体工作流的团队来说，Coordinator 提供了一个很好的起点。它的核心思想——状态轮询、变更检测、自动接力——是任何多智能体协调系统都需要解决的关键问题。