サブエージェント設定ガイド

1. メインセッション
   └─> sessions_spawn でサブエージェントを起動
       ├─ task: タスク内容
       ├─ model: 使用モデル（省略時はデフォルト設定 or 親を継承）
       ├─ thinking: 推論レベル（省略時はデフォルト設定 or 親を継承）
       └─ label: 識別名

2. サブエージェント
   └─> 専用のセッションで作業実行
       ├─ ツール呼び出し（Read, web_fetch, exec等）
       ├─ 結果をまとめる
       └─ 完了を Announce（メインに通知）

3. メインセッション
   └─> サブの結果を受け取り、ユーザーに報告

{
  agents: {
    defaults: {
      subagents: {
        maxConcurrent: 8,        // 同時実行可能なサブの数（デフォルト: 8）
        model: "sonnet",         // デフォルトモデル（省略時は親のモデルを継承）
        thinking: "low",         // デフォルトthinkingレベル（省略時は親を継承）
        maxSpawnDepth: 1,        // ネストの深さ（範囲: 1–5、デフォルト: 1）
        maxChildrenPerAgent: 5,  // 1セッションが持てる子の数（範囲: 1–20、デフォルト: 5）
        archiveAfterMinutes: 60  // サブセッションの自動アーカイブ（デフォルト: 60分）
      }
    }
  }
}

{
  agents: {
    defaults: {
      subagents: {
        model: "sonnet",   // デフォルトは Sonnet（コスト効率）
        thinking: "low"    // 軽い判断・要約タスク向け
      }
    }
  }
}

手順書を渡せば完成する？
├── Yes → Sonnet
│   └── 判断・取捨選択がある？
│       ├── No  → thinking: off（機械的に実行するだけ）
│       └── Yes → thinking: low（要約の取捨選択など）
│
└── No → Opus
    └── 複数ステップの推論が要る？
        ├── No  → thinking: low（提案・分析）
        └── Yes → thinking: high（研究・複雑な実装）

Sonnetサブで「OpenClaw サブエージェント」を検索して、
上位5件の要約を /tmp/research.md に保存して

{
  "tool": "sessions_spawn",
  "parameters": {
    "task": "web_searchで「OpenClaw サブエージェント」を検索し、\n上位5件を要約して /tmp/research.md に保存",
    "model": "sonnet",
    "thinking": "low",
    "label": "research-subagents"
  }
}

Opusサブで以下を実装して：
- 新規機能XYZの設計案を作成
- 既存のコードベースとの整合性を検証
- 実装手順書を /tmp/xyz-design.md に出力

以下の3つのタスクを並列で実行して：
1. 株価データの取得（Sonnet）
2. ニュース検索（Sonnet）
3. レポート生成（Opus）

/subagents list

active subagents:
1. research-subagents (claude-sonnet-4-5, 2m) running - web_searchで「OpenClaw サブエージェント」を検索...
2. design-xyz (claude-opus-4-6, 5m) running - 新規機能XYZの設計案を作成...

/subagents kill 1

メインセッション（Opus）
  └─> オーケストレーター（Sonnet、深度1）
       ├─> ワーカー1（Sonnet、深度2）
       ├─> ワーカー2（Sonnet、深度2）
       └─> ワーカー3（Sonnet、深度2）

{
  agents: {
    defaults: {
      subagents: {
        maxSpawnDepth: 2,          // サブがサブを起動可能に
        maxChildrenPerAgent: 5,    // 1セッションが持てる子の数（範囲: 1–20）
        maxConcurrent: 8           // 全体の並列実行数
      }
    }
  }
}

1. 深度2ワーカー完了 → 深度1オーケストレーターに Announce
2. 深度1オーケストレーター完了 → メインセッションに Announce
3. メインセッション → ユーザーに報告

{
  tools: {
    subagents: {
      tools: {
        // deny は常に優先（deny wins）
        deny: ["gateway", "cron"],
        // allow を設定すると許可リスト方式になる（deny は依然として優先）
        // allow: ["read", "exec", "process"]
      }
    }
  }
}

{
  agents: {
    defaults: {
      subagents: {
        archiveAfterMinutes: 60  // デフォルト: 60分
      }
    }
  }
}

{
  "tool": "sessions_spawn",
  "parameters": {
    "task": "...",
    "cleanup": "delete"  // Announce直後にアーカイブ
  }
}

{
  "tool": "sessions_spawn",
  "parameters": {
    "task": "...",
    "runTimeoutSeconds": 300  // 5分でタイムアウト
  }
}