# handoff

**Repository Path**: ckdkambh/handoff

## Basic Information

- **Project Name**: handoff
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: feature/multi-agent-config
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-16
- **Last Updated**: 2026-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw 多 Agent 配置仓库

Main → Worker 模式的并行任务执行方案。

## 目录结构

```
├── AGENTS.md                  # 项目说明 & 使用指南
├── config/                    # 配置样例
│   ├── openclaw.json.example  # 完整配置模板
│   ├── planner-agent.md       # Planner agent 指令模板
│   ├── worker-agent.md        # Worker agent 指令模板
│   └── backups/               # 配置备份
├── docs/                      # 技术文档 & 调研笔记
│   ├── parallel-subagent-investigation-2026-08-25.md  # 并行死锁深度调研
│   ├── summary-2026-08-24.md                        # 踩坑记录
│   └── test-prompts.md                              # 测试用例
├── prompts/                   # 提示词样例
│   └── complex-task-trigger.md # 复杂任务触发多 agent
├── reports/                   # 汇报文档
│   ├── openclaw-multiagent-report.md        # 技术报告（最新）
│   ├── longcat-comparison-test.md           # 对比测试结果
│   ├── fix-report-parallel-subagent-deadlock.md # 死锁修复报告
│   ├── 调研报告-OpenClaw多Agent并行执行.md
│   ├── 汇报-OpenClaw多Agent并行执行方案.md
│   └── 交接文档-OpenClaw多Agent配置.md
└── scripts/                   # 脚本
    ├── setup.ps1              # 初始化（Windows）
    ├── setup.sh               # 初始化（Linux）
    └── switch-config.ps1      # 切换配置
```

## 快速开始

1. 查看 `config/openclaw.json.example` 了解配置格式
2. 查看 `reports/openclaw-multiagent-report.md` 了解完整方案
3. 查看 `docs/test-prompts.md` 获取测试用例

## 关键配置

| 参数 | 值 | 说明 |
|------|-----|------|
| `maxSpawnDepth` | 2 | 允许 main→worker 嵌套 |
| `maxConcurrent` | 4 | 全局并行 subagent 上限 |
| `maxChildrenPerAgent` | 3 | 每 agent 子任务上限 |
| `delegationMode` | prefer | 优先委派子 agent |

## 已知限制

- 并行 spawn 2+ worker 时存在死锁 bug（已通过源码修复）
- 修复方法见 `reports/openclaw-multiagent-report.md` 第 3 节