# Team ワークスペース クイックガイド

Team では、1 人の OpenClaw Lite Leader が複数の Worker を調整し、共通の目標に取り組みます。変更できない組み込みテンプレートを使用するか、自然言語の意図から自分専用の Team テンプレートを生成できます。Leader は目標を理解し、作業を割り当て、成果を回収し、異常時の対応を行い、最終結果を公開します。

## 対象範囲

- 協働方式は **Leader 仲介型** に固定されています。ユーザーの依頼は最初に Leader に届き、Leader がメンバーを調整します。
- Leader は常に **OpenClaw Lite** を使用します。各 Worker は **OpenClaw Lite** または **Hermes Lite** を選択できます。
- 有効な Hermes Lite gateway イメージがない場合、Hermes Lite は理由付きで無効になります。
- 組み込みテンプレートは変更・削除できません。カスタムテンプレートは現在のユーザーに属し、調整、削除、再利用が可能です。

## 1. 組み込みテンプレートから Team を作成する

1. ナビゲーションから **Teams** を開き、作成ページに進みます。
2. Team 名を入力し、必要に応じて共有ストレージを調整します。
3. テンプレートを選択し、各 Worker に利用可能な Runtime を選びます。
4. 概要を確認して **作成** を選択します。

右上の **+ カスタム Team** からカスタムテンプレート管理を開けます。同じページのメンバー表で Worker Runtime を選択できます。

![組み込みテンプレート、カスタム Team 入口、Worker Runtime 選択](./main/team-create-fixed-and-custom-entry.png)

変更できない組み込みテンプレートは 8 種類です。Standard Two-Member、Delivery Three-Member、Product Discovery Four-Member、Quality Gate Four-Member、Full-stack Delivery Five-Member、API Integration Five-Member、Research Publication Six-Member、Software Engineering Eight-Member が含まれます。各テンプレートには役割と責任が含まれるため、メンバーごとのリソースプリセット設定は不要です。

## 2. カスタム Team を生成する

**カスタム Team** を開き、Team に達成させたい目標を記述します。人数を空欄にするとシステムが自動決定し、指定する場合は合計 2～6 人を選択できます。

![自然言語と人数からカスタム Team を生成](./main/custom-team-generate.png)

生成と責任調整は、現在のユーザーが利用できる AI Gateway を `model: "auto"` で使用します。実際のモデルは Gateway が選択し、そのモデルに保存された Thinking 設定が適用されます。カスタム Team ページに独立した Thinking スイッチはありません。利用可能なモデルがない場合は、モデル管理でモデルを有効にするよう案内されます。

生成結果には次の規則が適用されます。

- Team は 2～6 人です。
- 先頭かつ唯一の Leader は `memberId=leader` を維持します。
- 能力タグは適した能力を表すだけで、Skill のインストールや Runtime 設定の変更は行いません。

## 3. カスタムテンプレートを管理する

**マイカスタム Team** でテンプレートを選択すると、次の操作ができます。

- テンプレート名の変更。
- 意図または人数を変更した後の Team 全体の更新。
- 保存済みの意図と人数を使った Team 全体の再生成。
- テンプレートの削除、または Team 作成ページでの利用。

![既存のカスタム Team テンプレートを管理](./main/custom-team-manage.png)

更新のたびに新しいバージョンが作成されます。組み込みテンプレートは編集一覧には表示されません。

## 4. メンバーの責任を調整する

メンバーを展開し、希望する変更を自然言語で記述します。入力が空の場合は明確な案内が表示され、送信されません。

![自然言語でメンバーの責任を調整](./main/custom-team-member-adjustment.png)

Leader も調整できますが、変更されるのは業務領域の拡張部分だけです。Leader の役割と識別子、固定のオーケストレーション能力、現在の Worker 一覧、割り当て、回収、検証、最終統合の関係は維持されます。Worker 数を変更した場合も、既存の Team 初期化処理により Leader は完全なメンバー一覧と責任を受け取ります。

## 5. 協働を開始して進捗を確認する

作成後、Team チャットで Leader に目標を記述します。Leader は計画、割り当て、成果と Review 証跡の回収、最終統合を行います。Worker の完了はその Worker の作業項目だけを閉じ、ルートタスクは Leader の統合後に完了します。

Team 詳細ページには次の領域があります。

- **Team チャット**：計画、割り当て、有効な進捗、成果、Review、最終統合を表示します。
- **Execution Kanban**：ヘッダーに現在の Query を表示し、ルートタスクとメンバー作業の状態を表示します。
- **Query ナビゲーション**：Query が 2 件以上ある場合に利用でき、新しい Query が既定で選択されます。
- **Files**：共有成果物を参照します。Markdown、テキスト、JSON はページ内でプレビューでき、その他のファイルはダウンロードできます。

Monitor は活動、完了通知、異常シグナルを観測し、通知や復旧に利用しますが、タスクの成功、失敗、取消、完了を独自に作り出すことはありません。

## 6. Hermes Lite Worker のセッション

Hermes Lite Worker の Team 会話は Hermes ネイティブのセッションストレージを使用します。実行中の完全なメッセージとツール結果は Hermes GUI に段階的に表示され、完了後の履歴を待つ必要はありません。

Team メンバー詳細またはインスタンス一覧から同じ Hermes Lite インスタンスを開くと、同じ Team セッションを表示して継続できます。通常の Hermes セッションの動作は変わりません。セッションは対話と観測に使用され、Kanban と完了判定では Team コントロールプレーンが引き続き正となります。

## 7. 利用上の推奨事項

- まず最も近い組み込みテンプレートを選び、繰り返し使う専門的な分担にはカスタムテンプレートを生成します。
- 目標には範囲、データソース、出力形式、受入基準を明記します。
- Worker が成果を返しただけで同じ依頼を再送せず、Leader の検証と統合を待ちます。
- Thinking は遅延や推論 Token を増やす場合があります。タスクに応じてモデル管理で設定してください。
